{"serverInfo":{"name":"VATFind","title":"VATFind MCP","version":"1.1.1"},"supportedVersions":["2026-07-28","2025-11-25"],"documentation":"https://vatfind.com/docs/mcp","endpoint":"https://vatfind.com/api/mcp","authentication":"oauth","tools":[{"name":"check_vat_number","title":"Check a VAT number","description":"Checks syntax and exact company-registry association for a VAT number. Read each returned status independently. Never claim a VAT registration is active unless tax_authority_status explicitly says valid; not_checked is not valid.","inputSchema":{"type":"object","additionalProperties":false,"required":["vat_number","country_code","idempotency_key"],"properties":{"vat_number":{"type":"string","minLength":1,"maxLength":128},"country_code":{"type":"string","pattern":"^[A-Za-z]{2}$"},"company_name":{"type":"string","minLength":1,"maxLength":256},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._-]{8,128}$","description":"Stable retry key retained for 24 hours."}}},"outputSchema":{"type":"object","required":["id","object","processing_status","identifier","format_status","registry_match_status","tax_authority_status","company_legal_status","evidence","warnings","credits_used","created_at","completed_at"],"properties":{"id":{"type":"string"},"object":{"const":"check"},"processing_status":{"const":"completed"},"source":{"enum":["api","mcp","dashboard","monitoring"]},"identifier":{"type":"object","properties":{"type":{"enum":["vat_number","tax_identifier","registration_number"]},"input":{"type":"string"},"normalized":{"type":"string"},"country_code":{"type":"string"}},"required":["type","input","normalized","country_code"]},"format_status":{"enum":["valid","invalid","not_supported","not_checked"]},"registry_match_status":{"enum":["matched","not_matched","ambiguous","unavailable","not_supported","not_checked"]},"tax_authority_status":{"enum":["valid","invalid","unavailable","not_applicable","not_supported","not_checked"]},"company_legal_status":{"enum":["active","inactive","dissolved","liquidation","insolvency","unknown","unavailable","not_applicable","not_supported","not_checked"]},"company":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"object"}},"credits_used":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"required_scope":"checks:run"},{"name":"find_vat_number","title":"Find VAT numbers","description":"Searches company records by company name or registration number and returns candidates. Do not silently choose a candidate when more than one is returned.","inputSchema":{"type":"object","additionalProperties":false,"required":["country_code","idempotency_key"],"anyOf":[{"required":["company_name"]},{"required":["registration_number"]}],"properties":{"country_code":{"type":"string","pattern":"^[A-Za-z]{2}$"},"company_name":{"type":"string","minLength":2,"maxLength":256},"registration_number":{"type":"string","minLength":1,"maxLength":128},"city_or_state":{"type":"array","maxItems":10,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":128,"pattern":"\\S"}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._-]{8,128}$","description":"Stable retry key retained for 24 hours."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"required_scope":"companies:search"},{"name":"check_tax_identifier","title":"Check a tax identifier","description":"Checks the syntax and exact company-record association of a non-VAT tax identifier. It does not imply a live tax-authority validation.","inputSchema":{"type":"object","additionalProperties":false,"required":["tax_identifier","country_code","idempotency_key"],"properties":{"tax_identifier":{"type":"string","minLength":1,"maxLength":128},"country_code":{"type":"string","pattern":"^[A-Za-z]{2}$"},"company_name":{"type":"string","minLength":1,"maxLength":256},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._-]{8,128}$","description":"Stable retry key retained for 24 hours."}}},"outputSchema":{"type":"object","required":["id","object","processing_status","identifier","format_status","registry_match_status","tax_authority_status","company_legal_status","evidence","warnings","credits_used","created_at","completed_at"],"properties":{"id":{"type":"string"},"object":{"const":"check"},"processing_status":{"const":"completed"},"source":{"enum":["api","mcp","dashboard","monitoring"]},"identifier":{"type":"object","properties":{"type":{"enum":["vat_number","tax_identifier","registration_number"]},"input":{"type":"string"},"normalized":{"type":"string"},"country_code":{"type":"string"}},"required":["type","input","normalized","country_code"]},"format_status":{"enum":["valid","invalid","not_supported","not_checked"]},"registry_match_status":{"enum":["matched","not_matched","ambiguous","unavailable","not_supported","not_checked"]},"tax_authority_status":{"enum":["valid","invalid","unavailable","not_applicable","not_supported","not_checked"]},"company_legal_status":{"enum":["active","inactive","dissolved","liquidation","insolvency","unknown","unavailable","not_applicable","not_supported","not_checked"]},"company":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"object"}},"credits_used":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"required_scope":"checks:run"},{"name":"get_check","title":"Get a saved check","description":"Retrieves a prior VATFind check by its opaque check ID for the authenticated workspace.","inputSchema":{"type":"object","additionalProperties":false,"required":["check_id"],"properties":{"check_id":{"type":"string","pattern":"^chk_[A-Za-z0-9_-]{16,80}$"}}},"outputSchema":{"type":"object","required":["id","object","processing_status","identifier","format_status","registry_match_status","tax_authority_status","company_legal_status","evidence","warnings","credits_used","created_at","completed_at"],"properties":{"id":{"type":"string"},"object":{"const":"check"},"processing_status":{"const":"completed"},"source":{"enum":["api","mcp","dashboard","monitoring"]},"identifier":{"type":"object","properties":{"type":{"enum":["vat_number","tax_identifier","registration_number"]},"input":{"type":"string"},"normalized":{"type":"string"},"country_code":{"type":"string"}},"required":["type","input","normalized","country_code"]},"format_status":{"enum":["valid","invalid","not_supported","not_checked"]},"registry_match_status":{"enum":["matched","not_matched","ambiguous","unavailable","not_supported","not_checked"]},"tax_authority_status":{"enum":["valid","invalid","unavailable","not_applicable","not_supported","not_checked"]},"company_legal_status":{"enum":["active","inactive","dissolved","liquidation","insolvency","unknown","unavailable","not_applicable","not_supported","not_checked"]},"company":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"object"}},"credits_used":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"checks:read"},{"name":"get_country_capabilities","title":"Get country capabilities","description":"Returns supported identifier types, format hints, registry matching, tax-authority checking, and company-status coverage for one country.","inputSchema":{"type":"object","additionalProperties":false,"required":["country_code"],"properties":{"country_code":{"type":"string","pattern":"^[A-Za-z]{2}$"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"coverage:read"},{"name":"get_usage","title":"Get usage","description":"Returns this workspace's current-period recorded operation counts, billable units, and remaining allowance across REST, MCP, monitoring, and workspace channels. Counts represent completed usage events, not every HTTP attempt.","inputSchema":{"type":"object","additionalProperties":false,"properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"usage:read"},{"name":"create_vat_monitor","title":"Create a company-record monitor","description":"Creates a baseline and schedules recurring company-record checks for a VAT number. The legacy tool name is retained for compatibility; it does not monitor authority-reported VAT status. Each successful baseline or refresh consumes one check. Configure signed webhooks through the REST API or dashboard.","inputSchema":{"type":"object","additionalProperties":false,"required":["vat_number","country_code","cadence","idempotency_key"],"properties":{"vat_number":{"type":"string","minLength":1,"maxLength":128},"country_code":{"type":"string","pattern":"^[A-Za-z]{2}$"},"cadence":{"type":"string","enum":["daily","weekly","monthly"]},"company_name":{"type":"string","minLength":1,"maxLength":256},"client_reference":{"type":"string","minLength":1,"maxLength":128},"watched_fields":{"type":"array","minItems":1,"maxItems":6,"uniqueItems":true,"items":{"type":"string","enum":["registry_match_status","company_legal_status","legal_name","registration_number","vat_numbers","registered_address"]}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._-]{8,128}$","description":"Stable retry key retained for 24 hours."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"required_scope":"monitoring:write"},{"name":"list_vat_monitors","title":"List company-record monitors","description":"Lists company-record monitors in the authenticated workspace and environment.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":1024}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"monitoring:read"},{"name":"get_vat_monitor","title":"Get a company-record monitor","description":"Retrieves one company-record monitor, its latest successful company-record snapshot, health, and next target check time.","inputSchema":{"type":"object","additionalProperties":false,"required":["monitor_id"],"properties":{"monitor_id":{"type":"string","pattern":"^mon_[A-Za-z0-9_-]{16,80}$"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"monitoring:read"},{"name":"update_vat_monitor","title":"Update a company-record monitor","description":"Pauses or resumes a company-record monitor and changes its cadence or watched company-record fields.","inputSchema":{"type":"object","additionalProperties":false,"required":["monitor_id","idempotency_key"],"anyOf":[{"required":["status"]},{"required":["cadence"]},{"required":["watched_fields"]}],"properties":{"monitor_id":{"type":"string","pattern":"^mon_[A-Za-z0-9_-]{16,80}$"},"status":{"type":"string","enum":["active","paused"]},"cadence":{"type":"string","enum":["daily","weekly","monthly"]},"watched_fields":{"type":"array","minItems":1,"maxItems":6,"uniqueItems":true,"items":{"type":"string","enum":["registry_match_status","company_legal_status","legal_name","registration_number","vat_numbers","registered_address"]}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._-]{8,128}$","description":"Stable retry key retained for 24 hours."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"monitoring:write"},{"name":"run_vat_monitor","title":"Run a company-record monitor now","description":"Runs an on-demand refresh for a company-record monitor. A successful refresh consumes one check.","inputSchema":{"type":"object","additionalProperties":false,"required":["monitor_id","idempotency_key"],"properties":{"monitor_id":{"type":"string","pattern":"^mon_[A-Za-z0-9_-]{16,80}$"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._-]{8,128}$","description":"Stable retry key retained for 24 hours."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"required_scope":"monitoring:write"},{"name":"archive_vat_monitor","title":"Archive a company-record monitor","description":"Stops future checks and archives a company-record monitor while retaining its event evidence.","inputSchema":{"type":"object","additionalProperties":false,"required":["monitor_id","idempotency_key"],"properties":{"monitor_id":{"type":"string","pattern":"^mon_[A-Za-z0-9_-]{16,80}$"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._-]{8,128}$","description":"Stable retry key retained for 24 hours."}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"required_scope":"monitoring:write"},{"name":"list_vat_monitor_events","title":"List company-monitor events","description":"Lists material company-record changes and operational monitoring events for the authenticated workspace.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"monitor_id":{"type":"string","pattern":"^mon_[A-Za-z0-9_-]{16,80}$"},"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":1024}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"monitoring:events"},{"name":"get_vat_monitor_event","title":"Get a company-monitor event","description":"Retrieves one monitoring event with its canonical field changes and delivery state.","inputSchema":{"type":"object","additionalProperties":false,"required":["event_id"],"properties":{"event_id":{"type":"string","pattern":"^evt_[A-Za-z0-9_-]{16,80}$"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"required_scope":"monitoring:events"}]}