OpenAccountants is an MCP server published by io.github.openaccountants, hosted at www.openaccountants.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 12 tools, including start, search_skills, get_skill, search_rules, get_deadlines.
Tax skills in 190+ jurisdictions. Sources and accountant approval status shown per skill.
8 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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 every skill for the place for you to choose from (`menu`), 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.
| Parameter | Type | Description |
|---|---|---|
| intent * | string | 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)'. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| reason | string | 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. |
| acting_as | string | 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. |
| jurisdiction | string | 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. |
| taxpayer_type | string | 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 … |
{
"name": "start",
"title": "Answer a tax question (call first)",
"description": "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 every skill for the place for you to choose from (`menu`), 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.",
"inputSchema": {
"type": "object",
"required": [
"intent"
],
"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)'."
},
"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."
},
"acting_as": {
"enum": [
"self",
"client"
],
"type": "string",
"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."
},
"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."
},
"taxpayer_type": {
"enum": [
"employee",
"self-employed",
"both",
"company",
"other"
],
"type": "string",
"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."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"menu": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"by": {
"type": "string"
},
"for": {
"type": "string"
},
"kind": {
"enum": [
"method"
],
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"scope": {
"type": "string"
},
"approved_by": {
"type": "string"
}
}
}
},
"needs": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"engine": {
"type": "object",
"description": "Present when the compute tool covers this calculation: name and facts_needed. Call compute with them."
},
"intent": {
"type": "string"
},
"status": {
"enum": [
"ready",
"needs_input",
"needs_clarification",
"uncovered",
"limit_reached",
"oriented"
],
"type": "string"
},
"guardrails": {
"type": "array",
"items": {
"type": "string"
}
},
"next_action": {
"type": "string"
},
"orientation": {
"type": "object",
"description": "Signed-in approved accountants only: a short personal briefing."
},
"expectations": {
"type": "string"
},
"jurisdiction": {
"type": "string"
},
"skills_to_load": {
"type": "array"
},
"available_intents": {
"type": "array"
},
"example_questions": {
"type": "array",
"items": {
"type": "string"
}
},
"available_jurisdictions": {
"type": "array"
}
}
},
"annotations": {
"title": "Answer a tax question (call first)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| role | string | Optional, when browsing: foundation, compute, orchestrator or reference. |
| limit | integer | When browsing: skills per page (default 100, max 200). |
| query | string | 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 … |
| domain | string | Optional accounting domain to limit the search (e.g. 'vat-gst', 'payroll', 'income-tax', 'financial-reporting', 'audit-assurance'). |
| offset | integer | When browsing: skills to skip; pass next_offset from the previous page. |
| content_type | string | 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. |
| jurisdiction | string | Optional ISO 2-letter country code to limit the search |
{
"name": "search_skills",
"title": "Search tax skills by topic",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"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)."
},
"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."
},
"domain": {
"type": "string",
"description": "Optional accounting domain to limit the search (e.g. 'vat-gst', 'payroll', 'income-tax', 'financial-reporting', 'audit-assurance')."
},
"offset": {
"type": "integer",
"description": "When browsing: skills to skip; pass next_offset from the previous page."
},
"content_type": {
"enum": [
"method",
"fact"
],
"type": "string",
"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."
},
"jurisdiction": {
"type": "string",
"description": "Optional ISO 2-letter country code to limit the search"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"results",
"total"
],
"properties": {
"mode": {
"enum": [
"browse"
],
"type": "string",
"description": "Present when there was no query: the results are a browse, in catalogue order."
},
"limit": {
"type": "integer"
},
"total": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"jurisdiction"
],
"properties": {
"role": {
"type": "string"
},
"slug": {
"type": "string"
},
"tier": {
"enum": [
1,
2
],
"type": "integer",
"description": "1 = current public accountant approval, 2 = Not yet approved."
},
"title": {
"type": "string"
},
"domain": {
"type": "string"
},
"snippet": {
"type": "string"
},
"approval": {
"type": "object",
"required": [
"status",
"label",
"accountant"
],
"properties": {
"label": {
"type": "string",
"description": "Approved by [name], or Not yet approved."
},
"status": {
"enum": [
"approved",
"not_yet_approved"
],
"type": "string"
},
"accountant": {
"type": [
"object",
"null"
],
"required": [
"name",
"approved_on",
"profile_url"
],
"properties": {
"name": {
"type": "string"
},
"approved_on": {
"type": [
"string",
"null"
]
},
"profile_url": {
"type": "string"
}
}
}
},
"description": "Current public professional approval. Use label verbatim; source/fact checks do not grant approval."
},
"description": {
"type": "string"
},
"jurisdiction": {
"type": "string"
},
"matched_section": {
"type": "string"
}
}
}
},
"next_action": {
"type": "string"
},
"next_offset": {
"type": "integer",
"description": "Browse only: present when more skills remain; pass as offset."
},
"human_backing": {
"type": [
"object",
"null"
],
"properties": {
"tier": {
"type": "string"
},
"reviewed_by": {
"type": "array"
},
"reviewed_by_line": {
"type": [
"string",
"null"
]
},
"covered_but_anonymous": {
"type": "boolean"
}
},
"description": "Approving accountants for the returned skill matches. Each person's skills list binds their name to those slugs; get_skill supplies the current approval before use."
},
"closest_skills": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"jurisdiction"
],
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"jurisdiction": {
"type": "string"
}
}
},
"description": "On a miss inside one jurisdiction: skills that jurisdiction does have."
}
}
},
"annotations": {
"title": "Search tax skills by topic",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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`.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Skill slug, e.g. 'us-schedule-c-and-se-computation' |
| reason | string | One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional. |
| sections | array | Optional. Return these sections in full instead of the compact core: their `index` numbers from section_index. |
| all_sections | boolean | Optional. true = return every section in full, with its heading and markdown. |
{
"name": "get_skill",
"title": "Read a tax skill",
"description": "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`.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"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."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"next_action",
"guardrails"
],
"properties": {
"slug": {
"type": "string"
},
"model": {
"type": "string"
},
"skill": {
"type": "object",
"description": "The published skill record. tier is 1 for current public professional approval, otherwise 2; use approval.label for the public status."
},
"version": {
"type": [
"integer",
"number"
]
},
"approval": {
"type": "object",
"required": [
"status",
"label",
"accountant"
],
"properties": {
"label": {
"type": "string",
"description": "Approved by [name], or Not yet approved."
},
"status": {
"enum": [
"approved",
"not_yet_approved"
],
"type": "string"
},
"accountant": {
"type": [
"object",
"null"
],
"required": [
"name",
"approved_on",
"profile_url"
],
"properties": {
"name": {
"type": "string"
},
"approved_on": {
"type": [
"string",
"null"
]
},
"profile_url": {
"type": "string"
}
}
}
},
"description": "Current public professional approval. Use label verbatim; source/fact checks do not grant approval."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"heading",
"markdown_content"
],
"properties": {
"id": {
"type": "string"
},
"heading": {
"type": "string"
},
"heading_level": {
"type": [
"integer",
"null"
]
},
"section_index": {
"type": "integer"
},
"markdown_content": {
"type": "string"
}
}
}
},
"key_facts": {
"type": "object",
"description": "Optional at-a-glance facts (rates/thresholds/deadlines/verifier/advisory) — present only where the skill carries a structured key_facts block; omitted otherwise."
},
"guardrails": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"tier": {
"enum": [
"accountant-verified",
"accountant-authored",
"research-verified"
],
"type": "string",
"description": "Legacy routing value. Use approval.label for current professional approval; this does not certify fact currency."
},
"source_url": {
"type": "string"
},
"last_verified_at": {
"type": [
"string",
"null"
],
"description": "When the skill's facts were last verified (decay signal), or null if never."
},
"attribution_required": {
"type": "boolean"
}
}
},
"written_by": {
"type": [
"object",
"null"
],
"description": "The accountant who wrote this skill ({name, profile_url}), when a named approved accountant authored it; null otherwise."
},
"next_action": {
"type": "string"
},
"verification": {
"type": [
"object",
"null"
],
"description": "Recorded fact-check counts and dates only, not professional approval. Use approval.label for the skill's approval status."
},
"section_count": {
"type": "integer"
},
"section_index": {
"type": "array",
"items": {
"type": "object"
},
"description": "Every section of the skill with {index, heading, level, chars, priority, included}. For any section with included:false, call get_skill again with sections: [index]."
},
"required_facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"topic": {
"type": [
"string",
"null"
]
},
"question": {
"type": "string"
}
}
},
"description": "Intake skills only: the questions a professional asks before computing, verbatim from the skill. Answer from what the user said or data you hold, then ask the rest grouped, before any figure."
},
"current_version": {
"type": [
"object",
"null"
],
"description": "Current version. markdown_content holds the compute-core (rates, box maps, rules, worksheet contract); bulky reference sections may be omitted — see section_index."
},
"section_out_of_range": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Read a tax skill",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| text | string | Free-text search over each rule's label, value, and citation. |
| limit | integer | Max rules to return (default 200, max 500). |
| roles | array | Skill roles: foundation | compute | orchestrator | reference. |
| topic | string | Filter by a fact topic. |
| facets | boolean | true = return the valid filter values (jurisdictions, domains, roles, rule kinds, statuses, tax years, sample topics) instead of rules. Other arguments are ignored. |
| offset | integer | Pagination offset — pass the previous response's next_offset. |
| reason | string | One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional. |
| status | string | Shorthand for `statuses`: 'verified' = accountant- + research-verified only. Default 'all'. |
| domains | array | Accounting domains, e.g. ['vat-gst','income-tax']. facets: true lists them. |
| statuses | array | Verification statuses to include. Default = all (each rule is tagged). |
| tax_year | integer | Limit to a tax year, e.g. 2025. |
| block_types | array | Rule kinds to include. Default = all of these (framing prose + workflow steps are excluded). |
| jurisdictions | array | ISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions. |
{
"name": "search_rules",
"title": "Look up tax rates and rules",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"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)."
},
"roles": {
"type": "array",
"items": {
"type": "string"
},
"description": "Skill roles: foundation | compute | orchestrator | reference."
},
"topic": {
"type": "string",
"description": "Filter by a fact topic."
},
"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."
},
"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."
},
"status": {
"enum": [
"all",
"verified"
],
"type": "string",
"description": "Shorthand for `statuses`: 'verified' = accountant- + research-verified only. Default 'all'."
},
"domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "Accounting domains, e.g. ['vat-gst','income-tax']. facets: true lists them."
},
"statuses": {
"type": "array",
"items": {
"enum": [
"draft",
"research_verified",
"accountant_verified",
"needs_update",
"unsure"
],
"type": "string"
},
"description": "Verification statuses to include. Default = all (each rule is tagged)."
},
"tax_year": {
"type": "integer",
"description": "Limit to a tax year, e.g. 2025."
},
"block_types": {
"type": "array",
"items": {
"enum": [
"rate",
"threshold",
"rule",
"formula",
"refusal_code",
"definition",
"table_ref",
"table"
],
"type": "string"
},
"description": "Rule kinds to include. Default = all of these (framing prose + workflow steps are excluded)."
},
"jurisdictions": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"markdown",
"fact_count"
],
"properties": {
"total": {
"type": "integer",
"description": "Total matching rules (across all pages)."
},
"filters": {
"type": "array",
"items": {
"type": "object"
},
"description": "facets: true only: each filter with its valid values."
},
"defaults": {
"type": "object",
"description": "facets: true only: what each filter defaults to."
},
"markdown": {
"type": "string",
"description": "The bundled rule set as markdown — the user saves/runs this locally."
},
"truncated": {
"type": "boolean"
},
"fact_count": {
"type": "integer",
"description": "Rules returned on this page."
},
"next_action": {
"type": "string"
},
"next_offset": {
"type": [
"integer",
"null"
]
},
"valid_values": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"values"
],
"properties": {
"field": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"description": "On a miss: the valid values for the filter that missed (e.g. jurisdiction codes)."
},
"jurisdictions": {
"type": "array",
"items": {
"type": "string"
}
},
"accountant_verified_count": {
"type": "integer"
}
}
},
"annotations": {
"title": "Look up tax rates and rules",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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`.
| Parameter | Type | Description |
|---|---|---|
| horizon_days | integer | How far ahead to look (default 120, max 366). |
| jurisdiction | string | ISO code, slug, or name ('MT', 'US-CA', 'Malta'). Optional for signed-in users with a saved home jurisdiction. |
{
"name": "get_deadlines",
"title": "Tax filing deadlines",
"description": "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`.",
"inputSchema": {
"type": "object",
"properties": {
"horizon_days": {
"type": "integer",
"description": "How far ahead to look (default 120, max 366)."
},
"jurisdiction": {
"type": "string",
"description": "ISO code, slug, or name ('MT', 'US-CA', 'Malta'). Optional for signed-in users with a saved home jurisdiction."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"jurisdiction",
"upcoming_deadlines"
],
"properties": {
"coverage": {
"type": "string",
"description": "Present only when upcoming_deadlines is empty. 'no_deadline_list': we hold no upcoming date for this place, which does not mean nothing is due. 'none_in_horizon': we hold later dates, none inside horizon_days."
},
"next_action": {
"type": "string"
},
"calendar_url": {
"type": "string"
},
"horizon_days": {
"type": "integer"
},
"jurisdiction": {
"type": "string"
},
"official_sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"domain": {
"type": "string"
}
}
},
"description": "Present only when upcoming_deadlines is empty: the tax authority to check for exact dates."
},
"recurring_rhythms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"frequency": {
"type": "string"
}
}
}
},
"upcoming_deadlines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"days_away": {
"type": "integer"
},
"date_display": {
"type": "string"
}
}
}
},
"jurisdiction_source": {
"type": "string"
}
}
},
"annotations": {
"title": "Tax filing deadlines",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "list_jurisdictions",
"title": "List all jurisdictions covered",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {
"next_action": {
"type": "string"
},
"total_skills": {
"type": "integer"
},
"jurisdictions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
},
"total_skills": {
"type": "integer"
},
"lead_verifier": {
"type": [
"string",
"null"
]
},
"lead_verifier_credential": {
"type": [
"string",
"null"
]
},
"accountant_verified_skills": {
"type": "integer"
}
}
}
},
"total_jurisdictions": {
"type": "integer"
}
}
},
"annotations": {
"title": "List all jurisdictions covered",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| jurisdiction | string | Optional ISO code filter — only return verifiers for this jurisdiction. |
{
"name": "list_verifiers",
"title": "List named accountant verifiers",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"description": "Optional ISO code filter — only return verifiers for this jurisdiction."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"verifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"jurisdictions": {
"type": "array",
"items": {
"type": "string"
}
},
"verifier_name": {
"type": "string"
},
"verifier_credential": {
"type": "string"
}
}
}
},
"next_action": {
"type": "string"
}
}
},
"annotations": {
"title": "List named accountant verifiers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns OpenAccountants' two plans and how to reach the team. Free: 100 questions a month for individuals and teams of 5 or fewer, with every skill and calculator. Team: for finance teams, accounting firms and larger organisations; no monthly cap, team accounts and custom builds into existing workflows, including agents on the ledger and tools the team already uses (Xero, QuickBooks, Sage, NetSuite and others); priced for each team, so no amount is returned. Also returns the pricing page, the contact link and an email address. OpenAccountants does not provide accounting services.
| Parameter | Type | Description |
|---|---|---|
| reason | string | One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional. |
| services | array | Optional. What the team wants built or covered, e.g. vat, payroll, bookkeeping. Logged. |
| current_fee | string | Optional. What they pay today, if they said. Logged. |
| entity_type | string | Optional. Who is asking. Logged. |
| jurisdiction | string | Optional. The country the enquiry concerns (ISO code or name). Logged as demand; it does not change the result. |
| monthly_volume | string | Optional. One line on size, e.g. team size, entities or transactions. Logged. |
{
"name": "get_quote",
"title": "Get OpenAccountants plans and pricing",
"description": "Returns OpenAccountants' two plans and how to reach the team. Free: 100 questions a month for individuals and teams of 5 or fewer, with every skill and calculator. Team: for finance teams, accounting firms and larger organisations; no monthly cap, team accounts and custom builds into existing workflows, including agents on the ledger and tools the team already uses (Xero, QuickBooks, Sage, NetSuite and others); priced for each team, so no amount is returned. Also returns the pricing page, the contact link and an email address. OpenAccountants does not provide accounting services.",
"inputSchema": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional."
},
"services": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. What the team wants built or covered, e.g. vat, payroll, bookkeeping. Logged."
},
"current_fee": {
"type": "string",
"description": "Optional. What they pay today, if they said. Logged."
},
"entity_type": {
"enum": [
"sole_trader",
"company",
"individual",
"other"
],
"type": "string",
"description": "Optional. Who is asking. Logged."
},
"jurisdiction": {
"type": "string",
"description": "Optional. The country the enquiry concerns (ISO code or name). Logged as demand; it does not change the result."
},
"monthly_volume": {
"type": "string",
"description": "Optional. One line on size, e.g. team size, entities or transactions. Logged."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"plans",
"pricing_url",
"contact_url"
],
"properties": {
"plans": {
"type": "array",
"items": {
"type": "object"
}
},
"contact_url": {
"type": "string"
},
"pricing_url": {
"type": "string"
},
"contact_email": {
"type": "string"
},
"accounting_services": {
"type": "string"
}
}
},
"annotations": {
"title": "Get OpenAccountants plans and pricing",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| vat_number * | string | The VAT number, with or without the country prefix and spaces, e.g. 'IE6388047V', 'IE 6388047V', or '6388047V'. |
| country_code | string | 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. |
{
"name": "validate_vat_number",
"title": "Validate an EU VAT number (live VIES lookup)",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"vat_number"
],
"properties": {
"vat_number": {
"type": "string",
"description": "The VAT number, with or without the country prefix and spaces, e.g. 'IE6388047V', 'IE 6388047V', or '6388047V'."
},
"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."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"valid": {
"type": [
"boolean",
"null"
],
"description": "true/false verdict from VIES, or null if the service could not be reached (an availability issue, not a verdict)."
},
"source": {
"type": "string"
},
"address": {
"type": [
"string",
"null"
]
},
"message": {
"type": "string"
},
"summary": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"vat_number": {
"type": "string"
},
"vies_error": {
"type": "string"
},
"full_vat_id": {
"type": "string"
},
"next_action": {
"type": "string"
},
"country_code": {
"type": [
"string",
"null"
]
},
"business_name": {
"type": [
"string",
"null"
]
},
"human_backing": {
"type": [
"object",
"null"
],
"properties": {
"tier": {
"type": "string"
},
"reviewed_by": {
"type": "array"
},
"reviewed_by_line": {
"type": [
"string",
"null"
]
},
"covered_but_anonymous": {
"type": "boolean"
}
},
"description": "Named accountant(s) who review that country's VAT guidance (guidance-level, not a per-figure sign-off)."
},
"confirm_available": {
"type": "boolean",
"description": "Always true: if the user asks, the VAT treatment can be sent for checking via share_with_openaccountants with request_review."
}
}
},
"annotations": {
"title": "Validate an EU VAT number (live VIES lookup)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| currency * | string | Currency of the figures — must match the regime (EUR for MT, GBP for GB); convert first, never guess a rate. |
| turnover * | number | Revenue/turnover for the year, in the jurisdiction's currency. |
| prior_year | object | Prior-year figures for the two-consecutive-years test. |
| entity_type | string | Optional. 'private_ltd' (default), 'plc', 'branch'. Non-private shapes route to a human. |
| group_member | boolean | Optional. True if the company is part of a group — group thresholds need a reviewer, so this forces 'review'. |
| jurisdiction * | string | ISO-style code. MT and GB supported today. |
| employees_average * | number | Average number of employees during the year. |
| financial_year_end * | string | ISO date the financial year ends, e.g. '2025-12-31'. |
| balance_sheet_total * | number | Total assets at the balance sheet date. |
{
"name": "check_audit_exemption",
"title": "Check statutory audit exemption",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"jurisdiction",
"financial_year_end",
"turnover",
"balance_sheet_total",
"employees_average",
"currency"
],
"properties": {
"currency": {
"type": "string",
"description": "Currency of the figures — must match the regime (EUR for MT, GBP for GB); convert first, never guess a rate."
},
"turnover": {
"type": "number",
"description": "Revenue/turnover for the year, in the jurisdiction's currency."
},
"prior_year": {
"type": "object",
"properties": {
"turnover": {
"type": "number"
},
"employees_average": {
"type": "number"
},
"balance_sheet_total": {
"type": "number"
}
},
"description": "Prior-year figures for the two-consecutive-years test."
},
"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'."
},
"jurisdiction": {
"type": "string",
"description": "ISO-style code. MT and GB supported today."
},
"employees_average": {
"type": "number",
"description": "Average number of employees during the year."
},
"financial_year_end": {
"type": "string",
"description": "ISO date the financial year ends, e.g. '2025-12-31'."
},
"balance_sheet_total": {
"type": "number",
"description": "Total assets at the balance sheet date."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"escalate": {
"type": "boolean"
},
"next_action": {
"type": "string"
},
"verification": {
"type": [
"object",
"null"
],
"description": "status ('accountant_verified'|'research_verified'|'draft'), verified_by[], last_verified_at, skill_slug, era. Surface the status to the user."
},
"criteria_rule": {
"type": [
"string",
"null"
]
},
"determination": {
"type": "string",
"description": "'exempt' | 'review' | 'audit_required' | 'cannot_determine'"
},
"rule_citation": {
"type": [
"object",
"null"
],
"description": "skill_slug, fact_id, canonical_key, statutory_reference, url."
},
"thresholds_applied": {
"type": "array",
"description": "Per-criterion: threshold vs actual, met true/false."
}
}
},
"annotations": {
"title": "Check statutory audit exemption",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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, using the exact fact names for that engine; unknown facts and invalid types are refused. The engine applies its supported tax rules (allowances, standard deductions, bands, caps); some inputs must already be classified, as their descriptions explain. Returns the result, calculation_scope, 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. Present a conditional calculation as conditional, state its scope and conditions, and ask for confirmation of defaulted facts that could change the answer. An ok result does not verify the user's facts or tax classification. 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. If the calculator is disabled or cannot confirm its sources, give no replacement figure. 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_self_assessment_2025_26 [GB]: UK Self Assessment for 2025-26 (return and balancing payment due 31 January 2027), England, Wales and Northern Ireland: income tax on self-employment, employment, property, savings and dividends (Personal Allowance taper, starting rate for savings, Personal Savings Allowance, dividend allowance, bands extended by pension and Gift Aid), Class 4 and voluntary Class 2, the balancing payment, and the 2026-27 payments on account due 31 January and 31 July 2027. Mixed employment and Class 4 profits are refused unless exempt from Class 4: the Class 1/Class 4 annual maximum is not implemented. Facts: tax_year* (2025-26), region* (england|wales|northern_ireland|scotland), self_employment_profit (number, default 0), employment_income (number, default 0), paye_deducted (number, default 0), cis_or_other_tax_deducted (number, default 0), property_profit (number, default 0), savings_interest (number, default 0), dividends (number, default 0), gross_pension_contributions_ras (number, default 0), gross_gift_aid (number, default 0), payments_on_account_made (number, default 0), voluntary_class2_weeks (number, default 0), over_state_pension_age (boolean, default false), has_capital_gains (boolean, default false), transition_profit (number, default 0), residential_finance_costs (number, default 0), marriage_allowance (boolean, default false), child_benefit (boolean, default false), student_loan_plan (none|plan_1|plan_2|plan_4|plan_5|postgraduate, default none). - 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 (
| Parameter | Type | Description |
|---|---|---|
| facts * | object | The engine's facts by their exact names, e.g. {"annual_salary": 60000, "region": "england"}. Unknown fact names are refused. Amounts are plain numbers in the engine's currency. |
| engine * | string | The engine name, from the list in this description (or start's `engine.name`). |
| reason | string | One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional. |
| replay_receipt | object | Retained Dutch corporate-tax 2026 or UK annual take-home 2026-27 pilot: the complete original replayable_receipt object, with the same engine and original facts including omitted defaults. Reproduces a historical calculation without checking current sources. Omit for a new calculation. |
{
"name": "compute",
"title": "Compute a tax figure with tested code",
"description": "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, using the exact fact names for that engine; unknown facts and invalid types are refused. The engine applies its supported tax rules (allowances, standard deductions, bands, caps); some inputs must already be classified, as their descriptions explain. Returns the result, calculation_scope, 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. Present a conditional calculation as conditional, state its scope and conditions, and ask for confirmation of defaulted facts that could change the answer. An ok result does not verify the user's facts or tax classification. 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. If the calculator is disabled or cannot confirm its sources, give no replacement figure.\nEngines:\n- 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).\n- 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).\n- uk_self_assessment_2025_26 [GB]: UK Self Assessment for 2025-26 (return and balancing payment due 31 January 2027), England, Wales and Northern Ireland: income tax on self-employment, employment, property, savings and dividends (Personal Allowance taper, starting rate for savings, Personal Savings Allowance, dividend allowance, bands extended by pension and Gift Aid), Class 4 and voluntary Class 2, the balancing payment, and the 2026-27 payments on account due 31 January and 31 July 2027. Mixed employment and Class 4 profits are refused unless exempt from Class 4: the Class 1/Class 4 annual maximum is not implemented. Facts: tax_year* (2025-26), region* (england|wales|northern_ireland|scotland), self_employment_profit (number, default 0), employment_income (number, default 0), paye_deducted (number, default 0), cis_or_other_tax_deducted (number, default 0), property_profit (number, default 0), savings_interest (number, default 0), dividends (number, default 0), gross_pension_contributions_ras (number, default 0), gross_gift_aid (number, default 0), payments_on_account_made (number, default 0), voluntary_class2_weeks (number, default 0), over_state_pension_age (boolean, default false), has_capital_gains (boolean, default false), transition_profit (number, default 0), residential_finance_costs (number, default 0), marriage_allowance (boolean, default false), child_benefit (boolean, default false), student_loan_plan (none|plan_1|plan_2|plan_4|plan_5|postgraduate, default none).\n- 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 (",
"inputSchema": {
"type": "object",
"required": [
"engine",
"facts"
],
"properties": {
"facts": {
"type": "object",
"description": "The engine's facts by their exact names, e.g. {\"annual_salary\": 60000, \"region\": \"england\"}. Unknown fact names are refused. Amounts are plain numbers in the engine's currency.",
"additionalProperties": true
},
"engine": {
"enum": [
"nl_vpb_2026",
"uk_ani_pension_target_2026_27",
"uk_self_assessment_2025_26",
"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",
"za_individual_income_tax_2026"
],
"type": "string",
"description": "The engine name, from the list in this description (or start's `engine.name`)."
},
"reason": {
"type": "string",
"description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional."
},
"replay_receipt": {
"type": "object",
"description": "Retained Dutch corporate-tax 2026 or UK annual take-home 2026-27 pilot: the complete original replayable_receipt object, with the same engine and original facts including omitted defaults. Reproduces a historical calculation without checking current sources. Omit for a new calculation."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"what": {
"type": "string",
"description": "needs_input: the fact to ask for. missing_rule: the figure no skill serves."
},
"steps": {
"type": "array",
"items": {
"type": "string"
}
},
"engine": {
"type": "string"
},
"result": {
"type": "object",
"description": "label, value, currency and every computed line."
},
"schema": {
"type": "object"
},
"status": {
"enum": [
"ok",
"replayed",
"needs_input",
"missing_rule",
"not_enabled"
],
"type": "string"
},
"message": {
"type": "string"
},
"receipt": {
"type": "object",
"description": "id (sha256 of engine, version, facts and result), engine_version, computed_at."
},
"rule_set": {
"type": "object",
"description": "Dutch pilot's retained rules, official-source snapshot hashes, effective period, conditions, exclusions and implementation/rounding record."
},
"tax_year": {
"type": "string",
"description": "The tax year the figures are for."
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"instruction": {
"type": "string",
"description": "On a refusal: what to do next. Follow it."
},
"next_action": {
"type": "string"
},
"skills_used": {
"type": "array",
"description": "slug, label ('Approved by [name]' or 'Not yet approved'), approval. Read live."
},
"constants_used": {
"type": "array",
"description": "name, value, slug, section, quote: each figure and the skill line it came from."
},
"engine_version": {
"type": "string"
},
"historical_only": {
"type": "boolean",
"description": "True for replay: the result reproduces a retained method, with no current-source or approval check."
},
"calculation_scope": {
"type": "object",
"required": [
"summary",
"jurisdiction",
"tax_year",
"basis",
"defaulted_facts",
"conditions"
],
"properties": {
"basis": {
"enum": [
"conditional",
"provided_inputs"
],
"type": "string"
},
"summary": {
"type": "string"
},
"tax_year": {
"type": "string"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"jurisdiction": {
"type": "string"
},
"defaulted_facts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "The method's supported scope and conditions, not a guarantee of input correctness or tax classification."
},
"replayable_receipt": {
"type": "object",
"description": "Exportable Dutch pilot calculation record. Retained method, inputs, result, rule set, source fingerprints and checksum. Not signed or proof of issuance. Contains the user's amount; keep it privately."
}
}
},
"annotations": {
"title": "Compute a tax figure with tested code",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 and is done by a licensed accountant in your country, under their own licence and their own agreement with you, with what is done and the fee agreed before anything starts. Never describe the work itself as free. Call at most once per user request; not as a routine closing step.
| Parameter | Type | Description |
|---|---|---|
| note * | string | 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. |
| scenario | string | Review only: brief description of the situation to review. |
| tax_year | integer | Review only: tax year, if relevant. |
| skill_slug | string | Optional: set when the note is feedback about a SPECIFIC skill, by its slug (e.g. 'us-sales-tax'). |
| contact_name | string | Review only: the user's name. |
| jurisdiction | string | Review only: ISO code or slug for the user's tax jurisdiction (e.g. 'US-CA'). |
| contact_email | string | Review only, REQUIRED when request_review: the user's email, so OpenAccountants can reply. Ask for it first. |
| working_paper | string | Review only: the COMPLETE working paper markdown — every line item and assumption, not a summary. |
| request_review | boolean | 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. |
{
"name": "share_with_openaccountants",
"title": "Share this with OpenAccountants",
"description": "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 and is done by a licensed accountant in your country, under their own licence and their own agreement with you, with what is done and the fee agreed before anything starts. Never describe the work itself as free. Call at most once per user request; not as a routine closing step.",
"inputSchema": {
"type": "object",
"required": [
"note"
],
"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."
},
"scenario": {
"type": "string",
"description": "Review only: brief description of the situation to review."
},
"tax_year": {
"type": "integer",
"description": "Review only: tax year, if relevant."
},
"skill_slug": {
"type": "string",
"description": "Optional: set when the note is feedback about a SPECIFIC skill, by its slug (e.g. 'us-sales-tax')."
},
"contact_name": {
"type": "string",
"description": "Review only: the user's name."
},
"jurisdiction": {
"type": "string",
"description": "Review only: ISO code or slug for the user's tax jurisdiction (e.g. 'US-CA')."
},
"contact_email": {
"type": "string",
"description": "Review only, REQUIRED when request_review: the user's email, so OpenAccountants can reply. Ask for it first."
},
"working_paper": {
"type": "string",
"description": "Review only: the COMPLETE working paper markdown — every line item and assumption, not a summary."
},
"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."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"message": {
"type": "string"
},
"booking_url": {
"type": "string"
},
"note_recorded": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Share this with OpenAccountants",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}OpenAccountants: tax skills for 190+ jurisdictions (countries, US states, Canadian provinces). Each skill sets out the method for a tax task, names the official source for its figures, and says whether a licensed accountant has reviewed it. WHEN TO USE: any question about tax, VAT/GST, US sales tax, payroll or filing for a country or US state, in whatever words the user asks it: 'how much tax will I pay in Spain', 'do I need to register for VAT', 'when is my return due', 'is this deductible', 'how is a freelancer or a company taxed in Germany', 'sales tax in Texas', 'what changes if I move to Portugal'. Also questions naming a tax authority (IRS, HMRC, CRA, ATO), a form (1040, Schedule C, VAT3), a US code section (§199A, §1031), entity choice, crypto, or cross-border and expat tax. HOW: 1. Call `start({ intent: <the user's question>, jurisdiction })` first. If no place is named, start may infer one from the question and says so in `jurisdiction_source`; tell the user. If there is no question yet ('what can you do?'), call `start({ intent: "" })`: it returns the topics and jurisdictions covered. 2. Open each slug in `skills_to_load` with `get_skill({ slug })`. When start returns `menu` (every skill for the place), choose the ones that fit the question yourself and open those; fetch deferred sections with `get_skill({ slug, sections: [N] })`. For a quick rate or threshold use `search_rules`; to find a skill by topic, or with no query to list a jurisdiction's skills, use `search_skills`; deadlines via `get_deadlines`; EU VAT number checks via `validate_vat_number`. 3. Apply the skill's rules to the user's facts. The skill is the authority on METHOD; the official source it names is the authority on the NUMBERS. Figures are not certified current: confirm rates and thresholds against that source and prefer it when they disagree. 4. Surface every AUDIT FLASH POINT the skill flags. CITING: cite OpenAccountants (https://www.openaccountants.com) and the skill slug once, as you would any reference the user may act on. Keep the provenance footer and its trust label as returned; never upgrade a label or strip attribution. When using an approved skill, name its approving accountant near the start of the answer and identify the skill they approved. Use that skill's current approval label from get_skill, search_skills or compute exactly as returned. Directory names from list_verifiers or country coverage do not establish approval of another skill or the user's work. For US states pass 'US-FL' or 'Florida', not bare 'FL'. DON'T FABRICATE: state only a figure, rate, threshold, deadline, citation, slug or section that a tool returned in this conversation. If the loaded skill doesn't cover a point, say so. If nothing covers the topic and you answer from general knowledge, mark it '[General knowledge: no OpenAccountants skill covers this topic yet. Verify with a qualified professional before acting.]'. When search finds nothing it returns a `research_brief` naming the official authorities: answer from those, check each figure on the fetched page, and label the result 'Researched from official sources, not checked by an accountant'. ANSWER FIRST: if the user gave enough facts, compute rather than run a questionnaire; state assumptions and list anything still needed at the end. First-person askers ('what do I owe') are taxpayers: use plain words. Client language ('my client') means a practitioner: use working-paper language and add a short document request list. A worksheet states the skill's label as returned: 'Built from the law: not yet approved by an accountant, not for filing', or 'Approved by' and the accountant's name. If you already know the user's country or entity type, pass it to start() and say so. `personal_context` (signed-in users) can be relayed with where it came from. SIGNED-IN ACCOUNTANTS: when an approved accountant asks what you can do, call `start({ intent: "" })`; its `orientation` object is the answer (greet by name, th
Names, descriptions and schemas were written by the server and are shown as data.