Aus Accounting MCP (io.github.ryanduguid/aus-accounting)

This Local MCP server supports AU tax review engines, including ATO benchmarks, Payday Super, and a limited Division 7A loan review. It is described as “Not advice.” The server provides MCP tools that use reviewed engines and synthetic SBR fixtures, intended for use with an MCP-capable host client.

🛠️ Key Features

Local MCP for AU tax review engines
ATO benchmarks support
Payday Super support
Limited Division 7A loan review
Uses synthetic SBR fixtures
“Not advice” stated in the README excerpt

🚀 Use Cases

Running AU tax review workflows via MCP tools
Benchmarking ATO-related processing
Reviewing Payday Super scenarios
Performing limited Division 7A loan review tasks

⚡ Developer Benefits

MCP tool integration for an MCP-capable host client
Installation via uv or uvx mentioned in the excerpt
Project topics cover Python, accounting, and Australian taxation workflows

⚠️ Limitations

README excerpt lists “limited Division 7A loan review” (scope is limited)
Server is explicitly “Not advice.”

Australian accounting engines and MCP server

Synthetic examples. Review aid, not professional advice; accounting decisions stay with the reviewer.

Input: $120 super contribution for payday 6 August 2026, remitted 14 August, with no fund receipt evidence as at 20 August.

Try one contribution

With uv installed, download the synthetic CSV as timely_remittance_no_receipt.csv. Open a terminal in that folder and run:

bash

uvx --from payday-super-checker==0.1.4 payday-super-check timely_remittance_no_receipt.csv --as-at 2026-08-20 --confirm-remittance-only -o payday-report.csv

This downloads the pinned PyPI package without cloning the repository. It writes payday-report.csv in the current folder, replacing that file if it exists. Open the report to see the due date and verdict.

The confirmation acknowledges the missing receipt; it does not establish payment. Omit --confirm-remittance-only to see the same AT_RISK result with exit 2, which asks you to resolve or acknowledge that evidence gap.

Output: AT_RISK, due 17 August 2026; exit 0 acknowledges the remittance-only evidence, without proving timely receipt.

Evidence	Result	Human decision
Remitted before the deadline; receipt missing	`AT_RISK`	Obtain fund receipt evidence before concluding it was on time.
Fund receipt recorded on 17 August	`ON_TIME` on supplied facts	Confirm the evidence and any applicable timing exception.

Read the 5-minute Payday Super case · Division 7A repayment case · MCP setup

The recorded public evaluation uses release 0.1.3. Follow its fixed revision and commands to reproduce that historical run; the quick trial above uses release 0.1.4.

Choose the next example

Your task	Start here
BAS pack review	Two synthetic packs with expected findings
Month-end close	Balanced trial balance with unresolved exceptions
GST planning	Browser planning calculators
Division 7A	Repayment assertions and the review boundary
Other engines and agent workflows	Examples and reproduction routes

Installation, component identities, integration and reference

Development home for the Aus Accounting MCP application and 7 independently released Australian accounting engines. Each component keeps its own distribution name, version, lockfile, tests, release notes, commands and licence. There is no root distribution, shared runtime library or combined version.

Use Aus Accounting MCP

For the MCP server, install Python 3.10+ and uv, then configure your MCP client to run:

bash

uvx aus-accounting-mcp

This starts a local stdio server; it waits for an MCP client rather than opening a web page. It requires no API key. Package installation downloads dependencies; the tools then use bundled data without network requests or record writes.

Client setup and examples · Tool reference · PyPI · Glama listing

The tools list ATO benchmark industries, compare supplied expense buckets, review Payday Super timing, look up reviewed Division 7A rates, review an operator-supplied Division 7A loan, refuse unsupported Division 7A matters, and generate synthetic CTR/BAS fixtures. They also assess related Payday contributions, calculate 6 bounded tax worksheets and retrieve cited local Markdown excerpts. Division 7A review is limited to the delegated engine's s 109N/s 109E scope; it does not form amalgamated loans or classify repayments under s 109R. Outputs are review aids, not advice or lodgements.

For an editable source installation, run pip install -e . from apps/aus-accounting-mcp/. The repository root is not an installable Python package.

Components

Path	Distribution	Import package	Commands
`packages/australian-tax-calculators/`	`australian-tax-calculators`	`austaxcalc`	Python worksheet functions
`apps/aus-accounting-mcp/`	`aus-accounting-mcp`	`aus_accounting_mcp`	`aus-accounting-mcp`, `aus-accounting-mcp-demo`
`packages/ato-benchmark-compare/`	`ato-benchmark-compare`	`atobenchmark`	`ato-benchmark-compare`
`packages/payday-super-checker/`	`payday-super-checker`	`paydaysuper`	`payday-super-check`
`packages/div7a-loan-review/`	`div7a-loan-review`	`div7aloan`	`div7a-loan-review`
`packages/the-exchequer-tally/`	`the-exchequer-tally`	`edwinnixon`	`the-exchequer-tally`
`packages/solomons-sword/`	`solomons-sword`	`louisgoldberg`	`solomons-sword`
`packages/the-wip-tally/`	`the-wip-tally`	`wiptally`	`wip-tally`

IMPORTS.md records the source repository, commit and tree of every imported engine. The MCP application is the io.github.ryanduguid/aus-accounting MCP Registry server; it depends on the published ato-benchmark-compare, payday-super-checker, div7a-loan-review and australian-tax-calculators distributions. In the development workspace, uv resolves those 4 dependencies to their checked-out sources.

Working in a component

Change into the component directory and use the commands its own README.md, AGENTS.md or CONTRIBUTING.md documents. The root CONTRIBUTING.md routes the common commands and names the root workflow that runs them.

Boundaries

The MCP application depends on engines only through their published distributions.
Engines never import aus_accounting_mcp or another engine, and no production module uses a relative import that leaves its package; tests/test_boundaries.py proves both.
Only the workflows under the root .github/workflows/ are active; component directories carry none.
No client data, credentials or generated client reports enter this repository.

Releases

Each component is released on its own namespaced tag <component>/vX.Y.Z by its own root workflow .github/workflows/release-<component>.yml, which calls the pinned Release Policy reusable workflow for that component directory only. CONTRIBUTING.md has the table.

Each component's LICENSE applies to that component, and packages/ato-benchmark-compare/NOTICE covers its bundled ATO data. Outputs are review aids, not advice.

aus-accounting-mcp