VIES VAT MCP Server — Validate EU VAT Numbers with AI Agents

Validate EU VAT Numbers with AI Agents

The European Commission's VIES (VAT Information Exchange System) is the official source for confirming that an EU VAT number is registered for intra-Community trade. Connecting VIES to MCP lets your AI agents pre-flight every B2B invoice — automatically catching invalid VAT IDs before they cause compliance issues with the Finanzamt or any other EU tax authority.

Quick Setup with Built-in Adapter

AnythingMCP ships with a pre-configured VIES adapter. The endpoint is public and requires no API key.

Step 1: Deploy AnythingMCP

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 2: Import the VIES Adapter

Open the AnythingMCP dashboard at http://localhost:3000/connectors/store and click Import on the VIES VAT Validation adapter. There are no credentials to enter — the EU endpoint is public.

Step 3: Connect to Your AI Agent

{
  "mcpServers": {
    "vies": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Available Tools

AI Agent Use Cases

• "Check if VAT number IT12345678901 is valid"
• "Validate this customer's VAT before issuing the reverse-charge invoice"
• "Look up the registered name for DE123456789"
• "Run a batch validation on these 20 VAT numbers from the order export"

Notes for B2B Compliance

• Some member states (DE, ES) do not return name/address for privacy reasons. Only the valid: true/false flag is authoritative there.
• VIES is rate-limited per source IP. For high-volume validation, queue requests with a backoff.
• Country codes are ISO 3166-1 alpha-2, plus EL for Greece and XI for Northern Ireland.

Next Steps

• Handelsregister MCP Guide — Look up the German commercial register
• REST API to MCP — Build custom REST connectors