Openaccountants Mcp
io.github.openaccountantsPublished by GitHub account openaccountantsv0.1.1Updated Oct 24, 2026
Open-source tax skills for AI across 134 countries.
Overview
Lets an assistant look up source-cited tax guides for many countries and cite the guide version and its review status.
- What you can do
- Provides an assistant with an open-source library of tax guides covering many jurisdictions, so answers about tax rates, filings and obligations can be grounded in a fetched guide rather than training data. Guides are marked either as accountant-reviewed or as source-cited drafts, and the server can surface the review record and named reviewer where one exists. It is distributed as a Python package that runs locally over stdio, and the same library is also offered as a hosted connector and as downloadable files.
- When to use it
- Useful when a user asks a jurisdiction-specific tax question and you want the answer to cite a specific guide and its review status instead of being guessed. Less useful for general conversation or for anything outside tax reference material.
- Requirements
- Runs as a local process over stdio, installed from PyPI as openaccountants-mcp and started with Python, so a Python runtime is needed. No authentication, environment variables or headers are declared. The README also describes a hosted connector and manual file downloads as alternatives.
Installation
In SourceWeft
- Open Openaccountants Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
OpenAccountants
Open tax skills for AI. Your AI answers tax questions from memory. Add these skills and it answers from the law: every rate, threshold and deadline cited to its official source, for 190+ jurisdictions.
[License: AGPL-3.0] [PyPI] [GitHub stars]
2,132 AI skills across 249 jurisdictions · 33 accountant-reviewed · 39 named accountants · 6,115 questions answered through connected AIs
Live from openaccountants.com — updated 2026-10-30 by the nightly sync.
Find your country
Browse all countries, by region, with the state of each pack. United States: federal and states.
Add to your AI
Add this address to Claude, ChatGPT, Cursor, Windsurf or any AI that takes a connector:
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?"
Prefer self-hosting or manual files?
- pip MCP server:
pip install openaccountants-mcp(mirrors this repo'spackages/) - Manual: download your jurisdiction's folder from
packages/and upload the files to your AI. Start with your country's main package;index.jsonis the machine-readable inventory.
Also listed on Smithery and the MCP Registry.
Contribute
Three ways in, all in CONTRIBUTING.md:
- I can write. Take a country and write its missing skills from the law.
- I am an accountant. Review a skill and put your name on it.
- I found a mistake. Open an issue with the source that shows it.
How to read a skill
This library holds accountant-reviewed skills and skills no accountant has signed off yet. Check each skill version's review record before relying on it; a named author is distinct from a professional reviewer. Skill content is source-available under the terms in LICENSING.md.
Every skill is in exactly one state:
The definitions: docs/QUALITY-TIERS.md. How skills are built, checked and corrected: docs/ACCURACY-METHODOLOGY.md. Which number to quote and where it is measured: docs/COVERAGE.md.
⚠️ General reference, not advice. Skills may be incomplete, outdated, or wrong for your facts. Have a qualified professional review outputs before filing, payment, or action.
Need the work done?
OpenAccountants also does the bookkeeping, VAT, payroll and tax work for businesses, in the countries they work in. Talk to us. The skills and the AI connection stay free.
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 skill 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 skills 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 skills 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 skill 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
For developers
API and platform integrations: openaccountants.com/for-developers
Related open-source projects
Independent, open-source review aids and calculation tools that complement the OpenAccountants skill library:
- payday-super-checker (Apache-2.0): 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 (Apache-2.0): 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 (Apache-2.0): Exports a Xero trial balance to CSV only when month-movement and YTD column pairs both balance exactly.
- ato-benchmark-compare (Apache-2.0): 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
- Code (mcp/, scripts/, tools/, calculators/): AGPL-3.0-only
- Skill content: OpenAccountants Guide License, see LICENSING.md; commercial options in COMMERCIAL-LICENSING.md
Contact: [email protected] · Security policy · Cite this repo
Source: README.md at commit 59c23ac
Tools
0Version history
1- v0.1.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts