# VIES VAT Validator MCP

> VIES VAT Validator MCP is a freemium MCP server for finance and payments. Validate EU VAT numbers against VIES with a free local format pre-check. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://apify.com/neeenja/vies-vat-validator-mcp
- **Repository:** https://github.com/panstories/vies-vat-validator-mcp
- **MCP Registry name:** io.github.PanStories/vies-vat-validator-mcp
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-16

## About

VIES VAT Validator MCP works in two stages. A local check tests the number's format for free and without network access; a live check against the official VIES SOAP service follows only when requested. Because the VIES endpoint rate-limits and goes down often, a cache and graceful degradation are built in, and errors come in both English and Chinese.

Coverage is the 27 EU states plus GB and XI for Northern Ireland, and every country entry includes its native name and local VAT term, such as USt-IdNr. for Germany or Partita IVA for Italy. Tools are validate_vat, check_vat_format, list_supported_countries and get_error_codes, plus resources and two prompts.

It is MIT licensed and aimed at cross-border sellers who must verify a counterparty for reverse-charge treatment.

## Features

- **Two-stage validation:** Free format check, then optional live VIES lookup.
- **Bilingual errors:** Error codes in English and Chinese.
- **Country reference:** Native names and local VAT terms.
- **Cache:** TTL cache to soften VIES outages.
- **Prompts:** Guides for compliance and explaining results.

## Good for

- Verify a B2B customer's VAT ID before invoicing
- Pre-screen bulk VAT numbers for typos
- Look up what a country calls its VAT number
- Explain a validation failure to a non-expert

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vies-vat-validator-mcp https://neeenja--vies-vat-validator-mcp.apify.actor/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://neeenja--vies-vat-validator-mcp.apify.actor/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vies-vat-validator-mcp": {
      "url": "https://neeenja--vies-vat-validator-mcp.apify.actor/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vies-vat-validator-mcp": {
      "type": "http",
      "url": "https://neeenja--vies-vat-validator-mcp.apify.actor/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vies-vat-validator-mcp": {
      "serverUrl": "https://neeenja--vies-vat-validator-mcp.apify.actor/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vies-vat-validator-mcp": {
      "type": "http",
      "url": "https://neeenja--vies-vat-validator-mcp.apify.actor/mcp"
    }
  }
}
```

## Tools

- `validate_vat`: Format check then optional live VIES verification.
- `check_vat_format`: Local format check with no network.
- `list_supported_countries`: Supported countries with local VAT terms.
- `get_error_codes`: Bilingual error-code table.

## FAQ

### What does it cost?

Apify lists live validations from $5 per 1,000; format checks are free.

### Which countries?

EU 27 plus GB and XI.

### Is it open source?

Yes, under the MIT licence.

### Why a cache?

The official VIES service is slow and unreliable at times.

### Is VIES VAT Validator MCP free?

VIES VAT Validator MCP has a free plan, with paid plans for more usage or features.

### How do I add VIES VAT Validator MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http vies-vat-validator-mcp https://neeenja--vies-vat-validator-mcp.apify.actor/mcp

### What are the best alternatives to VIES VAT Validator MCP?

The closest alternatives to VIES VAT Validator MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/vies-vat-validator-mcp
