VAT.SUPPORT — Model Context Protocol (MCP) Server

Official Model Context Protocol (MCP) server for VAT.SUPPORT — the European Union & United Kingdom statutory VAT compliance and audit engine.

This server equips AI agents (Claude, Cursor, Windsurf, Arcade.dev, Cline) with real-time tax determinations, sub-100ms VIES entity validation, and statutory Art. 196 reverse-charge audit certificates.

🛠 Available Tools

1. reverse_charge_certificate

Evaluates statutory eligibility under Art. 196 EU VAT Directive (2006/112/EC) for cross-border B2B invoices between EU Member States.

• Inputs: supplier_country (ISO-2), customer_country (ISO-2), customer_vat_id, service_type.

• Output: Printable certificate with audit token, statutory article citation, and public verification URL.

2. vat_number_check

Validates European Union (EU-27) and United Kingdom (GB) VAT numbers in real-time against European Commission VIES and HMRC.

• Inputs: vat_id (e.g. DE123456789, FR12345678901, GB123456789).

• Output: Validity flag, registered company legal name, official address, and consultation number.

3. vat_rate_lookup

Fetches verified standard, reduced, super-reduced, and zero rates synced from the European Commission TEDB (Taxes in Europe Database).

• Inputs: country (ISO-2), rate_type (standard | reduced | super_reduced | zero | parking).

4. vat_registration_check

Determines whether a cross-border seller is legally required to register for VAT in a destination country or qualifies for the Pan-EU One Stop Shop (€10,000 threshold).

• Inputs: country, customer_type (B2C | B2B | MIXED), annual_revenue_eur, sale_countries, supply_types.

5. vat_compliance_full

Executes a comprehensive 10-point EU statutory VAT audit, returning a 0–100 compliance index, risk band, and Article citations.

Related MCP server: goodvat

🚀 Quick Setup

Option A: Streamable HTTP (Remote / No Installation)

You can connect directly to the live hosted endpoint without installing any local code:

Endpoint: https://vat.support/api/mcp
Transport: streamable-http

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "vat-support": {
      "url": "https://vat.support/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "vat-support": {
      "url": "https://vat.support/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Arcade.dev

In Arcade.dev, navigate to Servers → Add Server:

• Name: vat-support

• URI: https://vat.support/api/mcp

• Type: MCP

Option B: Local Stdio (Python)

Clone this repository and run locally:

git clone https://github.com/vmalyshev1/vat-support-mcp.git
cd vat-support-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "vat-support": {
      "command": "python3",
      "args": ["/path/to/vat-support-mcp/server.py"]
    }
  }
}

Option C: Docker

docker build -t vat-support-mcp .
docker run -i --rm vat-support-mcp

📚 Machine Readable Specs

• LLM Manifest: https://vat.support/llms.txt

• Extended Machine Spec: https://vat.support/llms-full.txt

• Developer Documentation: https://vat.support/developers/

📄 License

MIT License — Copyright (c) 2026 VAT.SUPPORT