Skip to main content

au-tax-mcp-server

tests Python Model Context Protocol Glama License: MIT

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 server does not reimplement tax law. Payday Super and ATO small-business benchmarks are delegated to:

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

Install

Python 3.10+ and uv. The engines come from PyPI at exact versions; this server itself installs from the repository until its own first PyPI release:

uvx --from git+https://github.com/ryanduguid/au-tax-mcp-server 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": [
        "--from",
        "git+https://github.com/ryanduguid/au-tax-mcp-server",
        "aus-accounting-mcp"
      ]
    }
  }
}

Ready-made copies live in clients/.

Cursor

Add to 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 --from git+https://github.com/ryanduguid/au-tax-mcp-server aus-accounting-mcp

Codex

codex mcp add aus-accounting -- uvx --from git+https://github.com/ryanduguid/au-tax-mcp-server aus-accounting-mcp

Tools

Tool Job Engine
list_ato_benchmark_industries List or search the shipped ATO business types ato-benchmark-compare
get_ato_benchmarks Compare operator-supplied bucket totals to ATO ranges ato-benchmark-compare
calc_payday_super_deadline Review one contribution against Payday Super timing payday-super-checker
refuse_div7a Returns a refusal. No reviewed Div 7A engine is wired none
generate_synthetic_sbr_fixture Synthetic CTR/BAS for agent tests (synthetic: true) local fixture

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aus_accounting_mcp-0.1.4.tar.gz (182.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aus_accounting_mcp-0.1.4-py3-none-any.whl (14.0 kB view details)

Uploaded Python 3

File details

Details for the file aus_accounting_mcp-0.1.4.tar.gz.

File metadata

  • Download URL: aus_accounting_mcp-0.1.4.tar.gz
  • Upload date:
  • Size: 182.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aus_accounting_mcp-0.1.4.tar.gz
Algorithm Hash digest
SHA256 06734fdf9cfc237c42065d4d21e08f30f327b8f9aafac660bab6b255389ffe5a
MD5 da680455944ba86389a433cf9d771869
BLAKE2b-256 028db0f4397a5d8b305068e4309b291e1df73da1a38861914af698657286fafe

See more details on using hashes here.

Provenance

The following attestation bundles were made for aus_accounting_mcp-0.1.4.tar.gz:

Publisher: publish-pypi.yml on ryanduguid/au-tax-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aus_accounting_mcp-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for aus_accounting_mcp-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 10f9c9673bd08ed9c5806cc9e796bd9d709b0f04fca83f8fd171250eadb27f84
MD5 ff1524030da16f345cebcb5c17c29d26
BLAKE2b-256 231b9113d9f346b93c721de1c39b9b96bf5c5084356f72ebe1dd145bd4cefbae

See more details on using hashes here.

Provenance

The following attestation bundles were made for aus_accounting_mcp-0.1.4-py3-none-any.whl:

Publisher: publish-pypi.yml on ryanduguid/au-tax-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.5

2 files

This release

0.1.4 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page