au-tax-mcp-server

+----------------------------------------------------------------------+
|                          au-tax-mcp-server                           |
+----------------------------------------------------------------------+
|                 MCP server for AU tax review engines                 |
+----------------------------------+-----------------------------------+
| DR  what it gives you            | CR  what it needs                 |
+----------------------------------+-----------------------------------+
| MCP tools for AU tax review      | an MCP capable host client        |
| delegates to reviewed engines    | uv or uvx to install it           |
| synthetic SBR test fixtures      | -                                 |
+----------------------------------+-----------------------------------+

MCP facade over reviewed Australian computational accounting engines. Compatible with Claude Desktop, Claude Code, Cursor, Codex and Antigravity.

Payday Super is an experimental review (not a compliance determination). Division 7A is refused - there is no repayment calculator. SBR payloads are synthetic fixtures.

[!WARNING] Not tax advice. This server returns structured results, refusals, and citations. It does not lodge, and it does not replace a registered agent. See DISCLAIMER.md.

This is a computational MCP, not a hosted ATO document store. It applies statutory tests to figures the operator supplies (Payday Super timing, ATO small-business benchmark ratios) and refuses Division 7A. For looking up rulings, use a document-retrieval MCP. Comparison: Australian tax tools for AI agents.

This server does not reimplement tax law. Payday Super and ATO small-business benchmarks are delegated to:

• payday-super-checker (payday-super-checker)
• ato-benchmark-compare (ato-benchmark-compare)

Division 7A is refused until a reviewed engine exists. SBR payloads are synthetic fixtures, not lodgments.

Install

Python 3.10+ and uv. This server and its engines are published to PyPI; the server pins its reviewed engines to exact versions:

uvx aus-accounting-mcp

Clone and pip install . still works when you want a local editable tree.

Client integration

Standard config works with hosts that run a local stdio MCP server:

{
  "mcpServers": {
    "aus-accounting": {
      "command": "uvx",
      "args": [
        "aus-accounting-mcp"
      ]
    }
  }
}

Ready-made copies live in clients/.

Cursor

Or drop the standard config into ~/.cursor/mcp.json.

Claude Desktop

Paste the standard config into claude_desktop_config.json (%APPDATA%\Claude\ on Windows, ~/Library/Application Support/Claude/ on macOS).

Claude Code

claude mcp add aus-accounting -- uvx aus-accounting-mcp

Codex

codex mcp add aus-accounting -- uvx aus-accounting-mcp

Tools

calc_payday_super_deadline requires as_at. It does not invent clearing-house latency and cannot confirm LCR 2026/1 transition allocation. A remittance date alone cannot produce ON_TIME. Omitted ATO expense buckets are not_supplied, not zero.

Amounts are decimal strings, finite, at most two decimal places, and no greater than AUD 1,000,000,000,000.00. Dates are ISO-8601. Payday Super uses payday-super-checker's national SGAA 1992 s 6(1) calendar.

Ask the agent:

Compare these P&L buckets to the ATO small-business benchmarks for this industry. Omit buckets I have not supplied. Do not treat missing as zero.

Review this Payday Super contribution. QE day, remitted date, and fund-receipt date are in the CSV. as_at is today. Do not invent an SGC charge.

Licence

MIT License. Created by Ryan Duguid. Boundary statement: DISCLAIMER.md. Discovery copy: docs/DISCOVERY.md. Cite: CITATION.cff.