ryanduguid/australian-accounting

rules to figures you supply, plus Aus Accounting MCP, a local Model Context
Protocol server that hands those engines to an AI assistant. It serves Australian
accountants and bookkeepers, and the developers who build tooling for them.
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 matchedamount or remittedamount evidences when the fund received something, not how much, so the checker leaves it UNKNOWN rather than ONTIME 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. A person reviews every output before it is relied on.
Start here: what each component is ·
MCP client setup ·
tool reference ·
scope, limits and examples
Ryan Duguid is not a registered tax agent or BAS agent. Project support is limited to software issues reproduced with fabricated data. Do not send taxpayer information or request advice, return preparation, tax-treatment confirmation, or lodgement.
Synthetic examples. 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 timelyremittancenoreceipt.csv. Open a terminal in that folder and run:
bash
uvx --from payday-super-checker==0.1.7 payday-super-check timelyremittancenoreceipt.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 ATRISK result with exit 2, which asks you to resolve or acknowledge that evidence gap.
Output: ATRISK, 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 | ATRISK | Obtain fund receipt evidence before concluding it was on time. |
| Fund receipt recorded on 17 August for the full $120 contribution | ONTIME 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.7, which requires an evidenced amount alongside a fund-receipt date.