# Australian Tax MCP

An MCP server that answers Australian tax questions with citations to ATO guidance, legislation and rulings. Use it for deductions and BAS prep.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19 repo stars
- Author: william-laverty
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/william-laverty/ato-mcp
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/australian-tax-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.ato-mcp.com.au/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http ato-mcp https://api.ato-mcp.com.au/mcp
```

2. **Platform CLI**
```bash
claude mcp add australian-tax-mcp -- npx -y ato-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add australian-tax-mcp --url https://api.ato-mcp.com.au/mcp
```

2. **Platform CLI**
```bash
codex mcp add australian-tax-mcp -- npx -y ato-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "australian-tax-mcp": {
            "url": "https://api.ato-mcp.com.au/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "australian-tax-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ato-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "australian-tax-mcp": {
            "type": "http",
            "url": "https://api.ato-mcp.com.au/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "australian-tax-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ato-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http australian-tax-mcp https://api.ato-mcp.com.au/mcp
```

2. **Platform CLI**
```bash
gemini mcp add australian-tax-mcp npx -y ato-mcp
```

## When to use it
- 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
- What can I claim as a sole trader this year? Run `deduction_discovery` and cite the ATO pages.
- Use `depreciation_helper` to work out how I write off my new laptop.
- Run my draft return through `audit_risk_check` and show what looks risky.

## Similar
- [ClinicOS — Australian Healthcare](https://affpapa.org/en/nevibecode/mcp/clinicos-australian-healthcare.md) — MCP server · 600 installs
- [australian-law-mcp](https://affpapa.org/en/nevibecode/mcp/australian-law-mcp.md) — MCP server · ★ 7 repo stars
- [Aiwyn Tax](https://affpapa.org/en/nevibecode/mcp/aiwyn-tax.md) — MCP server · 6395 installs
- [tax-efficiency](https://affpapa.org/en/nevibecode/skills/tax-efficiency.md) — skill · 756 installs
- [tax-liability-tracking](https://affpapa.org/en/nevibecode/skills/tax-liability-tracking.md) — skill · 473 installs
- [tax-penalty-calc](https://affpapa.org/en/nevibecode/skills/tax-penalty-calc.md) — skill · 433 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
