# Vatnode MCP

> Vatnode MCP is a freemium MCP server for finance and payments. Check EU VAT numbers against VIES and look up VAT rates for 45 countries. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://vatnode.dev/mcp
- **Repository:** https://github.com/vatnode/vatnode-mcp
- **MCP Registry name:** io.github.vatnode/vatnode-mcp
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-16

## About

Language models often quote outdated tax rates and cannot say whether a VAT number is real. This server answers those questions with data. Four tools work offline: standard, reduced, super-reduced and parking rates plus number formats for 45 jurisdictions, bundled in the package and refreshed daily from the European Commission's TEDB. Only validate_vat_number reaches the network, calling the vatnode API for a live VIES lookup across the EU-27 plus Northern Ireland.

A validation returns validity, registered company name and address, registration date and, once you set your own VAT number as requester in the dashboard, a VIES consultation number that serves as a timestamped record of the check. The website also describes a national-register fallback when a VIES country node is down, webhooks, monitoring and bulk validation on the platform, though the MCP server does not expose those.

It runs locally over stdio through npx and needs VATNODE_API_KEY only for validation. The vatnode plans start with a free 100 requests a month; Starter is 19 euros a month with 1,000 requests and Pro has 10,000. A SKILL.md brief is published for agents that do not speak MCP.

## Features

- **Live VIES validation:** Checks a number and returns company name, address and consultation number.
- **Offline VAT rates:** Standard, reduced, super-reduced and parking rates per country.
- **Format checks:** Syntactic check of a VAT number against country patterns.
- **45 jurisdictions:** Rates for 45 countries; validation for EU-27 and Northern Ireland.
- **Audit trail:** Consultation number and check ID kept for each validation.
- **SKILL.md brief:** A single agent-readable guide to the API.

## Good for

- Validate a customer's VAT number before issuing a B2B invoice
- Ask what VAT rate applies in a given EU country
- Pre-check a VAT number's format in a sign-up flow
- Record proof of a reverse-charge check

## Install

### Claude Code (Terminal)

```sh
claude mcp add vatnode-mcp --env VATNODE_API_KEY='<VATNODE_API_KEY>' -- npx -y vatnode-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vatnode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "<VATNODE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vatnode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "<VATNODE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "vatnode-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "<VATNODE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vatnode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "<VATNODE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vatnode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "<VATNODE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `validate_vat_number`: Live VIES validation returning validity, company name, address, registration date and consultation number
- `get_country_vat_rates`: Standard, reduced, super-reduced and parking rates plus number format for one country
- `list_eu_vat_rates`: VAT rates for all 27 EU states plus Northern Ireland
- `check_vat_format`: Offline syntax check of a VAT number against the country pattern
- `list_supported_countries`: List the 45 supported jurisdictions and which are EU members

## FAQ

### Do I need an API key?

Only for validate_vat_number; the four other tools work offline without one.

### Which countries can be validated?

The EU-27 plus Northern Ireland (XI) through VIES.

### What does it cost?

Free is 100 validations a month; Starter is 19 euros a month for 1,000 and Pro covers 10,000, with a per-request overage.

### How do I run it?

Use npx -y vatnode-mcp with VATNODE_API_KEY in the environment.

### Is Vatnode MCP free?

Vatnode MCP has a free plan, with paid plans for more usage or features.

### How do I add Vatnode MCP to Claude Code?

Run this command in your terminal: claude mcp add vatnode-mcp --env VATNODE_API_KEY='<VATNODE_API_KEY>' -- npx -y vatnode-mcp

### What are the best alternatives to Vatnode MCP?

The closest alternatives to Vatnode 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/vatnode-mcp
