{ "markdown": "
\n\n# Australian Tax MCP Server\n\n**The Australian tax knowledge base for AI agents.**\n\nConnect your AI agent to 34,500+ ATO documents (guidance, legislation, and\npublic rulings) and get cited answers to the tax questions you'd otherwise pay\nyour accountant to answer.\n\n[ato-mcp.com.au](https://ato-mcp.com.au?utm_source=github&utm_medium=readme) · [Tool reference](https://github.com/william-laverty/ato-mcp/blob/main/docs/tools.md) · [Changelog](https://github.com/william-laverty/ato-mcp/blob/main/CHANGELOG.md)\n\n[![CI](https://github.com/william-laverty/ato-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/william-laverty/ato-mcp/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/ato-mcp)](https://www.npmjs.com/package/ato-mcp)\n[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](https://github.com/william-laverty/ato-mcp/blob/main/LICENSE)\n[![Node 22+](https://img.shields.io/badge/node-%E2%89%A522-brightgreen)](https://nodejs.org)\n\n
\n\n## Quick start\n\nAdd the MCP Server to the client you already use.\n\n**Standard config** works with most tools that run stdio servers:\n\n```json\n{\n \"mcpServers\": {\n \"ato\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"ato-mcp\"]\n }\n }\n}\n```\n\n```bash\nnpm install -g ato-mcp # optional, npx works without installing\n```\n\nFor hosts that natively support remote MCP servers, connect your client directly:\n\n
\nClaude Code\n\n```bash\nclaude mcp add --scope user --transport http ato https://api.ato-mcp.com.au/mcp\n```\n\nThen run `/mcp` inside Claude Code, select **ato**, and choose **Authenticate**.\nYour browser opens to sign in.\n\n
\n\n
\nCodex CLI\n\n```bash\ncodex mcp add ato --url https://api.ato-mcp.com.au/mcp\ncodex mcp login ato\n```\n\n`codex mcp login` opens your browser to sign in.\n\n
\n\n
\nGemini CLI\n\n```bash\ngemini mcp add --scope user --transport http ato https://api.ato-mcp.com.au/mcp\n```\n\nGemini CLI detects the auth challenge on first use and opens your browser\nautomatically.\n\n
\n\n
\nVS Code (Copilot)\n\n[\"Install](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522ato%2522%252C%2522type%2522%253A%2522http%2522%252C%2522url%2522%253A%2522https%253A%252F%252Fapi.ato-mcp.com.au%252Fmcp%2522%257D) [\"Install](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522ato%2522%252C%2522type%2522%253A%2522http%2522%252C%2522url%2522%253A%2522https%253A%252F%252Fapi.ato-mcp.com.au%252Fmcp%2522%257D)\n\nOr from the command line:\n\n```bash\ncode --add-mcp '{\"name\":\"ato\",\"type\":\"http\",\"url\":\"https://api.ato-mcp.com.au/mcp\"}'\n```\n\nVS Code prompts to authenticate in your browser when the server first connects.\n\n
\n\n
\nCursor\n\n[\"Install](https://cursor.com/en/install-mcp?name=ato&config=eyJ1cmwiOiJodHRwczovL2FwaS5hdG8tbWNwLmNvbS5hdS9tY3AifQ%3D%3D)\n\nOr add to `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"ato\": {\n \"url\": \"https://api.ato-mcp.com.au/mcp\"\n }\n }\n}\n```\n\nCursor shows a \"Needs login\" prompt on the server. Click it to sign in via your\nbrowser.\n\n
\n\n
\nWindsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"ato\": {\n \"type\": \"streamable-http\",\n \"serverUrl\": \"https://api.ato-mcp.com.au/mcp\"\n }\n }\n}\n```\n\nIf Windsurf doesn't open a sign-in window, use the standard npm config at the top\nof this section instead; it handles the browser sign-in itself.\n\n
\n\n
\nClaude.ai / Claude Desktop\n\n1. Open **Settings → Connectors**\n2. **Add custom connector**\n3. Paste `https://api.ato-mcp.com.au/mcp`\n4. Click **Connect** and sign in when the browser window appears\n\nAvailable on paid Claude plans. Claude Desktop can alternatively use the standard\nnpm config at the top of this section in `claude_desktop_config.json`.\n\n
\n\n
\nChatGPT\n\n1. **Settings → Apps & Connectors** → enable **Developer Mode**\n2. **New connector** → paste `https://api.ato-mcp.com.au/mcp`\n3. Choose **OAuth** and sign in when prompted\n\nRequires a plan with connector support.\n\n
\n\n
\nOther (OpenCode, Zed, etc)\n\nUse the standard npm config at the top of this section. This package bridges any\nstdio host to the hosted server with the same browser sign-in.\n\n
\n\nFull instructions: **[ato-mcp.com.au/install](https://ato-mcp.com.au/install?utm_source=github&utm_medium=readme)**\n\n## What's in the corpus\n\nEverything the ATO publishes, in one searchable place, refreshed monthly:\n\n| Source | Contents |\n|---|---|\n| **ato.gov.au** | 23,000+ guidance pages, forms & instructions, occupation guides, myTax help |\n| **Legislation** | ITAA 1997, ITAA 1936 and the GST Act: 6,468 sections + 2,310 statutory definitions (point-in-time aware) |\n| **ATO public rulings** | 4,900+ rulings across 10 types (TR, TD, GSTR, GSTD, PR, CR, LCR, PCG, MT, FTR), withdrawn rulings flagged |\n| **Cross-references** | 64,217 links between rulings and legislation |\n| **Thresholds** | Time-keyed values (instant asset write-off, GST registration, CGT discount, super caps, …) |\n\n**34,500+ documents (286,000+ searchable passages)**, refreshed monthly and\nserved from the hosted platform.\n\n## The 13 tools\n\n**Workflows** are the reason this exists:\n\n> _\"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?\"_\n\n| Tool | What it does |\n|---|---|\n| `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 |\n| `depreciation_helper` | Deterministic prime-cost / diminishing-value / instant-write-off / small-business-pool / Div 43 schedules for any asset, with the live IAWO threshold |\n| `bas_prep_checklist` | A tiered, cited BAS checklist for your reporting period: which labels apply, what evidence to gather, the gotchas |\n| `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 |\n\nEvery workflow tool returns **structured data and resolvable ATO citations,\nnever advice in its own voice**.\n\n**Personal context:** `get_user_facts`, 25 facts captured once at onboarding\n(business structure, GST registration, investments, super type, residency, …)\nso the agent never re-asks.\n\n**Retrieval:** `search` (keyword and semantic retrieval), `get_chunks`,\n`get_doc`, `get_doc_anchors` (cross-references), `get_definition` (statutory,\npoint-in-time), `get_threshold` (time-keyed values), `fetch` (live page fetch),\n`stats`.\n\nSee the [full tool reference](https://github.com/william-laverty/ato-mcp/blob/main/docs/tools.md).\n\n## Disclaimer\n\nThis service is provided as **information infrastructure, not tax advice**. It\ndoes not consider your full financial circumstances and it is not a registered\ntax agent service. Confidence ratings and risk bands are guides, not\nprofessional judgement. Verify material decisions with a registered tax agent.\n\nato-mcp is an independent service. It is not affiliated with or endorsed by\nthe Australian Taxation Office. ATO content remains subject to ATO publication\nterms. Legislation text is reproduced from the Federal Register of Legislation\nunder its open licensing.\n\nSee the [Terms of Service](https://ato-mcp.com.au/terms) &\n[Privacy Policy](https://ato-mcp.com.au/privacy) for more details.\n\n---\n\n**License [AGPL-3.0](https://github.com/william-laverty/ato-mcp/blob/main/LICENSE) © William Laverty**\n\n*The hosted platform and corpus are proprietary. Commercial licensing available on request.*\n", "bytes": 8349, "sha": "4a43a2dd95ea7bf7b44f26ca63312c247ba5e237150809f3a35c2f969fbb2223", "repo_slug": "william-laverty/ato-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_au_com_ato_mcp_ato_mcp_88fb1db7/readme" }