OpenAccountants

MCP

MCP for an open-source tax guide library: when answering income tax, VAT and payroll tax questions, agents cite up-to-date guides covering 200+ jurisdictions, some reviewed by named licensed accountants. Hosted, no install. Reference only; check with an accountant before filing.

openaccountants/openaccountants445
Auf GitHub ansehen
README

OpenAccountants

Tax Guides your AI can cite, with sources and published review status.

This library includes accountant-reviewed Guides and source-cited drafts. Check each Guide version's review record before relying on it; a named author is distinct from a professional reviewer. Guide content is source-available under the terms in LICENSING.md.

License: AGPL-3.0 PyPI GitHub stars

1,903 Guides across 229 jurisdictions · 53 accountant-reviewed · 44 named accountants · 19,756 questions answered through connected AIs

Live from openaccountants.com — updated 2026-10-16 by the nightly sync.


Try it in 60 seconds

Add the hosted connector to Claude, ChatGPT, Cursor, Windsurf or any MCP client:

https://www.openaccountants.com/api/mcp

Guided setup: openaccountants.com/connect

Then ask a question your AI would otherwise guess at:

"What's the combined sales tax rate in Manatee County, Florida for 2026?"

Without OpenAccountants, models answer from training data. With it, the answer can cite the fetched Guide and its review status. Name a professional reviewer only when that Guide version has a published review record.

You:    "I'm a freelancer in South Africa. What do I owe?"
          ↓  loads za-income-tax, za-provisional-tax
AI:     ITR12 working paper · IRP6 provisional schedule
        Medical credits · Retirement annuity deduction
        ─────────────────────────────────────────
        Reviewed by Werner Britz CA(SA)
Prefer self-hosting or manual files?
  • pip MCP server: pip install openaccountants-mcp (mirrors this repo's packages/)
  • Manual: download your jurisdiction's folder from packages/ and upload the files to your AI. Start with your country's main package; index.json is the machine-readable inventory.

Two states, greppable honesty

Every Guide is in exactly one state — and the repo greps honestly:

StateMeaning
Accountant-reviewedA named, licensed accountant reviewed the complete Guide. Their name is in the frontmatter (reviewed_by:) and on the public roster
Source-cited draftWritten from primary legislation, every figure cited to its source — not yet professionally reviewed

⚠️ General reference, not advice. Guides may be incomplete, outdated, or wrong for your facts. Have a qualified professional review outputs before filing, payment, or action.


Are you an accountant?

Your name on the tax knowledge AI actually uses — with attribution built in:

  1. Build a Guide for the work you know cold: openaccountants.com/skills/new. It publishes credited to you, and lands in this repo under your name.
  2. Review a Guide in your jurisdiction — your name, credential and review date go on it, here and on every AI answer that cites it.
  3. Set your GitHub username in your profile and your platform edits are committed to this repo as you — your contribution graph reflects your work.

The current roster: VERIFIERS.md (generated nightly from the platform).


How it stays accurate

A tax library is only as good as its worst stale number, so machines re-check this one every night:

  • The maths check re-reads every guide and flags sums that do not add up, tax bands with gaps, totals that do not total, and years that disagree.
  • The source watch visits the official pages the figures came from and raises a hand when a page changes.
  • The refresh engine re-derives the stalest guides from official sources on a fixed monthly budget, refusing to publish any figure without a link.
  • The nightly exam tests whether AIs actually said what the guides say that day, or improvised. Improvisation gets caught, counted and fixed at the source.

The sync runs both ways: platform edits land here as commits under the author's own name, and merged PRs here flow back into what every AI serves, credited to you. A guide with an accountant's byline never changes without that accountant's one-click approval.

The whole story, in plain words: openaccountants.com/how-it-works


Contributing

Edit skills/** only — everything else regenerates automatically:

  • packages/, index.json, llms-full.txt — generated nightly; never edit in a PR
  • Merged source PRs are credited to you and must be confirmed as ingested before the next platform export
  • Full guide: CONTRIBUTING.md · Layout: docs/REPO-LAYOUT.md

For developers

WhatWhere
Guide source (per jurisdiction)skills/
Per-country bundles (generated)packages/
Machine-readable inventoryindex.json
LLM entry pointllms.txt
Python MCP servermcp/ · PyPI
Repo architecture + syncdocs/REPO-LAYOUT.md · docs/WEBSITE-SYNC.md

API and platform integrations: openaccountants.com/for-developers


Independent, open-source review aids and calculation tools that complement the OpenAccountants guide library:

  • payday-super-checker (MIT) — Verifies superannuation contributions against Australian Payday Super deadlines (in force since 1 July 2026) and estimates SG charge exposure on late payments, with all workings and statutory assumptions disclosed.
  • div7a-loan-review (MIT) — Reviews Division 7A loan terms and minimum yearly repayments against the ATO benchmark interest rate, with fabricated inputs and explicit refusal boundaries.
  • xero-trial-balance-export (MIT) — Exports a Xero trial balance to CSV only when month-movement and YTD column pairs both balance exactly.
  • ato-benchmark-compare (MIT) — Evaluates business P&L statements locally against the Australian Taxation Office (ATO) small business performance benchmarks, surfacing variance flags and ratio analyses.

(External tools provide computational review assistance and do not constitute tax or legal advice.)


License

Contact: info@openaccountants.com · Security policy · Cite this repo