Public API and agent resources
Use these read-only resources to help AI agents understand CukaiMax, discover public tax reference data, and route users to the right product surface.
Product overview
Explain what CukaiMax does for Malaysian taxpayers and when it is a good fit.
/api/v1/capabilitiesVersioned tax authority
Search source-linked Form BE and Form B rules, assess Form B readiness, inspect YA2026 planning changes, compile review-gated YA2025 BE drafts, preserve audit events, and evaluate agents through MCP.
/.well-known/mcpSite question answering
Answer common natural-language questions about CukaiMax and the public tax resources on the site.
/ask
Open endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/capabilities | Public capability list for CukaiMax agent integrations. |
| GET | /api/v1/tax-reliefs | Public Malaysia tax relief reference data. |
| POST | /ask | NLWeb-style natural-language question endpoint. |
| POST | /.well-known/mcp | Rate-limited Streamable HTTP MCP for YA2025 Form BE, Form B readiness, YA2026 planning, audit events, and agent evaluation resources. |
Tax Authority MCP
Connect an agent to source-linked YA2025 Form BE and Form B rules, deterministic BE drafts, Form B readiness, and non-filing YA2026 planning changes.
https://www.cukaimax.com/.well-known/mcp| Tool | What it does |
|---|---|
list_tax_authority_releases | Discover supported years, forms, versions, and capabilities. |
get_tax_authority_release | Inspect a release, sources, validation, and review state. |
search_tax_authority | Find cited Form BE or Form B rules by topic or field. |
prepare_be_2025_draft | Compile supplied inputs into review-gated Form BE fields. |
assess_form_b_2025_readiness | Check Form B accounts, worksheets, schedules, and evidence readiness. |
Drafts are never submitted to MyTax. Agents must preserve blockers, warnings, citations, source hashes, and authority status.
Your account: CukaiMax MCP
A separate server for CukaiMax users. Connect ChatGPT, Claude or Grok to your own tax position, reliefs, receipts and next actions. It needs a CukaiMax account and your OAuth consent, and it is read-only.
https://app.cukaimax.com/api/mcp- ChatGPT
Developer Mode, add a custom connector with the URL and OAuth. ChatGPT sends you to CukaiMax to sign in and approve.
- Claude
Add a custom connector with the URL. Claude sends you to CukaiMax to sign in and approve.
- Grok
Add a custom connector with the URL. Grok sends you to CukaiMax to sign in and approve.
| Tool | What it reads |
|---|---|
get_tax_position | Tax, refund or balance for the year, and relief room left. |
list_reliefs | Reliefs with room, awaiting an answer, or missing proof. |
get_relief_detail | Why one relief is the amount it is, with its receipts. |
list_transactions | Receipts by category, merchant, date, status or claim state. |
get_next_actions | What to do before filing. |
Assistants cannot change anything: no adding, editing or deleting receipts, no uploads, nothing sent to MyTax. Disconnect any assistant from Settings, Connected apps. 120 calls a minute and 2,000 a day per user.
Discovery documents
- Homepage
/Product overview, features, pricing, and app download links. - Developers
/developersAgent and API integration docs for public CukaiMax resources. - Tax Authority for AI Agents
/tax-authoritySource-linked YA2025 Form BE and Form B rules, Form B readiness, YA2026 planning changes, and MCP access. - Installable Agent Skill
/agent-skillInstall the CukaiMax SKILL.md in Codex, Claude Code, or compatible agents. - Live MCP Playground
/tax-authority/playgroundRun the public MCP tools with editable JSON and inspect structured output. - Tax-agent Evaluation
/agent-evaluation.md36 fictional golden scenarios, deterministic scoring, and the privacy-safe audit contract. - Live Agent Benchmark
/agent-benchmarkReproducible agent-profile scorecard, validation state, methodology, and SDK examples. - Agent skill manifest
/.well-known/agent-skills.jsonMachine-readable skill URL, checksum, documentation, and MCP connection. - Agent integration guide
/integrations.mdCopy-paste setup for Codex, Claude Code, and generic MCP clients. - OpenAPI
/openapi.jsonMachine-readable public API specification. - Agent instructions
/agents.mdMarkdown instructions for when agents should use CukaiMax. - Authentication guide
/auth.mdAgent-facing credential and public access guide. - Pricing
/pricing.mdMachine-readable CukaiMax public pricing summary. - Sitemap
/sitemap.xmlXML sitemap index for public content discovery.
Next steps for agents
- Agent handoffGive one install URL to your agentSafe project-scoped setup for Codex, Claude Code, Cursor, VS Code, Gemini CLI, and compatible MCP clients.Open
- SKILL.mdInstall the tax-authority workflowGive Codex, Claude Code, and compatible agents the scope checks, citations, and review boundaries needed to use this MCP safely.Open
- Live MCPRun a tool before you integrateEdit JSON arguments and inspect real structured responses for Form BE, Form B readiness, and YA2026 planning.Open