Installation

In SourceWeft

Open Australian Tax MCP in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

Australian Tax MCP Server

The Australian tax knowledge base for AI agents.

Connect your AI agent to 34,500+ ATO documents (guidance, legislation, and public rulings) and get cited answers to the tax questions you'd otherwise pay your accountant to answer.

ato-mcp.com.au · Tool reference · Changelog

[CI] [npm] [License: AGPL-3.0] [Node 22+]

Quick start

Add the MCP Server to the client you already use.

Standard config works with most tools that run stdio servers:

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

Claude Code

Then run /mcp inside Claude Code, select ato, and choose Authenticate. Your browser opens to sign in.

Codex CLI

codex mcp login opens your browser to sign in.

Gemini CLI

Gemini CLI detects the auth challenge on first use and opens your browser automatically.

VS Code (Copilot)

[Install in VS Code] [Install in VS Code Insiders]

Or from the command line:

VS Code prompts to authenticate in your browser when the server first connects.

Cursor

[Install in Cursor]

Or add to ~/.cursor/mcp.json:

Cursor shows a "Needs login" prompt on the server. Click it to sign in via your browser.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json

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

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

If Windsurf doesn't open a sign-in window, use the standard npm config at the top of this section instead; it handles the browser sign-in itself.

Claude.ai / Claude Desktop

Open Settings → Connectors
Add custom connector
Paste https://api.ato-mcp.com.au/mcp
Click Connect and sign in when the browser window appears

Available on paid Claude plans. Claude Desktop can alternatively use the standard npm config at the top of this section in claude_desktop_config.json.

ChatGPT

Settings → Apps & Connectors → enable Developer Mode
New connector → paste https://api.ato-mcp.com.au/mcp
Choose OAuth and sign in when prompted

Requires a plan with connector support.

Other (OpenCode, Zed, etc)

Use the standard npm config at the top of this section. This package bridges any stdio host to the hosted server with the same browser sign-in.

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

What's in the corpus

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

Source	Contents
ato.gov.au	23,000+ guidance pages, forms & instructions, occupation guides, myTax help
Legislation	ITAA 1997, ITAA 1936 and the GST Act: 6,468 sections + 2,310 statutory definitions (point-in-time aware)
ATO public rulings	4,900+ rulings across 10 types (TR, TD, GSTR, GSTD, PR, CR, LCR, PCG, MT, FTR), withdrawn rulings flagged
Cross-references	64,217 links between rulings and legislation
Thresholds	Time-keyed values (instant asset write-off, GST registration, CGT discount, super caps, …)

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?"

Tool	What it does
`deduction_discovery`	Surfaces every deduction category that plausibly applies to your profile: a curated, cited taxonomy branched across sole traders, companies, trusts, partnerships, investors and SMSF members
`depreciation_helper`	Deterministic prime-cost / diminishing-value / instant-write-off / small-business-pool / Div 43 schedules for any asset, with the live IAWO threshold
`bas_prep_checklist`	A tiered, cited BAS checklist for your reporting period: which labels apply, what evidence to gather, the gotchas
`audit_risk_check`	Flags the patterns the ATO scrutinises in a draft return (WRE vs income, rental anomalies, unreported crypto, …) with risk bands and the guidance behind each flag

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.

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

Source: README.md at commit 9e57ed6

Tools

0

Tool metadata has not been indexed yet.

Version history

1

v2.2.1LatestSep 16, 2026

Australian Tax MCP