Australian Tax MCP server

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

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 Code

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

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

Codex CLI

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

codex mcp login opens your browser to sign in.

Gemini CLI

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

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

VS Code (Copilot)

Or from the command line:

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

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

Cursor

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

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

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:

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

Shortened. The full README is on GitHub.