Reviews, 14 bounded tax and super worksheets, cited retrieval from your local Markdown. Not advice.
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
claude mcp add --scope user aus-accounting -- uvx --from 'aus-accounting-mcp==0.9.0' aus-accounting-mcp
That connects Claude Code; it needs Python 3.14+ and uv, and no API key. For Claude Desktop, download the .mcpb file from the bundle releases and open it with Claude Desktop. The server runs on your machine, so ChatGPT connectors and the Claude.ai web app, which accept only remote servers, cannot run it. Other clients.
Australian Accounting is a set of local tax and payroll calculation engines and an
MCP server for Australian accountants and bookkeepers, and the developers who build
tooling for them.
Nine engines (8 in Rust, 1 in Python) apply Australian tax and payroll rules to figures
you supply. Aus Accounting MCP, a local Model Context Protocol server, gives an AI
assistant the published Python releases of 6 of them; it loads none of the Rust crates
yet.
Each tool returns a calculation, the facts it used and the matters it refuses to
decide. The engines and the MCP server run locally: they read files you point them at, contact no
service, write to no ledger and lodge nothing. Two boundaries sit outside that: an MCP host sends every tool argument and result to its model provider, and the optional LodgeiT adapter below makes bounded HTTP calls only when you enable it.
Missing facts stay unknown: a Payday Super row with a fund-receipt date but no matched_amount or remitted_amount evidences when the fund received something, not how much, so the checker leaves it UNKNOWN rather than ON_TIME and names the amount it needs (from payday-super-checker 0.1.7; 0.1.6 and earlier read that receipt as covering the whole SG amount and say so in a caveat). Supply the amount the fund received with every receipt date.
Results you can check, dated because sources and releases move:
Division 7A. On 7 October 2026 the minimum yearly repayment function of the ATO's
Division 7A calculator and decision tool
and the div7a-loan-review Python 0.2.0 source agreed to the cent on 12,800 fabricated cases with no
repayments, for 2019-20 to 2026-27. Its repayment code and rate table are unchanged to the
published 0.3.2, but the comparison was not rerun on later releases or the unreleased Rust port.
It covers the repayment figure only, not the calculator's interest or closing balance
(record and limits).
Payday Super. For wages paid on 30 July 2026, payday-super-check 0.2.3 gives a due date of
11 August 2026, because NT Picnic Day on 3 August is not a business day. The
ATO's worked example
gives the same date on the usual 7 business day path. Run and read 5 November 2026.
MCP tools. Aus Accounting MCP 0.9.0 listed 25 local tools on
15 November 2026, including validate_abn, validate_acn and get_reviewed_rate, as
0.8.0 did; 0.7.1 listed 22. 0.8.0 added the doctor command.
Commands for the Payday Super date and the tool count
The first command downloads a fabricated register, and row 4 of the second prints
QE day 2026-07-30 due 2026-08-11. Its rows are late, so that command exits 2.
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 for the full $120 contribution
ON_TIME on supplied facts
Confirm the evidence and any applicable timing exception.
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.2.3, which, like every release from 0.1.7, requires an evidenced amount alongside a fund-receipt date.
Choose the next example
The next Australian Accounting example depends on the task:
For transaction GST coding, load the linked bas-preparation skill and its
bundled transaction reference. They require row coverage and separate evidence
for supply treatment, buyer credits and BAS attribution. Aus Accounting MCP does
not provide a transaction GST classifier; its calculations or a control-account
tie-out cannot establish correct tax coding. Missing facts remain unresolved for
the authorised reviewer. The walkthrough explains instruction-file delivery to
Codex, ChatGPT and Copilot without claiming equivalent tested behaviour.
Use Aus Accounting MCP
For the MCP server, install Python 3.14+ and uv, then
configure your MCP client to run:
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. The
MCP host you connect it to is a separate boundary: it sends every tool argument
and result to its model provider, so use fabricated data with a hosted model.
The pin selects the published 0.9.0 release, so a new release does not reach you on
its own. To move to a later release, replace the version in your client configuration
with one from PyPI;
uvx downloads it, and later launches reuse the cached copy without a download until
the uv cache is cleaned.
Once it is connected, ask your assistant in plain English. Each of these fabricated
requests resolves to one tool call:
Ask
Tool
'Compare a hairdresser with $180,000 sales, no other income, $60,000 wages, $30,000 rent and $40,000 other expenses to the ATO benchmarks.'
get_ato_benchmarks
'Super for a 6 August 2026 payday was $120 and was sent on 14 August. As at 20 August, is it on time?'
calc_payday_super_deadline
'What is the Division 7A benchmark interest rate for 2026-27?'
get_div7a_benchmark_rate
'An employee who gave a TFN and claims the tax-free threshold (scale 2) is paid a regular $1,000 weekly wage in 2026-27, with no offsets, loans, bonuses or other adjustments. How much PAYG should be withheld?'
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,
build a Payday Super evidence pack, calculate 14 bounded tax and super worksheets,
review GST coding, reconcile BAS figures with the ledger, list lodgment due dates,
test ABN and ACN check digits, report data freshness and retrieve cited excerpts
from a local Markdown library, legislation corpus or ATO rulings corpus.
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.
For an editable source installation, run pip install -e . from
apps/aus-accounting-mcp/. The repository root is not an installable Python package.
How the accounting tools fit together
The accounting skills guide
preparation and can call this server. Workpapers and unresolved exceptions go to an
authorised human for review.
flowchart TB
accTitle: How the accounting tools fit together
accDescr: An assistant using the accounting skills exchanges requests with the Australian Accounting MCP server, which sends calculations to the calculation packages. The assistant sends workpapers and exceptions to authorised human review. The Federal Register of Legislation feeds the legislation corpus, a finding aid. The reviewer uses the corpus to locate provisions and checks authority at the Register.
%%{init: {"theme": "base", "look": "classic", "themeVariables": {"background": "#000000", "primaryColor": "#66023C", "primaryTextColor": "#FFFFF0", "primaryBorderColor": "#FFFFF0", "lineColor": "#FFD32A", "textColor": "#FFFFF0", "edgeLabelBackground": "#000000", "clusterBkg": "#000000", "clusterBorder": "#9B7735", "titleColor": "#E5E4E2"}}}%%
assistant["Assistant using<br/>accounting skills"] <--> mcp["Australian Accounting<br/>MCP server"]
mcp -->|Calculations| engines["Calculation packages"]
assistant -->|Workpapers and exceptions| reviewer["Authorised human review"]
official["Federal Register<br/>of Legislation"] -->|Corpus build| corpus["Legislation corpus<br/>Finding aid"]
corpus -. Locate provisions .-> reviewer
official -. Check authority .-> reviewer
style engines fill:#990024,stroke:#FFFFF0,stroke-width:2px,color:#FFFFF0
style reviewer fill:#E7162F,stroke:#FFFFF0,stroke-width:2px,color:#FFFFF0
classDef external fill:#745EB1,stroke:#FFFFF0,stroke-width:2px,color:#FFFFF0
class official external
The corpus is not an automatic source feed into the calculation engines; the research
tools above only search a copy you configure. Dashed arrows show reference use, which
still requires checking the applicable authority.
Components
Australian Accounting holds 13 components, each in its own directory:
gst-review: GST coding states against registration and BAS-to-ledger reconciliation
packages/lodgment-calendar/
lodgment-calendar
lodgmentcalendar
Python function: ATO lodgment program due dates for BAS, IAS, income tax and FBT returns, UNKNOWN where a fact is missing
apps/lodgeit-calculator-adapter/
lodgeit-calculator-adapter (Rust, not released)
none
lodgeit-adapter: optional adapter for a third-party calculator service; off by default, makes HTTP calls only when enabled (LODGEIT_ADAPTER_ENABLED=1 or --enable-network)
packages/au-tax-rates-data/
au-tax-rates-data (Rust, never released on its own)
none
rates validate, snapshot, check and ato-tables: ATO rates and thresholds with verbatim source quotes, validated offline
IMPORTS.md records the source repository, commit and tree of every imported component. 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, australian-tax-calculators, gst-review and lodgment-calendar
distributions. In the development workspace, uv takes gst-review 0.1.0,
australian-tax-calculators 0.2.0, div7a-loan-review 0.3.2,
ato-benchmark-compare 0.2.2 and payday-super-checker 0.2.3, the last Python
releases, from PyPI.
The uv workspace develops lodgment-calendar and the MCP application; the
MCP server uses none of the Rust crates yet.
Alternatives
Australian Accounting calculates from figures you supply, and its research tools use folders
you configure. As read on 13 November 2026, these projects cover nearby ground:
william-laverty/ato-mcp: a hosted MCP connector,
for Claude.ai, ChatGPT and other clients after sign-in, over more than 34,500 ATO documents
(guidance, legislation and public rulings), with point-in-time legislation queries. Its latest release
is v2.3.0 of 22 October 2026. Its pricing gives 25 lookups a
month free and unlimited lookups for $300 a year, and its
privacy page, last updated 11 November 2026, names Voyage AI in
the United States as turning search queries into vectors and ranking the matching passages. The
repository is AGPL-3.0, and its README calls the hosted platform and corpus proprietary.
Nagaris: a hosted practice platform for Australian accounting
firms, with proposals, AML/CTF checks, e-signing, job tracking and an AI assistant on one client
file. It publishes browser calculators, including Division 7A,
which with repayments entered also shows interest at the benchmark rate and the closing balance
(this repository's Division 7A review computes neither), and
Payday Super due dates, whose page also
states 11 August 2026 for a 30 July 2026 payday. Its
AI Accounting Index, which tested third-party AI models
with each question answered once, reports that none of the 14 setups that answered that question
got the date right, and says Ask Nagaris adds lookup tables for business days.
Lodgeit: a hosted platform that
prepares and lodges returns, BAS and financial reports.
Its home page calls it an 'Official ATO Standard Business Reporting platform' and states
ISO 27001:2022 certification.
LodgeiT Labs: a public HTTP gateway for deterministic
calculators with no key or signup, which its page describes as 'Not stable yet'. The gateway also
speaks MCP, and its page says to add it to Claude as a custom connector with no sign-in. Its
listing showed 23 calculators,
with Division 7A periods fy2025 and fy2026 and FBT period fy2026. Its page also lists a
Coal LSL calculator that external contributor Ryan Duguid built and hosts, and this repository has
an optional adapter for the gateway. A
differential of 6 November 2026
ran 12 fabricated Division 7A and FBT car formula cases against the gateway and records each
outcome, with differences traced to statute. Its hp:schedule calculator, as its OpenAPI document
read on 15 November 2026 describes it, amortises a hire purchase agreement at a stated nominal
rate, reports any residual and totals interest by financial year; hire-purchase-schedule instead
works out the implicit rate from the payments, as ITAA 1997 s 240-60 does, and closes at nil, but
leaves the caller to split a month that spans 30 June. On 16 November 2026 the listing held 19 FBT
calculators, each for fy2026 only. This repository's engine values car, loan, meal entertainment
(50/50 split and 12 week register), car parking (commercial parking station, market value, average
cost, spaces and 12 week register), debt waiver, expense payment (external, in-house property and
in-house residual), property, residual, housing, living-away-from-home allowance, board and
tax-exempt body entertainment benefits for the FBT years ending 31 March 2026 and 2027, so each of
the listing's 19 FBT calculators has a counterpart here. Its spaces calculator takes one space at
a time and leaves the s 39FB reduction to the caller; fbt-car-parking takes every space an
election covers and applies s 39FB.
AusCalc: free browser calculators for individual and sole trader tax,
PAYG, GST, super and HECS, which its home page also offers inside ChatGPT and Claude as a plugin.
PayCalculator: a remote MCP server in the MCP Registry for
Australian pay, income tax, super, HECS, family payments and child care subsidy.
aftertaxau/au-compliance-kit, read on
14 November 2026: an MIT-licensed JavaScript library with no dependencies, v0.4.0 of
13 November 2026, with a local MCP server and a hosted one at https://aftertaxau.com/mcp that
needs no key. Both it and this repository cover Schedule 1 withholding with scale 4, quarterly
pays, tax offsets and the Medicare levy adjustment, and both test all 432 rows of each year's ATO
sample data. This repository takes quarterly pays under Schedules 1 and 8 only: its
Schedule 5, 9 and 15 commands refuse them. The library also takes quarterly pays under
Schedule 9, and covers overtime, which this repository does not. Both add the Schedule 8
study loan component to Schedule 9 pays, as rechecked in v0.4.0's source on 15 November 2026;
for 2025-26 the library applies the rates from 24 September 2025 when no pay date is given,
where this repository requires the date.
Both compose a year's tax and levies, work taxable income out from salary and deductions with
the $1,000 standard deduction for work-related expenses from 2026-27, and compare the result
with tax withheld, as rechecked in the library's source on 16 November 2026. Both work that
tax withheld out from one employer's regular pays, with Schedule 5 Method A for a bonus, as
rechecked at the library's commit e94cef24 on 16 November 2026: the library from an annual salary
spread over 52 weekly, 26 fortnightly or 12 monthly pays, and this repository from one pay's
earnings and the number of pays in the year, so it also takes 53 weekly or 27 fortnightly pays,
quarterly pays under Schedules 1 and 8, and, under Schedule 1 without a study loan or a bonus,
the tax offsets and Medicare levy adjustment a payee declares. The library
also applies Method A to a senior's or pensioner's bonus, which this repository refuses. The library's
annual_tax_estimate approximates repayment income and income for surcharge purposes by taxable
income. Both compose a resident's 2027-28 tax with the working Australians tax offset, as
rechecked at the library's commit e94cef24 on 16 November 2026: the lesser of $250 and the tax on
net labour income, when that exceeds $18,200, which the library's notes call approximate below $250, pending
a legislative instrument, though ITAA 1997 s 61-160 as Act No. 49 of 2026 enacts it leaves
nothing to one. This repository applies the offset before the seniors and low income tax offsets,
as s 63-10(1) orders, where the library applies it after them; the total is the same, but the
library can show a smaller offset. This repository also works out 2027-28's seniors and pensioners
tax offset thresholds from the regulations' indexation, where the library applies 2026-27's, and
compares the total with a given tax_withheld, where the library gives no refund for 2027-28.
The library estimates 2027-28 with a study loan or without hospital cover on figures the ATO had
not published, which this repository refuses: it takes 2027-28 with tax_withheld, hospital cover all
year and no study loan. This repository's personal-tax-estimate takes those incomes as established,
names the worksheet behind each line
and keeps its sources and refusals, shows Division 293 tax, and refuses part-year residents and
working holiday makers; both compose a full-year foreign resident's tax without the Medicare
levy. Both apply full and half Medicare levy exemptions and the Medicare levy
surcharge; the library takes a whole-year exemption and cover status only and applies the
surcharge rate to all income for surcharge purposes, where this repository apportions both by
days and applies the rate to taxable income and reportable fringe benefits only, as the ATO's
examples do. The library also covers a sole parent's surcharge, which this repository refuses.
Both work back from take-home pay to gross: v0.4.0's salary_for_take_home, read on
15 November 2026, gives the lowest whole-dollar annual salary whose take-home reaches a target,
with any study loan component, and payg-gross-up gives the gross of one pay, with or without
the component, whose withholding leaves the net exactly, listing every gross where more than one
does.
This repository covers 2024-25
withholding, Schedule 9's Medicare levy exemption scales, Schedule 5 Method B, Schedule 15 for
working holiday makers and Schedule 11 for termination payments, which the library does not. For
2026-27 both apply the 2025-26 Medicare levy low-income thresholds: the library notes that
2026-27's are not yet legislated, and this repository applies them as Act No. 58 of 2026 enacts
them for 2025-26 and later years.
This repository offers none of those hosted services. It has no connector for ChatGPT or the
Claude.ai web app, and it ships no ATO guidance or rulings corpus: its rulings tools search a corpus
you supply. It is not a registered tax or BAS agent, does not lodge and holds no third-party
certification such as ISO 27001.
Rust engine installation, component development, boundaries and releases
Development home for the Aus Accounting MCP application and 9 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.
Install the Rust engines
The 8 Rust engines are unreleased standalone binaries. With
Rust 1.99 or later, install au-accounting, one command
with a subcommand per engine (benchmarks, div7a, exchequer, payday-super,
gst-review, solomons, tax and wip):
au-accounting div7a --help then shows that engine's own commands; see
its README. To install one engine's own command
instead, name its crate from the table above, for example:
au-accounting gst-review review-coding and reconcile-bas read JSON on stdin;
see the GST Review schemas.
Prebuilt binaries are not published yet, so install from source as above. Release
Policy's release-binary.yml
now publishes Linux, macOS and Windows executables to GitHub Releases, without
crates.io, but no crate here has adopted it.
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.
To skip local setup, open the repository in GitHub Codespaces.
The devcontainer installs uv and runs uv sync --locked, so the fabricated examples
above run as written. Codespaces usage counts against your own GitHub quota.
The Codecov badge reports the Python components only. Each Rust crate's line coverage
is held to a floor in CI, from .github/ci/rust_coverage_floors.json.
Boundaries
Four structural boundaries hold across Australian Accounting:
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
aus-accounting-mcp and lodgment-calendar are each released on a namespaced tag
<component>/vX.Y.Z by their own root workflow .github/workflows/release-<component>.yml,
which calls the pinned Release Policy reusable workflow for that component directory only.
The 8 Rust engines have reserved tags and no publisher yet. CONTRIBUTING.md has the table.
The rates dataset in packages/au-tax-rates-data/ is never released on its own; the next
aus-accounting-mcp release bundles a copy of its records.
To check a downloaded release's checksum and SLSA provenance, follow Verify a release.
Licence
Each component's LICENSE applies to that component, and
packages/ato-benchmark-compare/NOTICE, packages/au-tax-rates-data/NOTICE and
apps/aus-accounting-mcp/NOTICE cover their ATO material.
Ryan Duguid is not a registered tax agent or BAS agent. Outputs are review aids, not tax, legal or financial advice or lodgements, and a person reviews each one before it is relied on. Support covers software issues reproduced with fabricated data: do not send taxpayer information or ask for advice, return preparation, tax-treatment confirmation or lodgement. The MCP server and each engine have their own DISCLAIMER.md.
Solomon Grundy, born on a Monday, reconciled by Sunday. Reusing this code? Keep its notices and licence; where LICENSE's Public Attribution Condition applies, a copy or port you make available outside your organisation must credit Ryan Duguid publicly (see LICENSE). AI agents: see AGENTS.md. Made in Newcastle, Australia by Ryan Duguid.