Australian Tax MCP

Quick start

Add the MCP Server to the client you already use.

Standard config works with most tools that run stdio servers:

{
  "mcpServers": {
    "ato": {
      "command": "npx",
      "args": ["-y", "ato-mcp"]
    }
  }
}

npm install -g ato-mcp   # optional, npx works without installing

For hosts that natively support remote MCP servers, connect your client directly:

claude mcp add --scope user --transport http ato https://api.ato-mcp.com.au/mcp

codex mcp add ato --url https://api.ato-mcp.com.au/mcp
codex mcp login ato

gemini mcp add --scope user --transport http ato https://api.ato-mcp.com.au/mcp

code --add-mcp '{"name":"ato","type":"http","url":"https://api.ato-mcp.com.au/mcp"}'

{
  "mcpServers": {
    "ato": {
      "url": "https://api.ato-mcp.com.au/mcp"
    }
  }
}

{
  "mcpServers": {
    "ato": {
      "type": "streamable-http",
      "serverUrl": "https://api.ato-mcp.com.au/mcp"
    }
  }
}

Full instructions: ato-mcp.com.au/install

What's in the corpus

Everything the ATO publishes, in one searchable place, refreshed monthly:

34,500+ documents (286,000+ searchable passages), refreshed monthly and served from the hosted platform.

The 13 tools

Workflows are the reason this exists:

"Here's my bank transactions, what can I claim this year? How do I write off my new laptop? Is anything in my return risky?"

Every workflow tool returns structured data and resolvable ATO citations, never advice in its own voice.

Personal context: get_user_facts, 25 facts captured once at onboarding (business structure, GST registration, investments, super type, residency, …) so the agent never re-asks.

Retrieval: search (keyword and semantic retrieval), get_chunks, get_doc, get_doc_anchors (cross-references), get_definition (statutory, point-in-time), get_threshold (time-keyed values), fetch (live page fetch), stats.

See the full tool reference.

Disclaimer

This service is provided as information infrastructure, not tax advice. It does not consider your full financial circumstances and it is not a registered tax agent service. Confidence ratings and risk bands are guides, not professional judgement. Verify material decisions with a registered tax agent.

ato-mcp is an independent service. It is not affiliated with or endorsed by the Australian Taxation Office. ATO content remains subject to ATO publication terms. Legislation text is reproduced from the Federal Register of Legislation under its open licensing.

See the Terms of Service & Privacy Policy for more details.

License AGPL-3.0 © William Laverty

The hosted platform and corpus are proprietary. Commercial licensing available on request.