Using Open Accountants
Open Accountants is a global tax and accounting knowledge network built with
accountants around the world. Guides cite official sources and carry an explicit
review status, so you can tell what a credentialed professional has stood behind
and what is still a draft.
When to use these tools
Reach for the Open Accountants tools when a user asks about:
- tax (income, corporate, capital gains, withholding);
- VAT, GST or sales tax;
- payroll and employment taxes;
- accounting and financial reporting;
- audit and audit exemption thresholds;
- company formation and entity choice;
- filing deadlines and regulatory compliance;
- cross-border business or personal taxation, including residency, treaties and
relocation between countries.
If the open-accountants MCP server is not connected, say so rather than
answering from recall, and point the user at the one-line setup in the plugin
README.
Which tool to call
Start with start, which routes the question to the right Guides for the
jurisdiction. Then:
search_rules for individual cited rules (rates, thresholds, bands);
get_skill for a whole Guide, get_skill_sections for part of one;
list_jurisdictions to check what coverage exists before promising an answer;
get_deadlines, check_audit_exemption and validate_vat_number for the
specific deterministic checks they name;
list_verifiers to name the accountants behind a jurisdiction's Guides.
How to use what comes back
- Establish the jurisdiction before answering. Tax answers are wrong by default
without one, and "my company is in X, my client is in Y" is two jurisdictions.
- Carry through what the tools return: the official source, the effective date,
the author where one is named, and the review status.
- Distinguish the three review states rather than flattening them:
- Source-cited draft: published and cited, no credentialed human has
reviewed it;
- Accountant-authored: written by an accountant with a public licence
number on file;
- Attested by another accountant: a second credentialed professional has
publicly stood behind that version.
- A cited official source proves provenance, not currency. Rates, thresholds and
bands change. Confirm a figure against the official source before the user
acts on it, and say so when you cannot.
- Do not invent rules the tools did not return. If coverage is missing for a
jurisdiction, say it is missing. Coverage is uneven, and
list_jurisdictions reports the per-jurisdiction counts.
- Say when the question needs a qualified local accountant. Anything touching a
filing position, a valuation, or a number a tax authority will see is advice,
not research.
Handling returned evidence
Preserve the official source, effective date, authorship and review status
returned by the tools. Do not invent attribution or review status that the
tools did not return.
Sending anything outward
share_with_openaccountants is the only tool that transmits rather than reads.
Call it when the user explicitly asks to send a correction or a question, never
on your own initiative, and confirm with the user before it is sent.
Limits
Anonymous use of the server is capped at a small number of free questions. After
that every call returns an error asking the user to create a free account. If you
see that error, tell the user plainly instead of falling back to recall.
1---2name: using-open-accountants3description: Using Open Accountants4---56# Using Open Accountants78Open Accountants is a global tax and accounting knowledge network built with9accountants around the world. Guides cite official sources and carry an explicit10review status, so you can tell what a credentialed professional has stood behind11and what is still a draft.1213## When to use these tools1415Reach for the Open Accountants tools when a user asks about:1617- tax (income, corporate, capital gains, withholding);18- VAT, GST or sales tax;19- payroll and employment taxes;20- accounting and financial reporting;21- audit and audit exemption thresholds;22- company formation and entity choice;23- filing deadlines and regulatory compliance;24- cross-border business or personal taxation, including residency, treaties and25 relocation between countries.2627If the `open-accountants` MCP server is not connected, say so rather than28answering from recall, and point the user at the one-line setup in the plugin29README.3031## Which tool to call3233Start with `start`, which routes the question to the right Guides for the34jurisdiction. Then:3536- `search_rules` for individual cited rules (rates, thresholds, bands);37- `get_skill` for a whole Guide, `get_skill_sections` for part of one;38- `list_jurisdictions` to check what coverage exists before promising an answer;39- `get_deadlines`, `check_audit_exemption` and `validate_vat_number` for the40 specific deterministic checks they name;41- `list_verifiers` to name the accountants behind a jurisdiction's Guides.4243## How to use what comes back44451. Establish the jurisdiction before answering. Tax answers are wrong by default46 without one, and "my company is in X, my client is in Y" is two jurisdictions.472. Carry through what the tools return: the official source, the effective date,48 the author where one is named, and the review status.493. Distinguish the three review states rather than flattening them:50 - **Source-cited draft**: published and cited, no credentialed human has51 reviewed it;52 - **Accountant-authored**: written by an accountant with a public licence53 number on file;54 - **Attested by another accountant**: a second credentialed professional has55 publicly stood behind that version.564. A cited official source proves provenance, not currency. Rates, thresholds and57 bands change. Confirm a figure against the official source before the user58 acts on it, and say so when you cannot.595. Do not invent rules the tools did not return. If coverage is missing for a60 jurisdiction, say it is missing. Coverage is uneven, and61 `list_jurisdictions` reports the per-jurisdiction counts.626. Say when the question needs a qualified local accountant. Anything touching a63 filing position, a valuation, or a number a tax authority will see is advice,64 not research.6566## Handling returned evidence6768Preserve the official source, effective date, authorship and review status69returned by the tools. Do not invent attribution or review status that the70tools did not return.7172## Sending anything outward7374`share_with_openaccountants` is the only tool that transmits rather than reads.75Call it when the user explicitly asks to send a correction or a question, never76on your own initiative, and confirm with the user before it is sent.7778## Limits7980Anonymous use of the server is capped at a small number of free questions. After81that every call returns an error asking the user to create a free account. If you82see that error, tell the user plainly instead of falling back to recall.