Model Context Protocol

EU VAT validation for AI agents

vatnode ships an official Model Context Protocol (MCP) server, so Claude, Cursor, ChatGPT and any MCP-compatible client can validate EU VAT numbers and look up VAT rates directly in the conversation — backed by the live EU VIES register, not by a guess.

Connect it once and your agent stops inventing tax data. It validates the actual number, returns the registered company, and can attach a VIES consultation number for your audit trail.

Why an AI workflow needs real VAT data

Language models are confident and frequently wrong about tax. Ask one for the VAT rate in Finland and it may quote 24% — the rate before the September 2024 increase to 25.5%. Ask it whether a VAT number is valid and it has no way to know: validity is a fact held only by the EU VIES register, updated continuously by 27 national tax authorities. A model cannot validate a VAT number any more than it can check whether your flight is on time. It can only guess.

For any agent that touches invoicing, onboarding, B2B sign-up or compliance, a wrong answer is not a harmless slip — it is a mis-issued invoice or a reverse-charge claim you cannot defend. The vatnode MCP server replaces the guess with a tool call: bundled rate and format data refreshed daily from the EU Commission TEDB, and live VIES validation through the vatnode API for the EU-27 plus Northern Ireland (XI).

The tools your agent gets

Five focused tools, each with a description tuned for accurate selection by the agent. Four work fully offline with no API key; only live VIES validation calls the vatnode API.

ToolAPI key?What it does
validate_vat_numberYesLive VIES validation — validity, registered company name and address, registration date, and an optional VIES consultation number for audit proof.
get_country_vat_ratesNoStandard, reduced, super-reduced and parking rates for one country, plus the VAT number format and regex.
list_eu_vat_ratesNoAll 27 EU member states plus XI for Northern Ireland.
check_vat_formatNoOffline syntactic check of a VAT number against the country regex — does not call VIES.
list_supported_countriesNoAll 45 supported countries and which are EU members (eligible for VIES validation).

Connect it in 30 seconds

The server is published to npm as vatnode-mcp. Add this block to your client config — for Claude Desktop it goes in claude_desktop_config.json; in Cursor, paste it under Settings → MCP → Add new server.

claude_desktop_config.json
{
  "mcpServers": {
    "vatnode": {
      "command": "npx",
      "args": ["-y", "vatnode-mcp"],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}
No API key yet? The four free tools (rates and format checks) work without one — just omit the env block. To enable live validate_vat_number checks, grab a free API key. Full per-client instructions live in the MCP setup guide.

What it looks like in chat

Once connected, you talk to the agent normally — it picks the right tool from the description.

Claude Desktop chat
You: What's the VAT rate in Finland and Germany?

Claude: (calls get_country_vat_rates for FI and DE — free, no key)
Finland's standard VAT is 25.5%, Germany's is 19%. Finland has reduced
rates of 13.5% and 10%; Germany has 7%.

You: Is IE6388047V a valid VAT? Add it to the invoice if so.

Claude: (calls validate_vat_number — requires API key)
Yes, it's valid. Registered to GOOGLE IRELAND LIMITED at Gordon House,
Barrow Street, Dublin 4. Consultation number WAPIAAAAXk7ZpY3o is on file
for your reverse-charge audit trail.
Audit-grade, even from a chat window. A successful validate_vat_numbercall returns the VIES consultation number — the EU Commission-issued reference that proves the check ran against the official register on a specific date. It is the documented evidence for reverse-charge "reasonable care" on intra-EU B2B invoices, and your agent can capture it automatically.

Coverage

  • Live VIES validation for all EU-27 member states plus Northern Ireland (XI)
  • VAT rate and format data for 45 European countries, refreshed daily from the EU Commission TEDB
  • VIES consultation number on every successful live validation — for audit evidence
  • Registered company name and address returned where the member state publishes it
  • Four offline tools that need no API key and never make a network call

FAQ

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI agents like Claude, Cursor and ChatGPT call external tools. The vatnode MCP server exposes EU VAT validation and rate lookup as MCP tools, so an agent can verify a VAT number or fetch a rate during a conversation instead of guessing.

Why not just let the LLM answer VAT questions itself?

Language models hallucinate. They will confidently state a VAT rate that changed last year, or claim a VAT number is valid without checking anything. VAT rates move (Finland went to 25.5% in 2024) and validity can only be confirmed against the live EU VIES register. The vatnode MCP server gives the agent a real data source: bundled rates refreshed daily from the EU Commission TEDB, and live VIES validation through the vatnode API.

Do I need an API key?

Not for everything. Four of the five tools — rate lookups and offline format checks — work fully offline with no key, because the rate and format data is bundled in the package. Only validate_vat_number, which performs a live VIES check, needs a vatnode API key. The free plan includes a monthly request quota with no credit card.

Which AI clients are supported?

Any MCP-compatible client: Claude Desktop, Cursor, ChatGPT, Cline, Continue, and others. You point the client at npx -y vatnode-mcp and, if you want live validation, set VATNODE_API_KEY in the environment.

Where does my data go?

The server runs locally on your machine via npx — there is no third-party proxy. Your API key stays in your own MCP client config and is only ever sent directly to api.vatnode.dev. The four free tools never make a network call at all.

What countries are covered?

Live VIES validation covers the EU-27 plus Northern Ireland (XI). Rate and format data covers 45 European countries. UK domestic, US, Norwegian and Swiss VAT validation are out of scope.

Give your agent real VAT validation

Free plan, no credit card. Connect the official vatnode MCP server to Claude, Cursor or ChatGPT and validate EU VAT numbers with VIES and the consultation number on every successful check.