Australian Tax MCP — Claude Code MCP server: how to install
An MCP server that answers Australian tax questions with citations to ATO guidance, legislation and rulings. Use it for deductions and BAS prep.
AGPL-3.0 ★ 19 updated 2026-10-22
claude mcp add --transport http ato-mcp https://api.ato-mcp.com.au/mcpWhat Australian Tax MCP does
The server gives your agent a searchable base of 34,500+ ATO documents: website guidance and Australian legislation (ITAA 1997, ITAA 1936, GST Act), plus 4,900+ public rulings with withdrawn ones flagged. Every answer links back to its source. The base is refreshed monthly.
Thirteen tools are exposed. Four are workflows. deduction_discovery lists deduction categories that fit your profile, depreciation_helper produces depreciation schedules using the current instant asset write-off threshold, bas_prep_checklist prepares a BAS checklist for the period, and audit_risk_check marks the parts of a draft return the ATO tends to look at. They return structured data and citations rather than advice. get_user_facts stores 25 facts about you, entered once during onboarding.
The hosted server needs a browser sign-in on first use, and the npx route requires Node 22+. The license is AGPL-3.0.
What it helps with
- find which deductions apply to a sole trader or an investor
- compare depreciation methods for a new laptop
- list the evidence needed for a BAS period
- check a draft tax return for patterns the ATO reviews
- locate the right section of an act or a public ruling, with a link
Example prompts for the agent
- What can I claim as a sole trader this year? Run
deduction_discoveryand cite the ATO pages. - Use
depreciation_helperto work out how I write off my new laptop. - Run my draft return through
audit_risk_checkand show what looks risky.
How to install Australian Tax MCP
1Platform CLI: remote server
claude mcp add --transport http ato-mcp https://api.ato-mcp.com.au/mcp2Platform CLI
claude mcp add australian-tax-mcp -- npx -y ato-mcp1Platform CLI: remote server
codex mcp add australian-tax-mcp --url https://api.ato-mcp.com.au/mcp2Platform CLI
codex mcp add australian-tax-mcp -- npx -y ato-mcpConfig file
{
"mcpServers": {
"australian-tax-mcp": {
"url": "https://api.ato-mcp.com.au/mcp"
}
}
}{
"mcpServers": {
"australian-tax-mcp": {
"command": "npx",
"args": [
"-y",
"ato-mcp"
]
}
}
}Config file
{
"servers": {
"australian-tax-mcp": {
"type": "http",
"url": "https://api.ato-mcp.com.au/mcp"
}
}
}{
"servers": {
"australian-tax-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ato-mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http australian-tax-mcp https://api.ato-mcp.com.au/mcp2Platform CLI
gemini mcp add australian-tax-mcp npx -y ato-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Australian Tax MCP
How do I install Australian Tax MCP in Claude Code?
Run claude mcp add --transport http ato-mcp https://api.ato-mcp.com.au/mcp. Sign in through your browser when the server connects.
What does Australian Tax MCP do?
It lets your agent search ATO documents, legislation and public rulings and answer with links to the sources. Four workflow tools cover deductions, depreciation, BAS and draft-return checks.
What documents does the server search?
About 34,500+ documents: ato.gov.au pages, ITAA 1997, ITAA 1936, the GST Act and 4,900+ public rulings, with withdrawn rulings flagged. It also holds links between rulings and legislation, and the base is refreshed monthly.