Vatnode MCP server

vatnode-mcp

Official Model Context Protocol server for vatnode — VAT validation and EU tax data for AI agents.

Lets AI assistants (Claude Desktop, Cursor, ChatGPT, Continue, Cline, …) look up VAT rates, check VAT number formats, and validate VAT IDs against the EU VIES service without leaving the chat.

• Free, offline — VAT rates and format checks for 45 European countries, no account needed
• Live validation — verify EU VAT numbers against VIES, get the registered company + the VIES consultation number (requires a free vatnode API key; the consultation number is produced once you set your own VAT as requester in dashboard Settings)
• Five focused tools — well-described for accurate agent tool selection
• Pure stdio, zero hosted dependencies, runs locally via npx

Tools

Free tools work fully offline — data is bundled via eu-vat-rates-data and updated daily from the European Commission TEDB.

validatevatnumber requires a vatnode API key. The free tier includes a monthly request quota — get one in 30 seconds.

Install

Claude Desktop

Add to your claudedesktopconfig.json (macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json):

{
  "mcpServers": {
    "vatnode": {
      "command": "npx",
      "args": ["-y", "vatnode-mcp"],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}

Restart Claude Desktop. The vatnode tools will appear in the tool picker.

You can omit VATNODEAPIKEY if you only need the free tools (rates, format checks).

Cursor

Settings → MCP → Add new server:

{
  "mcpServers": {
    "vatnode": {
      "command": "npx",
      "args": ["-y", "vatnode-mcp"],
      "env": { "VATNODE_API_KEY": "vat_live_..." }
    }
  }
}

ChatGPT (custom connectors / Apps SDK)

Configure as an stdio MCP server with the same npx -y vatnode-mcp command. See the Apps SDK docs.

Continue / Cline / other clients

Any MCP-compatible client can connect — point it at npx -y vatnode-mcp and (optionally) pass VATNODEAPIKEY via environment.

Get an API key

validatevatnumber requires a vatnode account. The platform also offers things the MCP doesn't expose:

• Webhooks for VAT status changes (monitor a customer's VAT continuously)
• Bulk validation
• National-database fallback when VIES is down
• VIES consultation numbers (a timestamped record that the check was made against VIES)
• Per-key rate limiting + dashboard analytics

Sign up free →

Example session

Shortened. The full README is on GitHub.