OpenAccountants: tax guides an AI can cite, and a byline to check
Open-source Tax Guides for AI agents, reviewed by named CPAs/CAs/EAs. 1,000+ Guides across 190+ jurisdictions. MCP server included. Works with Claude, ChatGPT, Cursor.
At a glance
- What is it?
- A repository of tax guides served to AI clients over MCP, where each guide is either reviewed by a named accountant or marked as a source-cited draft, and four nightly jobs re-check the arithmetic.
- Who is it for?
- OpenAccountants suits a team that wants its AI to stop guessing at tax rates and to cite a jurisdiction's guide instead, and that can live with a general reference rather than advice. It does not suit anyone filing on the answer alone: the project states that guides may be incomplete, outdated or wrong for your facts, and only 53 of the 1,870 Guides carry an accountant's byline.
- Can I use it commercially?
- Yes, with strict conditions. AGPL-3.0 is a network copyleft licence: if people use a modified version over a network, for example as a hosted service, you must offer them its source code under the same licence.
- Is it still maintained?
- Yes. The repository received new commits within the last day.
- What is it written in?
- Mainly Python, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- openaccountants/openaccountants492 ★ · +119
| Repository | 2026-09-13 | 2026-11-15 |
|---|---|---|
| openaccountants/openaccountants | 373 | 492 |
119 Stars in the last 63 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
Three counters, and they do not agree
The repository description says 1,000+ Guides across 190+ jurisdictions. The stats block on the README says 1,870 Guides across 231 jurisdictions, 53 accountant-reviewed, 45 named accountants, and 15,298 questions answered through connected AIs, updated 2026-10-01 by the nightly sync. The release notes count a third thing: v2.0.0, tagged on 22 May 2026, reads 482 skills across 133 countries plus 51 US states. Nobody is lying, but skills, countries and jurisdictions are different units, so anyone comparing a figure from the release feed with one from the README is comparing two things that were never the same measure. The number to quote when you describe the project is the nightly one, since it is the one that regenerates.
Accountant-reviewed is a frontmatter field, not a badge
Every guide is in exactly one of two states. Accountant-reviewed means a named, licensed accountant reviewed the complete guide, and their name sits in the frontmatter as reviewed_by: and on VERIFIERS.md, which is generated nightly from the platform. Source-cited draft means the guide was written from primary legislation with every figure cited to its source, and no professional has read it end to end. That distinction carries the weight of the whole project, because 53 of the 1,870 guides sit in the first state. The sync also protects it: a guide with an accountant's byline never changes without that accountant's one-click approval. The page pairs the states with a warning that guides may be incomplete, outdated or wrong for your facts.
What a cited answer looks like
The example on the page is a South African freelancer asking what they owe. The assistant loads za-income-tax and za-provisional-tax, then answers with an ITR12 working paper, an IRP6 provisional schedule, medical credits and a retirement annuity deduction, closing with Reviewed by Werner Britz CA(SA). The other example is narrower: the combined sales tax rate in Manatee County, Florida for 2026, which without the connector would come out of training data. The credential is part of the answer, not a footnote, since CA(SA) tells the reader which professional regime the numbers were written for. Which jurisdictions have guides at all is a coverage question the index answers, since index.json is the machine-readable inventory of what exists.
Four nightly jobs guard the numbers
The accuracy story is four automated passes, all running 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 with each other. 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 and refuses to publish any figure without a link. The nightly exam then checks whether AIs actually said what the guides say that day or improvised, and improvisation is caught, counted and fixed at the source. That last one is the only check aimed at the model rather than the data.
Edit skills/, and everything else regenerates
The contribution rule is one line: edit skills/ only. packages/, index.json and llms-full.txt are generated nightly and must never be edited in a pull request, which means a contributor who fixes a number in the bundle will have the fix overwritten. Merged source PRs are credited to their author and must be confirmed as ingested before the next platform export, so a merged change is not live until that confirmation happens. The layout is documented in docs/REPO-LAYOUT.md and the two-way sync in docs/WEBSITE-SYNC.md. For models that read files rather than call an endpoint, llms.txt is the entry point and llms-full.txt is the generated bulk, while VERIFIERS.md, like packages/, comes from the platform on a nightly run.
Hosted endpoint, pip package, or your own container
Three routes in, and they cost different amounts of setup. The hosted connector is one URL added to Claude, ChatGPT, Cursor, Windsurf or any MCP client, with guided setup at openaccountants.com/connect:
https://www.openaccountants.com/api/mcpFor self-hosting, pip install openaccountants-mcp mirrors the repository's packages/ directory, or you download one jurisdiction's folder and upload the files to your AI by hand. The container image is the third option, and its Dockerfile shows the details that matter:
docker build -t openaccountants-mcp .
docker run --rm -p 127.0.0.1:8000:8000 -e MCP_HOST=0.0.0.0 openaccountants-mcpThe image is python:3.11-slim and speaks the MCP SDK's Streamable-HTTP transport, with MCP_TRANSPORT, MCP_HOST, MCP_PORT, MCP_STREAMABLE_HTTP_PATH and OPENACCOUNTANTS_ROOT as the optional knobs. Its comments also record a build ordering trap: packages/ is copied before the install because mcp/hatch_build.py bundles that tree into the wheel and fails closed without it.
Code under AGPL, guide content under its own license
The license is split by kind. Code in mcp/, scripts/ and tools/ is AGPL-3.0. Guide content is under the OpenAccountants Guide License v1.0, a separate grant, and the repository carries LICENSING.md, COMMERCIAL-LICENSING.md, a LICENSES/ directory and REUSE.toml to keep that split explicit. So a fork that wants to redistribute the guides is reading two licenses, not one. The related review tools listed alongside are all MIT and all Australian: payday-super-checker against Payday Super deadlines in force since 1 July 2026, div7a-loan-review against the ATO benchmark interest rate, xero-trial-balance-export which only exports when both column pairs balance exactly, and ato-benchmark-compare. The page notes those external tools give computational review assistance and are not tax or legal advice. Work on the library itself is newer than its last release: v2.2.0 shipped on 4 July 2026, and the last push to main is dated 1 October 2026.
Editorial conclusion
OpenAccountants suits a team that wants its AI to stop guessing at tax rates and to cite a jurisdiction's guide instead, and that can live with a general reference rather than advice. It does not suit anyone filing on the answer alone: the project states that guides may be incomplete, outdated or wrong for your facts, and only 53 of the 1,870 Guides carry an accountant's byline. Before you wire the connector into a client, check two things: whether the jurisdiction you care about is in the 231 listed, and whether its guide is accountant-reviewed or a source-cited draft, since the state lives in the reviewed_by frontmatter and on the generated VERIFIERS.md roster.
Frequently asked questions
How many tax Guides does OpenAccountants have?
The stats block, updated 2026-10-01 by the nightly sync, counts 1,870 Guides across 231 jurisdictions, with 53 accountant-reviewed, 45 named accountants and 15,298 questions answered through connected AIs. The repository description still says 1,000+ Guides across 190+ jurisdictions, and the release notes count a third unit again: 482 skills across 133 countries at v2.0.0.
Which AI tools can connect to OpenAccountants?
The hosted connector is added to Claude, ChatGPT, Cursor, Windsurf or any MCP client at https://www.openaccountants.com/api/mcp, with guided setup at openaccountants.com/connect. For self-hosting there is a pip package, openaccountants-mcp, which mirrors the repository's packages/ directory, and a container image built from the Dockerfile.
What does it mean when an OpenAccountants Guide is a source-cited draft?
Every Guide is in one of two states. An accountant-reviewed Guide was read end to end by a named licensed accountant whose name is in the reviewed_by frontmatter and on VERIFIERS.md. A source-cited draft is written from primary legislation with every figure cited to its source, and has not been professionally reviewed.
How does OpenAccountants catch a wrong number?
A maths check re-reads every guide nightly and flags sums that do not add up, tax bands with gaps and years that disagree. A source watch visits the official pages the figures came from, a refresh engine re-derives the stalest guides on a fixed monthly budget and refuses to publish a figure without a link, and a nightly exam checks whether AIs said what the guides say or improvised.
Can I contribute a fix to OpenAccountants myself?
Contributors edit skills/ only. packages/, index.json and llms-full.txt are generated nightly and must not be edited in a pull request, and merged source PRs are credited to their author and have to be confirmed as ingested before the next platform export.
Official sources
Where developers are discussing it
Posts on Hacker News, dev.to and Lobsters that link to this repository, found by our scan of those communities. 1 in the last 30 days; newest first.
- Open-source tax rules for 100 countries that your LLM can useHacker News · Oct 18, 2026 · 3 points · 0 comments
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/openaccountants-openaccountants)Star history chart for your README
[](https://hysenlabs.com/projects/openaccountants-openaccountants)Was this useful?