MCP Server
OpenAccountants
io.github.openaccountants/openaccountants
What this MCP does
Provides jurisdiction-specific tax and accounting skills, deadlines, rule searches, audit exemption checks, and VAT number validation.
Capabilities
Tools
14
tools
check_audit_exemption
Check statutory audit exemption (deterministic, cited, verified)
DETERMINISTIC check of whether a private limited company qualifies for statutory audit exemption, from aggregate figures any ledger can provide (turnover, balance sheet total, average employees). Returns a determination ('exempt' | 'review' | 'audit_required' | 'cannot_determine'), the per-criterion threshold table showing exactly why, the canonical rule citation it rests on, and the LIVE verification envelope (whether a named accountant has attested the thresholds — surface that status prominently; 'draft' means treat as a source-cited draft). COVERAGE TODAY: MT (Article 185(2) micro thresholds) and GB (small-company thresholds, both pre and post 6 April 2025 eras). Most exemption regimes are two-consecutive-years tests, so pass prior_year figures when available — without them a qualifying year returns 'review', not 'exempt'; that is correct behaviour, not an error. 'cannot_determine' is a first-class outcome (unsupported jurisdiction, wrong currency, entity shapes needing judgment, or the cited fact changed since calibration). Never override the determination with training-data thresholds.
Read only
Idempotent
Input schema
{'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.'}}}
Output schema
{'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.'}}}
get_deadlines
Upcoming tax deadlines for a jurisdiction
Upcoming filing/payment deadlines and recurring filing rhythms (monthly VAT, quarterly instalments) for a country or US state, from the OpenAccountants tax calendar. Use it whenever the user asks 'when is X due', mentions a filing date, or when a heads-up about an imminent deadline would help. Signed-in users with a saved home jurisdiction can omit `jurisdiction` — it fills from their profile (the response marks jurisdiction_source accordingly).
Read only
Idempotent
Input schema
{'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."}}}
Output schema
{'type': 'object', 'required': ['jurisdiction', 'upcoming_deadlines'], 'properties': {'next_action': {'type': 'string'}, 'calendar_url': {'type': 'string'}, 'horizon_days': {'type': 'integer'}, 'jurisdiction': {'type': 'string'}, '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'}}}
get_skill
Get a tax skill
Fetch a published skill by slug, including its current-version markdown, quality tier, named verifier (where accountant-verified), and a provenance/attribution footer.
Read only
Idempotent
Input schema
{'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."}}}
Output schema
{'type': 'object', 'required': ['skill', 'provenance'], 'properties': {'skill': {'type': 'object', 'description': 'The skill record (slug, name, jurisdiction, tier, etc.)'}, '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', 'research-verified'], 'type': 'string'}, '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'}}}, 'next_action': {'type': 'string'}, 'verification': {'type': ['object', 'null'], 'description': 'Verification summary'}, '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, fetch it via get_skill_sections({slug, section_index}).'}, '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.'}}}
get_skill_sections
Get a skill's sections
Fetch the parsed sections of a skill's current version. Each section has a heading and its markdown content. Use this to pull a specific section that get_skill listed in `section_index` as not inlined (e.g. a supplier-pattern library) — pass `section_index` to fetch just that one. Omit it to get every section.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Skill slug'}, 'section_index': {'type': 'integer', 'description': "Optional. Return only this section (matches the `index` from get_skill's `section_index`)."}, 'section_indices': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Optional. Return only these sections.'}}}
Output schema
{'type': 'object', 'required': ['slug', 'sections'], 'properties': {'slug': {'type': 'string'}, 'version': {'type': ['integer', 'number']}, '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 — present only where the skill carries a structured key_facts block; omitted otherwise.'}, 'guardrails': {'type': 'array', 'items': {'type': 'string'}}, 'next_action': {'type': 'string'}}}
list_jurisdictions
List all jurisdictions covered
Returns every jurisdiction with published skills — countries (ISO 2), US states (US-XX), Canadian provinces — with skill counts, accountant-verified counts, and named lead verifier. Use when the user asks 'which countries does OpenAccountants cover?' or 'what's available for [country]?' Avoids paginating through list_skills to compute this.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'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'}}}
list_rule_facets
List queryable rule facets (no args)
Returns the metadata you can filter on with `search_rules` — the live jurisdictions, the domains, roles, block types (rule kinds), statuses, tax years, and a sample of topics — plus the defaults. Call this before `search_rules` to learn the valid filter values rather than guessing.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'properties': {'filters': {'type': 'array', 'items': {'type': 'object', 'properties': {'kind': {'type': 'string'}, 'field': {'type': 'string'}, 'multi': {'type': 'boolean'}, 'values': {'type': 'array'}}}}, 'defaults': {'type': 'object'}, 'next_action': {'type': 'string'}}}
list_skills
List tax & accounting skills
List published OpenAccountants skills with their quality tier and verification status. Optionally filter by jurisdiction (e.g. 'US', 'MT', 'DE', 'GB'), domain (the accounting area, e.g. 'vat-gst', 'payroll', 'income-tax'), or role ('foundation' | 'compute' | 'orchestrator' | 'reference'). Results are paginated (default 100, max 200 per call) — unfiltered browsing of the full ~1,100-skill catalogue requires paging via offset/next_offset, so jurisdiction/domain filters are strongly recommended.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'role': {'type': 'string', 'description': 'Filter by pipeline role: foundation, compute, orchestrator, reference.'}, 'limit': {'type': 'integer', 'description': 'Max skills to return (default 100, max 200).'}, 'domain': {'type': 'string', 'description': 'Filter by accounting domain: income-tax, vat-gst, payroll, bookkeeping, e-invoicing, formation, financial-statements, transfer-pricing, tax-optimization, crypto, cross-border, corporate-tax, estate-wealth-tax, references, sector-guidance, tooling.'}, 'offset': {'type': 'integer', 'description': 'Number of skills to skip — use the next_offset from the previous response to page through results (default 0).'}, 'category': {'type': 'string', 'description': '(Legacy) display label; prefer domain/role.'}, 'jurisdiction': {'type': 'string', 'description': "Filter by jurisdiction code, e.g. 'US', 'MT', 'DE'"}}}
Output schema
{'type': 'object', 'required': ['skills'], 'properties': {'limit': {'type': 'integer', 'description': 'Page size applied to this response.'}, 'total': {'type': 'integer', 'description': 'Total skills matching the filter (across all pages).'}, 'offset': {'type': 'integer', 'description': 'Offset applied to this response.'}, 'skills': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'tier', 'jurisdiction'], 'properties': {'name': {'type': 'string'}, 'role': {'type': ['string', 'null'], 'description': 'Pipeline role facet'}, 'slug': {'type': 'string'}, 'tier': {'type': 'integer', 'description': '1 = accountant-verified, 2 = research-verified'}, 'domain': {'type': ['string', 'null'], 'description': 'Accounting domain facet'}, 'category': {'type': 'string'}, 'description': {'type': ['string', 'null']}, 'jurisdiction': {'type': 'string'}, 'verification': {'type': 'object', 'description': 'Verification status summary'}, 'display_order': {'type': ['integer', 'null']}}}, 'description': 'Matching published skills.'}, 'next_action': {'type': 'string'}, 'next_offset': {'type': 'integer', 'description': 'Present when more results remain — pass as offset to fetch the next page.'}}}
list_verifiers
List named accountant verifiers
Returns named licensed accountants who have signed off on OpenAccountants jurisdictions, with their credentials and covered jurisdictions. Use when the user asks who verified a skill or wants to see the verifier network. If the user wants one of them to review their work, that goes through `share_with_openaccountants` with `request_review: true` — at the user's explicit request only.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'jurisdiction': {'type': 'string', 'description': 'Optional ISO code filter — only return verifiers for this jurisdiction.'}}}
Output schema
{'type': 'object', 'properties': {'total': {'type': 'integer'}, 'verifiers': {'type': 'array', 'items': {'type': 'object', 'properties': {'role': {'type': 'string'}, 'calendly_url': {'type': 'string'}, 'jurisdictions': {'type': 'array', 'items': {'type': 'string'}}, 'verifier_name': {'type': 'string'}, 'verifier_credential': {'type': 'string'}}}}, 'next_action': {'type': 'string'}}}
search_rules
Search rules across jurisdictions
Sweep tax rules ACROSS jurisdictions and metadata and get back a bundled markdown rule set plus the jurisdiction's OFFICIAL SOURCE. Best for cross-cutting questions — 'VAT rates in MT, IE and DE', 'all income-tax thresholds for 2025', 'rules mentioning reverse charge'. WHEN YOU WANT ONE SPECIFIC FIGURE for one jurisdiction (a single rate, threshold or date), prefer `search_skills` then `get_skill`: the Guide is where a topic is covered in full, and a figure can exist in the Guide without existing as a separate rule here, in which case this tool will return related guidance rather than the number you asked for. Entries whose text is guidance rather than a value are tagged `GUIDANCE` — never read one as a figure. IMPORTANT: this returns human-reviewed GUIDANCE and does NOT certify that a figure is current — confirm each number against the official source returned in `official_source` before you state it, and prefer that source when they disagree. By default returns ALL matching rules, each tagged with its verification status; pass status:'verified' for accountant-/research-verified only. Call `list_rule_facets` first to see the queryable values.
Read only
Idempotent
Input schema
{'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.'}, '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']. See list_rule_facets."}, '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."}}}
Output schema
{'type': 'object', 'required': ['markdown', 'fact_count'], 'properties': {'total': {'type': 'integer', 'description': 'Total matching rules (across all pages).'}, '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']}, 'jurisdictions': {'type': 'array', 'items': {'type': 'string'}}, 'accountant_verified_count': {'type': 'integer'}}}
search_skills
Search skills by keyword
Full-text search across all published tax and accounting skills. Find, lookup, query, or discover skills by keyword, tax concept, deduction type, form number, or regulation (e.g. 'home office deduction', 'crypto capital gains', 'reverse charge', 'Schedule C', '60-day reporting'). Optionally limit to one jurisdiction. Use this when you don't know the exact skill slug. Set content_type='method' to discover step-by-step METHODS (guided procedures — what you EXECUTE via start()) instead of reference material; each method carries a review_status (accountant-reviewed | source-cited).
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Search term, e.g. 'home office deduction', 'crypto capital gains', 'reverse charge'. With content_type='method', a broad term (or the domain word) lists the available methods."}, 'domain': {'type': 'string', 'description': "Optional accounting domain to limit the search (e.g. 'vat-gst', 'payroll', 'income-tax', 'crypto')."}, 'content_type': {'enum': ['method', 'fact'], 'type': 'string', 'description': "What kind of Guide to find. 'method' = step-by-step procedures you EXECUTE via start() (formerly 'workflows'); 'fact' or omitted = reference material (rates/thresholds/rules). A Guide can be either or both."}, 'jurisdiction': {'type': 'string', 'description': 'Optional ISO 2-letter country code to limit the search'}}}
Output schema
{'type': 'object', 'required': ['results', 'total'], 'properties': {'total': {'type': 'integer'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'jurisdiction'], 'properties': {'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'snippet': {'type': 'string'}, 'jurisdiction': {'type': 'string'}, 'matched_section': {'type': 'string'}}}}, 'next_action': {'type': 'string'}, '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 this jurisdiction's guidance (guidance-level, not a per-figure sign-off)."}}}
share_with_openaccountants
Share this with OpenAccountants
Sends feedback or a review request to OpenAccountants. This is the single outbound channel; it does nothing unless the user has explicitly asked to send feedback or to request a review. 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` — submits the user's working paper for review by a licensed accountant; also requires `working_paper` (complete), `jurisdiction`, `scenario`, and `contact_email`. The review is a paid professional engagement (never describe it as free); the request is saved to the user's own queue and the response returns a booking link — nothing reaches an accountant until the user engages. Call at most once per explicit user request; never call as a routine closing step, and never solicit the request.
Destructive
Input schema
{'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 (e.g. 'us-sales-tax'). Replaces the old submit_feedback."}, '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. 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 licensed accountant to review their figures. Requires working_paper + jurisdiction + scenario + contact_email. Omit/false = just the note.'}}}
Output schema
{'type': 'object', 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'booking_url': {'type': 'string'}, 'note_recorded': {'type': 'boolean'}}}
start
Start a tax workflow
Front door for any tax / accounting question once you know what the user wants. `intent` is REQUIRED (e.g. 'taxes', 'VAT return', 'set up a company', 'find deductions', 'classify transactions', 'payroll'); pass a jurisdiction too (ISO 2-letter, e.g. 'MT', 'GB', 'US-CA'). If you don't yet have an intent, call `start_help` first. Returns either a clarification request (if jurisdiction is missing) or a ready-to-execute plan with the list of skills to load. Call this FIRST (after start_help if needed) whenever the user asks for tax help.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['intent'], 'properties': {'intent': {'type': 'string', 'description': "User intent — REQUIRED. Free text, e.g. 'taxes', 'VAT return', 'set up a company'."}, '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': "REQUIRED. Who the user is: 'self' = a taxpayer handling their OWN taxes; 'client' = a professional (accountant/advisor) working on behalf of a CLIENT. Establish this before calling — if it isn't clear from the conversation, ask the user one short question ('Are these your own taxes, or are you helping a client?'). Never guess."}, 'jurisdiction': {'type': 'string', 'description': "ISO 2-letter code or US state code (e.g. 'MT', 'GB', 'US-CA')."}, '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."}}}
Output schema
{'type': 'object', 'properties': {'needs': {'type': 'array', 'items': {'type': 'string'}}, 'intent': {'type': 'string'}, 'status': {'enum': ['ready', 'needs_input', 'needs_clarification', 'uncovered'], 'type': 'string'}, 'guardrails': {'type': 'array', 'items': {'type': 'string'}}, 'next_action': {'type': 'string'}, 'expectations': {'type': 'string'}, 'jurisdiction': {'type': 'string'}, 'skills_to_load': {'type': 'array'}, 'available_intents': {'type': 'array'}, 'available_jurisdictions': {'type': 'array'}}}
start_help
Get tax-workflow scoping guidance (no args)
No-argument front door — call this FIRST whenever a user asks 'how can you help me?', 'what can you do?', 'where do I start?', or otherwise opens vaguely (do NOT answer such questions by listing your tools or calling list_jurisdictions). For a signed-in approved accountant it returns a personalized `orientation` briefing (their standing + what their jurisdiction needs + one next action). For everyone else it returns the two scoping questions plus the available intents and jurisdictions. Once you have an intent, call `start(intent, jurisdiction)`.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'properties': {'needs': {'type': 'array', 'items': {'type': 'string'}}, 'status': {'enum': ['needs_input'], 'type': 'string'}, 'next_action': {'type': 'string'}, 'available_intents': {'type': 'array', 'items': {'type': 'string'}}, 'available_jurisdictions': {'type': 'array', 'items': {'type': 'string'}}}}
validate_vat_number
Validate a business VAT / tax-ID number (live registry lookup)
Check whether a business's VAT / tax-registration number is real and registered, in real time against the official government registry — and return the registered business NAME and ADDRESS when the authority discloses them. This is an authoritative, unfakeable confirmation you cannot get from a knowledge lookup or from training data. Use it whenever a user wants to verify a supplier's or customer's tax ID: before applying a B2B reverse charge, zero-rating a cross-border sale, or onboarding a vendor. COVERAGE TODAY IS EU ONLY — the 27 EU member states plus 'XI' (Northern Ireland), live via the European Commission's VIES registry (use 'EL' for Greece). Other jurisdictions (e.g. UK/HMRC and beyond) are NOT supported yet but are on the roadmap — for a non-EU number, tell the user live validation isn't available for that country yet rather than guessing a verdict. This is a LIVE external lookup — if the registry is temporarily unavailable it says so plainly rather than inventing an answer.
Read only
Open world
Idempotent
Input schema
{'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."}}}
Output schema
{'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': 'Whether the user can ask a named accountant to confirm the VAT treatment via ask_accountant_to_confirm.'}}}
History
Recent tool changes
Added
share_with_openaccountants
Sept. 17, 2026, 12:45 p.m.
Added
check_audit_exemption
Sept. 17, 2026, 12:45 p.m.
Added
validate_vat_number
Sept. 17, 2026, 12:45 p.m.
Added
list_verifiers
Sept. 17, 2026, 12:45 p.m.
Added
list_jurisdictions
Sept. 17, 2026, 12:45 p.m.
Added
start
Sept. 17, 2026, 12:45 p.m.
Added
start_help
Sept. 17, 2026, 12:45 p.m.
Added
list_rule_facets
Sept. 17, 2026, 12:45 p.m.
Added
get_deadlines
Sept. 17, 2026, 12:45 p.m.
Added
search_rules
Sept. 17, 2026, 12:45 p.m.
Added
search_skills
Sept. 17, 2026, 12:45 p.m.
Added
get_skill_sections
Sept. 17, 2026, 12:45 p.m.
Added
get_skill
Sept. 17, 2026, 12:45 p.m.
Added
list_skills
Sept. 17, 2026, 12:45 p.m.
Discover
Similar MCP servers
FalaZuki Finance BR
com.falazuki/finance-br
Provides Brazil-focused financial calculations and rules for investments, credit, taxes, payroll, labor costs, debt, budgeting, a…
XBOSS
kr.xdata/xdata-mcp
Accesses Korean tax, social insurance, payroll, cash receipt, e-tax invoice, and certificate filing services.
Sirenic
eu.sirenic/sirenic
Provides European company registry, financial, procurement, sanctions, regulatory, insolvency, ownership, and ongoing due-diligen…
taxsort-mcp
io.github.lonniev/taxsort-mcp
Classifies personal tax transactions, applies user-defined rules, manages tax-year sessions, and provides account, usage, and cre…
mcp
com.medigami/mcp
Analyzes medical bills and insurance denials, estimates healthcare costs, identifies assistance options, and supports appeals and…
AINumbers Fintech Intelligence Suite
co.ainumbers/tools
Provides deterministic fintech, payment-policy, financial analysis, regulatory compliance, credential integrity, and audit-trail …
Xearno Tools
tools.xearno/calculators
Provides financial, tax, employment-benefit, lending, pricing, and business calculators using jurisdiction-specific rules and cur…
schedule-iii
com.datavrn/schedule-iii
Transforms Indian company trial balances into controlled Schedule III financial statement workbooks with account mappings, disclo…