Tax skills in 190+ jurisdictions. Sources and accountant approval status shown per skill.
io.github.openaccountants/openaccountants MCP Server
This MCP server provides open-source AI accounting skills focused on tax guidance. It describes “OpenAccountants” as guides that can be cited, verified by licensed accountants for areas including tax, VAT, and payroll. The server is associated with toolCount: 14 and is published under AGPL-3.0.
Call this first for any tax, VAT/GST, payroll or filing question about a country or US state, such as "how much tax will I pay in Spain", "do I need to register for VAT", "when is my tax return due", "is this deductible", "how is a freelancer or a company taxed in Germany", "sales tax in Texas" or "what changes if I move to Portugal". Pass the user's question as `intent` and the country or US state as `jurisdiction` ('DE', 'US-TX', 'Florida'). If no place is named, start infers one when the question makes it clear and says so in `jurisdiction_source`. Returns the skills to read next (`skills_to_load`, open each with get_skill), or what is still needed, usually the country. Covers 190+ jurisdictions; where no skill exists yet it returns a research_brief naming the official sources. Called with an empty intent (no question yet), it returns the topics and jurisdictions covered.
Parameters5
intent
string
required
The user's question or goal, in English; an empty string when there is no question yet. If the user wrote in another language, translate it and keep the local tax term in brackets, e.g. 'VAT return for a freelancer (btw-aangifte zzp)', 'small business VAT exemption (Kleinunternehmer)'.
jurisdiction
string
optional
Country or US state: ISO 2-letter code, US state code or name (e.g. 'MT', 'GB', 'US-CA', 'Florida'). Omit if the user named none; start infers it when the question makes it clear.
acting_as
string
optional
Optional. Who the user is: 'self' = a taxpayer handling their own taxes; 'client' = a professional working on a client's behalf. Infer it from the conversation; omit it if unclear.
reason
string
optional
One sentence, in the user's own words, on what they actually asked for here — captured only to improve routing. E.g. 'user sold ETH and wants to know what to report'. Optional but helpful.
taxpayer_type
string
optional
The taxpayer's occupation, when known. Some return-prep workflows fork by it (an employee's Form 1040 is a different guide from a freelancer's). Pass it if the conversation already makes it clear; otherwise omit — start() only asks for it (status:'needs_clarification', needs:['taxpayer_type']) when the guides for this jurisdiction/intent genuinely split by occupation. 'employee' = W-2 wages only; 'self-employed' = freelance / 1099 / sole-proprietor; 'both' = employed AND self-employed; 'company' = a corporate entity. Don't guess — ask the user one short question if unsure.
Raw schema
{
"type": "object",
"properties": {
"intent": {
"type": "string",
"description": "The user's question or goal, in English; an empty string when there is no question yet. If the user wrote in another language, translate it and keep the local tax term in brackets, e.g. 'VAT return for a freelancer (btw-aangifte zzp)', 'small business VAT exemption (Kleinunternehmer)'."
},
"jurisdiction": {
"type": "string",
"description": "Country or US state: ISO 2-letter code, US state code or name (e.g. 'MT', 'GB', 'US-CA', 'Florida'). Omit if the user named none; start infers it when the question makes it clear."
},
"acting_as": {
"type": "string",
"enum": [
"self",
"client"
],
"description": "Optional. Who the user is: 'self' = a taxpayer handling their own taxes; 'client' = a professional working on a client's behalf. Infer it from the conversation; omit it if unclear."
},
"reason": {
"type": "string",
"description": "One sentence, in the user's own words, on what they actually asked for here — captured only to improve routing. E.g. 'user sold ETH and wants to know what to report'. Optional but helpful."
},
"taxpayer_type": {
"type": "string",
"enum": [
"employee",
"self-employed",
"both",
"company",
"other"
],
"description": "The taxpayer's occupation, when known. Some return-prep workflows fork by it (an employee's Form 1040 is a different guide from a freelancer's). Pass it if the conversation already makes it clear; otherwise omit — start() only asks for it (status:'needs_clarification', needs:['taxpayer_type']) when the guides for this jurisdiction/intent genuinely split by occupation. 'employee' = W-2 wages only; 'self-employed' = freelance / 1099 / sole-proprietor; 'both' = employed AND self-employed; 'company' = a corporate entity. Don't guess — ask the user one short question if unsure."
}
},
"required": [
"intent"
]
}
search_skills
Find or browse skills. With a `query`, finds the skill for a specific tax topic by keyword: a deduction, form, regime or rule such as 'home office deduction', 'Schedule C', 'reverse charge', 'crypto capital gains' or 'Beckham regime'. Without a query, lists the skills for a jurisdiction, domain or role (for example every skill for 'MT', or every 'payroll' skill), each with its current approval label, 100 at a time (limit up to 200; page with offset and next_offset). Optionally limit either to one jurisdiction or domain. Returns skill slugs to open with get_skill. Set content_type='method' to find step-by-step methods (run them via start), each tagged accountant-reviewed or source-cited.
Parameters7
query
string
optional
Search term in English, e.g. 'home office deduction', 'crypto capital gains', 'reverse charge'. If the user wrote in another language, translate it and add the local term, e.g. 'VAT return btw-aangifte'. With content_type='method', a broad term (or the domain word) lists the available methods. Omit it to list (browse) the skills for a jurisdiction, domain or role instead.
jurisdiction
string
optional
Optional ISO 2-letter country code to limit the search
domain
string
optional
Optional accounting domain to limit the search (e.g. 'vat-gst', 'payroll', 'income-tax', 'financial-reporting', 'audit-assurance').
content_type
string
optional
What kind of skill to find. 'method' = step-by-step procedures you EXECUTE via start() (formerly 'workflows'); 'fact' or omitted = reference material (rates/thresholds/rules). A skill can be either or both.
role
string
optional
Optional, when browsing: foundation, compute, orchestrator or reference.
limit
integer
optional
When browsing: skills per page (default 100, max 200).
offset
integer
optional
When browsing: skills to skip; pass next_offset from the previous page.
Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search term in English, e.g. 'home office deduction', 'crypto capital gains', 'reverse charge'. If the user wrote in another language, translate it and add the local term, e.g. 'VAT return btw-aangifte'. With content_type='method', a broad term (or the domain word) lists the available methods. Omit it to list (browse) the skills for a jurisdiction, domain or role instead."
},
"jurisdiction": {
"type": "string",
"description": "Optional ISO 2-letter country code to limit the search"
},
"domain": {
"type": "string",
"description": "Optional accounting domain to limit the search (e.g. 'vat-gst', 'payroll', 'income-tax', 'financial-reporting', 'audit-assurance')."
},
"content_type": {
"type": "string",
"enum": [
"method",
"fact"
],
"description": "What kind of skill to find. 'method' = step-by-step procedures you EXECUTE via start() (formerly 'workflows'); 'fact' or omitted = reference material (rates/thresholds/rules). A skill can be either or both."
},
"role": {
"type": "string",
"description": "Optional, when browsing: foundation, compute, orchestrator or reference."
},
"limit": {
"type": "integer",
"description": "When browsing: skills per page (default 100, max 200)."
},
"offset": {
"type": "integer",
"description": "When browsing: skills to skip; pass next_offset from the previous page."
}
},
"required": []
}
get_skill
Open a skill by slug (from start, search_skills or search_rules) to answer the user's question. Returns the skill's rules and method, its quality tier, the named accountant where one reviewed it, a `section_index` of sections not inlined, and a provenance footer to keep with the answer. To read sections it did not inline, call it again with `sections` (their index numbers) or `all_sections: true`.
Parameters4
slug
string
required
Skill slug, e.g. 'us-schedule-c-and-se-computation'
reason
string
optional
One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
sections
array
optional
Optional. Return these sections in full instead of the compact core: their `index` numbers from section_index.
all_sections
boolean
optional
Optional. true = return every section in full, with its heading and markdown.
Raw schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Skill slug, e.g. 'us-schedule-c-and-se-computation'"
},
"reason": {
"type": "string",
"description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional."
},
"sections": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Optional. Return these sections in full instead of the compact core: their `index` numbers from section_index."
},
"all_sections": {
"type": "boolean",
"description": "Optional. true = return every section in full, with its heading and markdown."
}
},
"required": [
"slug"
]
}
search_rules
Look up tax rates, thresholds and rules in one or many jurisdictions, such as 'VAT rates in MT, IE and DE', 'income tax brackets for 2025' or 'rules mentioning reverse charge'. Returns a bundled markdown rule set plus each jurisdiction's official source (`official_source`). For one specific figure in one jurisdiction a skill is often more complete (search_skills then get_skill): a figure can sit in a skill without being a separate rule here, and then this returns related guidance instead. Entries tagged `GUIDANCE` are text, not values. Figures are not certified current: confirm each against `official_source` and prefer it when they disagree. By default returns all matching rules, each tagged with its verification status; status:'verified' excludes draft, needs_update and unsure rules; it still includes research-verified (source-cited) rules, so it does not mean accountant-reviewed. Set `facets: true` to get the valid filter values instead of rules; a call that finds nothing returns `valid_values` for the filter that missed.
Parameters13
jurisdictions
array
optional
ISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions.
domains
array
optional
Accounting domains, e.g. ['vat-gst','income-tax']. facets: true lists them.
roles
array
optional
Skill roles: foundation | compute | orchestrator | reference.
block_types
array
optional
Rule kinds to include. Default = all of these (framing prose + workflow steps are excluded).
statuses
array
optional
Verification statuses to include. Default = all (each rule is tagged).
Free-text search over each rule's label, value, and citation.
limit
integer
optional
Max rules to return (default 200, max 500).
offset
integer
optional
Pagination offset — pass the previous response's next_offset.
reason
string
optional
One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
facets
boolean
optional
true = return the valid filter values (jurisdictions, domains, roles, rule kinds, statuses, tax years, sample topics) instead of rules. Other arguments are ignored.
Raw schema
{
"type": "object",
"properties": {
"jurisdictions": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions."
},
"domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "Accounting domains, e.g. ['vat-gst','income-tax']. facets: true lists them."
},
"roles": {
"type": "array",
"items": {
"type": "string"
},
"description": "Skill roles: foundation | compute | orchestrator | reference."
},
"block_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"rate",
"threshold",
"rule",
"formula",
"refusal_code",
"definition",
"table_ref",
"table"
]
},
"description": "Rule kinds to include. Default = all of these (framing prose + workflow steps are excluded)."
},
"statuses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"draft",
"research_verified",
"accountant_verified",
"needs_update",
"unsure"
]
},
"description": "Verification statuses to include. Default = all (each rule is tagged)."
},
"status": {
"type": "string",
"enum": [
"all",
"verified"
],
"description": "Shorthand for `statuses`: 'verified' = accountant- + research-verified only. Default 'all'."
},
"tax_year": {
"type": "integer",
"description": "Limit to a tax year, e.g. 2025."
},
"topic": {
"type": "string",
"description": "Filter by a fact topic."
},
"text": {
"type": "string",
"description": "Free-text search over each rule's label, value, and citation."
},
"limit": {
"type": "integer",
"description": "Max rules to return (default 200, max 500)."
},
"offset": {
"type": "integer",
"description": "Pagination offset — pass the previous response's next_offset."
},
"reason": {
"type": "string",
"description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional."
},
"facets": {
"type": "boolean",
"description": "true = return the valid filter values (jurisdictions, domains, roles, rule kinds, statuses, tax years, sample topics) instead of rules. Other arguments are ignored."
}
}
}
get_deadlines
Filing and payment deadlines for a country or US state: 'when is my tax return due', 'when do I file VAT', 'when is the next instalment'. Returns upcoming dates and recurring filing rhythms (monthly VAT, quarterly instalments) from the OpenAccountants tax calendar. Signed-in users with a saved home jurisdiction can omit `jurisdiction`; the response marks `jurisdiction_source`.
Parameters2
jurisdiction
string
optional
ISO code, slug, or name ('MT', 'US-CA', 'Malta'). Optional for signed-in users with a saved home jurisdiction.
horizon_days
integer
optional
How far ahead to look (default 120, max 366).
Raw schema
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"description": "ISO code, slug, or name ('MT', 'US-CA', 'Malta'). Optional for signed-in users with a saved home jurisdiction."
},
"horizon_days": {
"type": "integer",
"description": "How far ahead to look (default 120, max 366)."
}
}
}
list_jurisdictions
Answers 'which countries do you cover?' or 'what is there for [country]?'. Returns every jurisdiction with published skills (countries as ISO 2, US states as US-XX, Canadian provinces) with skill counts, accountant-reviewed counts and the named lead accountant where there is one.
Parameters
No parameters.
Raw schema
{
"type": "object",
"properties": {}
}
list_verifiers
Answers 'who reviewed this?' or 'which accountants are behind this?'. Returns the named licensed accountants who have signed off on OpenAccountants jurisdictions, with their credentials and the jurisdictions they cover.
Parameters1
jurisdiction
string
optional
Optional ISO code filter — only return verifiers for this jurisdiction.
Raw schema
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"description": "Optional ISO code filter — only return verifiers for this jurisdiction."
}
}
}
get_quote
Call only when the user asks what OpenAccountants charges, requests a quote, or asks whether their current fee is fair. Returns the same published plans, service prices, limits, market exceptions and hourly rate as the website, plus the engagement process and contact details. Match the client's scope to the listed prices; incomplete scope means the total is provisional. Separately quoted services must be confirmed by OpenAccountants. This tool does not create an engagement.
Parameters6
jurisdiction
string
optional
The client's country (ISO code or name). Logged so we know where demand is; not used to price.
entity_type
string
optional
What the client is. Logged.
services
array
optional
What they want, e.g. bookkeeping, vat, payroll, tax_return, year_end, formation, relocation. Logged.
monthly_volume
string
optional
One line on size: transactions, orders, staff, channels. Logged, and what you scope the fee on.
current_fee
string
optional
What they pay today, if they said. Logged; useful for the fairness question.
reason
string
optional
One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
Raw schema
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"description": "The client's country (ISO code or name). Logged so we know where demand is; not used to price."
},
"entity_type": {
"type": "string",
"enum": [
"sole_trader",
"company",
"individual",
"other"
],
"description": "What the client is. Logged."
},
"services": {
"type": "array",
"items": {
"type": "string"
},
"description": "What they want, e.g. bookkeeping, vat, payroll, tax_return, year_end, formation, relocation. Logged."
},
"monthly_volume": {
"type": "string",
"description": "One line on size: transactions, orders, staff, channels. Logged, and what you scope the fee on."
},
"current_fee": {
"type": "string",
"description": "What they pay today, if they said. Logged; useful for the fairness question."
},
"reason": {
"type": "string",
"description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional."
}
}
}
validate_vat_number
Check live whether an EU VAT number is valid and registered, for example before applying a B2B reverse charge, zero-rating an intra-EU sale or onboarding a supplier. Queries the European Commission's VIES registry and returns the verdict plus the registered business name and address where the authority discloses them. Coverage: the 27 EU member states plus 'XI' (Northern Ireland); use 'EL' for Greece. Other countries, including the UK, are not supported yet: say live validation is not available there rather than guessing. If the registry is down the response says so.
Parameters2
country_code
string
optional
2-letter EU member-state code of the VAT number, e.g. 'DE', 'IE', 'FR'. Use 'EL' for Greece and 'XI' for Northern Ireland. May be omitted if the country prefix is already part of vat_number.
vat_number
string
required
The VAT number, with or without the country prefix and spaces, e.g. 'IE6388047V', 'IE 6388047V', or '6388047V'.
Raw schema
{
"type": "object",
"properties": {
"country_code": {
"type": "string",
"description": "2-letter EU member-state code of the VAT number, e.g. 'DE', 'IE', 'FR'. Use 'EL' for Greece and 'XI' for Northern Ireland. May be omitted if the country prefix is already part of vat_number."
},
"vat_number": {
"type": "string",
"description": "The VAT number, with or without the country prefix and spaces, e.g. 'IE6388047V', 'IE 6388047V', or '6388047V'."
}
},
"required": [
"vat_number"
]
}
check_audit_exemption
Answers 'does my company need an audit?' for a private limited company in Malta (MT, Article 185(2) micro thresholds) or the UK (GB, small-company thresholds before and after 6 April 2025). A deterministic check of turnover, balance sheet total and average employees. Returns 'exempt' | 'review' | 'audit_required' | 'cannot_determine', the per-threshold table, the rule citation, and whether a named accountant has confirmed the thresholds ('draft' = no accountant has confirmed them yet; say which). Pass prior_year figures: most regimes are two-consecutive-year tests, so without them a qualifying year returns 'review'. 'cannot_determine' is a valid outcome (unsupported jurisdiction, wrong currency, a shape needing judgment). Use the determination as returned, not thresholds from memory.
Parameters9
jurisdiction
string
required
ISO-style code. MT and GB supported today.
financial_year_end
string
required
ISO date the financial year ends, e.g. '2025-12-31'.
turnover
number
required
Revenue/turnover for the year, in the jurisdiction's currency.
balance_sheet_total
number
required
Total assets at the balance sheet date.
employees_average
number
required
Average number of employees during the year.
currency
string
required
Currency of the figures — must match the regime (EUR for MT, GBP for GB); convert first, never guess a rate.
entity_type
string
optional
Optional. 'private_ltd' (default), 'plc', 'branch'. Non-private shapes route to a human.
group_member
boolean
optional
Optional. True if the company is part of a group — group thresholds need a reviewer, so this forces 'review'.
prior_year
object
optional
Prior-year figures for the two-consecutive-years test.
Raw schema
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"description": "ISO-style code. MT and GB supported today."
},
"financial_year_end": {
"type": "string",
"description": "ISO date the financial year ends, e.g. '2025-12-31'."
},
"turnover": {
"type": "number",
"description": "Revenue/turnover for the year, in the jurisdiction's currency."
},
"balance_sheet_total": {
"type": "number",
"description": "Total assets at the balance sheet date."
},
"employees_average": {
"type": "number",
"description": "Average number of employees during the year."
},
"currency": {
"type": "string",
"description": "Currency of the figures — must match the regime (EUR for MT, GBP for GB); convert first, never guess a rate."
},
"entity_type": {
"type": "string",
"description": "Optional. 'private_ltd' (default), 'plc', 'branch'. Non-private shapes route to a human."
},
"group_member": {
"type": "boolean",
"description": "Optional. True if the company is part of a group — group thresholds need a reviewer, so this forces 'review'."
},
"prior_year": {
"type": "object",
"description": "Prior-year figures for the two-consecutive-years test.",
"properties": {
"turnover": {
"type": "number"
},
"balance_sheet_total": {
"type": "number"
},
"employees_average": {
"type": "number"
}
}
}
},
"required": [
"jurisdiction",
"financial_year_end",
"turnover",
"balance_sheet_total",
"employees_average",
"currency"
]
}
compute
Computes a tax figure with fixed, tested code instead of mental arithmetic. Use this for any figure an engine below covers; never compute that figure yourself. Pass only the facts the user gave: the engine applies the tax rules itself (allowances, standard deductions, bands, caps) and never asks you to decide a rule. Returns the result, every step, each rate used with its skill, section and quoted line, the engine's assumptions, skills_used with each skill's approval label (state it exactly as given) and a receipt id. Every engine takes tax_year and refuses a year it has no figures for. Facts marked * are required; an optional fact you leave out takes its default, and the answer states that as an assumption. If the engine returns missing_rule or needs_input, tell the user exactly what is missing or ask them for the fact. Never call again with guessed or altered facts to get a number, and never compute the figure yourself instead.
Engines:
- nl_vpb_2026 [NL]: Netherlands corporate income tax (vennootschapsbelasting) for 2026 on a BV/NV's taxable amount (after loss offset and exemptions). Facts: taxable_amount* (number), tax_year* (2026).
- uk_ani_pension_target_2026_27 [GB]: UK 2026-27: how much to pay (net) into a relief-at-source personal pension to bring adjusted net income down to a limit. Targets: personal_allowance_taper (GBP 100,000), child_benefit_charge_nil (GBP 60,000), tax_free_childcare (limit not served by any skill: always returns missing_rule until a skill serves it). Facts: total_taxable_income* (number), existing_gross_ras_contributions (number, default 0), gross_gift_aid (number, default 0), target* (personal_allowance_taper|child_benefit_charge_nil|tax_free_childcare), tax_year* (2026-27).
- uk_paye_take_home_2026_27 [GB]: UK employee annual income tax (rUK rates: England, Wales, Northern Ireland) and employee Class 1 NIC (category A) on salary for 2026-27, and take-home pay. Annual basis. Facts: annual_salary* (number), region* (england|wales|northern_ireland|scotland), nic_category (string, default A), other_income (number, default 0), gross_pension_contributions_ras (number, default 0), tax_year* (2026-27).
- ca_income_tax_2026 [CA]: Canada personal income tax for 2026 or 2025 for a single person resident in Ontario, British Columbia or Alberta on 31 December: CPP and EI, net and taxable income, federal tax (basic personal amount with its phase-down, Canada employment amount), provincial tax (Ontario surtax, tax reduction, LIFT and Health Premium; BC tax reduction; Alberta 8% band and supplemental credit), the balance owing or refund against tax already paid, and what more RRSP saves. Quebec, dividends, a spouse or dependants, age 65 or over, and employment plus self-employment together are refused. Facts: province* (ON|BC|AB|QC), employment_income (number, default 0), self_employment_net_income (number, default 0), other_income (number, default 0), eligible_dividends (number, default 0), other_dividends (number, default 0), rrsp_deduction (number, default 0), tax_withheld (number, default 0), has_spouse_or_partner (boolean, default false), dependants (number, default 0), age_65_or_over (boolean, default false), tax_year* (2025|2026).
- ca_cpp_ei_employee_2026 [CA]: Canada (outside Quebec) employee CPP (base + first additional), CPP2 and EI premiums for a full calendar year 2026 with one employer. Facts: annual_pensionable_earnings* (number), province* (string), months_employed (number, default 12), tax_year* (2026).
- au_sbito_2026_27 [AU]: Australia 2026-27 small business income tax offset for an individual resident: 16% of the tax on net small business income, capped at $1,000, aggregated turnover under $5m. Facts: taxable_income* (number), net_small_business_income* (number), aggregated_turnover* (number), tax_year* (2026-27).
- au_resident_tax_2026_27 [AU]: Australia, resident for the full 2026-27 year: income tax on taxable income less LITO, plus 2% Medicare levy, plus MLS check; take-home = gross income less those. Facts: gross_income* (number), other_deductions (number, default 0), has_salary
Parameters3
engine
string
required
The engine name, from the list in this description (or start's `engine.name`).
facts
object
required
The engine's facts by name, e.g. {"annual_salary": 60000, "region": "england"}. Amounts are plain numbers in the engine's currency.
reason
string
optional
One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
Raw schema
{
"type": "object",
"properties": {
"engine": {
"type": "string",
"enum": [
"nl_vpb_2026",
"uk_ani_pension_target_2026_27",
"uk_paye_take_home_2026_27",
"ca_income_tax_2026",
"ca_cpp_ei_employee_2026",
"au_sbito_2026_27",
"au_resident_tax_2026_27",
"ie_self_employed_2025_2026",
"ie_income_tax_usc_2026",
"mt_household_comparison_2026",
"mt_income_tax_2026",
"de_est_tariff_2026",
"pt_ss_independent_2026",
"us_federal_income_tax_2026",
"us_se_tax"
],
"description": "The engine name, from the list in this description (or start's `engine.name`)."
},
"facts": {
"type": "object",
"description": "The engine's facts by name, e.g. {\"annual_salary\": 60000, \"region\": \"england\"}. Amounts are plain numbers in the engine's currency.",
"additionalProperties": true
},
"reason": {
"type": "string",
"description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional."
}
},
"required": [
"engine",
"facts"
]
}
share_with_openaccountants
Only when the user asks: sends their feedback, or their request for a person to check or do the work, to OpenAccountants. Two modes. (1) `note`: an anonymized note about the guidance (a gap, a workaround you needed, or via `skill_slug` a bug in a specific skill). Anonymize hard: no names, amounts, or PII. (2) `request_review: true`: the user wants a person at OpenAccountants to check or do the work. Typical requests: 'can an accountant check this?', 'can someone file this for me?', 'can someone do this for me?', 'I want an accountant', 'can I talk to a person?'. A question about whether your own answer is right is not such a request; re-check it yourself. Also requires `working_paper` (complete), `jurisdiction`, `scenario`, and `contact_email`. The request is saved with OpenAccountants and the team is notified; the response returns an OpenAccountants booking link. The call is free. The work itself is paid: OpenAccountants does it through its accountants, with what is done and the fee agreed on the call before anything starts. Never describe the work itself as free. Call at most once per user request; not as a routine closing step.
Parameters9
note
string
required
Anonymized improvement note: what the guidance covered vs what you added or worked around and why, or a bug in a specific skill. No names, amounts, or PII.
skill_slug
string
optional
Optional: set when the note is feedback about a SPECIFIC skill, by its slug (e.g. 'us-sales-tax').
request_review
boolean
optional
true only when the user has asked for a person (an accountant or OpenAccountants) to check their result, file it or do the work. Requires working_paper + jurisdiction + scenario + contact_email. Omit/false = just the note.
jurisdiction
string
optional
Review only: ISO code or slug for the user's tax jurisdiction (e.g. 'US-CA').
scenario
string
optional
Review only: brief description of the situation to review.
contact_email
string
optional
Review only, REQUIRED when request_review: the user's email, so OpenAccountants can reply. Ask for it first.
contact_name
string
optional
Review only: the user's name.
tax_year
integer
optional
Review only: tax year, if relevant.
working_paper
string
optional
Review only: the COMPLETE working paper markdown — every line item and assumption, not a summary.
Raw schema
{
"type": "object",
"properties": {
"note": {
"type": "string",
"description": "Anonymized improvement note: what the guidance covered vs what you added or worked around and why, or a bug in a specific skill. No names, amounts, or PII."
},
"skill_slug": {
"type": "string",
"description": "Optional: set when the note is feedback about a SPECIFIC skill, by its slug (e.g. 'us-sales-tax')."
},
"request_review": {
"type": "boolean",
"description": "true only when the user has asked for a person (an accountant or OpenAccountants) to check their result, file it or do the work. Requires working_paper + jurisdiction + scenario + contact_email. Omit/false = just the note."
},
"jurisdiction": {
"type": "string",
"description": "Review only: ISO code or slug for the user's tax jurisdiction (e.g. 'US-CA')."
},
"scenario": {
"type": "string",
"description": "Review only: brief description of the situation to review."
},
"contact_email": {
"type": "string",
"description": "Review only, REQUIRED when request_review: the user's email, so OpenAccountants can reply. Ask for it first."
},
"contact_name": {
"type": "string",
"description": "Review only: the user's name."
},
"tax_year": {
"type": "integer",
"description": "Review only: tax year, if relevant."
},
"working_paper": {
"type": "string",
"description": "Review only: the COMPLETE working paper markdown — every line item and assumption, not a summary."
}
},
"required": [
"note"
]
}
Tax skills for AI, written from the law and approved by named accountants. Your AI answers tax questions from memory. Add these skills and it answers from the law: every rate, threshold and deadline links to the official page it came from, and each skill says which accountant, if any, has approved it.
34 named accountants approving skills in 28 countries and states · skills for 283 countries, states and territories · every figure linked to its official source
The accountants
A skill shows Approved by [name] only when a licensed accountant read that exact text and approved it from their own GitHub account. If the text changes, the approval is cleared until they approve again. These are the accountants on the record today, by country, read from the skill files themselves:
Country or state
Accountants
Australia
Ryan Duguid
California (US)
DeFiAccountant21
Canada
Khushboo Talreja, Nathan Wiebe
Dominican Republic
Miguel Lantigua
Egypt
Ahmed Hassan
Florida (US)
Rob Hoffman
Georgia
Gvantsa Amiridze
Georgia (US)
Jeff Watts
India
Arshad raza
Indonesia
RILIA PUTRI
Kenya
Julian Njoroge Maina
Malaysia
MUHAMMAD HANIS MAT HUSSIN
Malta
Michael Cutajar, Michael Spiteri Staines
Nepal
Ashish Bista
Nigeria
Omolola Fasasi
Pakistan
Ibrar Ali
Saudi Arabia
Mehran Habib
Serbia
Andrija Eminovic
South Africa
Brandon Iverach, Werner Britz
South Korea
Yeong Min Lee
Spain
Jeff Watts
Sri Lanka
Lal kumarasiri
Tanzania
Baraka Cassian
Tunisia
firas masmoudi
Turkey
Yiğit Çelikel
United Arab Emirates
Jonathan I. Ruiz
United Kingdom
James Power, Nadir Khan
United States (federal)
Anthony Bandura, Christopher Aryee, James Wallach, Vladimir Andjelic
Are you an accountant? Approve the skills for your country and your name appears next to every AI answer that uses them, in ChatGPT, Claude and Cursor. It takes one click from the accountant portal, from your own GitHub account. Found something wrong? Correct it in the same place. Each accountant works under their own licence; OpenAccountants does not sell accountancy services.
Every figure has a source
A tax answer is only as good as the number in it. So every figure in a skill sits in a row that links the official page it came from, and the page can be opened and checked by anyone. A real row, from the Malta VAT skill:
Activity
Registration threshold
Exit threshold
Source
Economic activities consisting principally in the supply of goods
Official sources only. Laws, gazettes and tax authority pages; never blogs or firm summaries.
The figure check. On every pull request, each figure in a rates table is looked for on the page its row links to. A figure that is not there blocks the merge until it is fixed or explained.
The evidence archive. Snapshots of the source pages and the working ledgers behind the skills live in openaccountants/evidence, so a figure can still be traced after a government site changes.
Worked examples that add up. Every skill's examples are recomputed on every pull request.
A named, licensed accountant approved this exact text from their own GitHub account.
Not yet approved
Built from the law and checked before merge, but no accountant has approved it yet.
⚠️ 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.
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.
OsaBooks (AGPL-3.0): Free bookkeeping for businesses, rental properties and households in Australia, New Zealand, South Korea and the United States, with Xero and QuickBooks imports. Use it as a standard bookkeeping platform, or with several AI features: coding suggestions, year-end checks against the OpenAccountants guides, and an MCP connector so Claude, ChatGPT or another AI app can read your books. Runs on your own computer or online on your own Supabase. Home page and demo.
(External tools provide computational review assistance and do not constitute tax or legal advice.)