Log inSubmit server
Vatnode MCP logo

Vatnode MCP

by vatnode

Look up European VAT rates and formats offline, or verify EU VAT numbers through VIES with an API key.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Vatnode MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "vatnode-vatnode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "YOUR_VALUE_HERE",
        "VATNODE_API_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

vatnode/vatnode-mcp connects MCP-compatible assistants to European VAT data and the EU Commission's VIES validation service. Four offline tools provide rates, country coverage, and VAT-format checks for supported European jurisdictions; live validation uses vatnode's API and VIES. Reach for it when an agent needs VAT research, invoice checks, company details, or compliance evidence. It runs locally over stdio with npx and requires an API key only for live VAT-number validation.

Use cases

  • Compare VAT rates across European countries
  • Check whether a VAT number has the expected format
  • Verify an EU VAT number against VIES
  • Retrieve company details for accounting or compliance
  • Find supported countries and VAT-number patterns

Key features

  • Offline VAT rates for 45 European countries
  • Live EU VAT validation through VIES
  • Country-specific VAT-number format checks
  • Structured rate and validation results
  • Local stdio installation with npx
  • Optional VIES consultation numbers

Tools5

What Vatnode MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

17/18 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · vatnode-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads1.2kPackage downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Tools exposed5Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Vatnode MCP works

What vatnode/vatnode-mcp does

vatnode/vatnode-mcp gives MCP-compatible AI clients access to European VAT rates, VAT-number formats, country coverage, and live EU VAT-number verification. Its bundled data covers 45 European countries, including the EU member states, Northern Ireland through the XI code, and other jurisdictions such as Norway, Switzerland, Great Britain, Ukraine, and Türkiye.

The server separates local lookups from live verification. Rate queries and format checks run offline without an account, network request, API key, or rate limit. EU VAT validation is read-only but contacts vatnode's API, which queries the EU VIES service and consumes one request from the configured monthly quota.

How it works

Run the package as a local stdio MCP process with npx -y vatnode-mcp. An MCP client sends tool calls to the process, which returns structured results for VAT lookups or validation.

The offline dataset is bundled through eu-vat-rates-data and sourced from the European Commission TEDB. It is updated daily. Country rate responses include standard, reduced, super-reduced, and parking rates where applicable, along with the currency, VAT name and abbreviation, VAT-number format, and a country-specific pattern.

check_vat_format only tests whether a number matches the expected syntax. A passing format check does not establish that the number exists or is active. validate_vat_number performs that live verification for EU-27 and Northern Ireland numbers. It can return validity, registered company name, address, registration date, and related VIES metadata. A consultation number is returned when a requester VAT number has been configured in the vatnode dashboard.

Setup and configuration

Install the server by configuring an MCP client to launch:

Terminal
npx -y vatnode-mcp

Set VATNODE_API_KEY in the client environment when live validation is needed. The free tools work without it. VATNODE_API_URL can replace the default https://api.vatnode.dev, which supports staging or self-hosted deployments.

The package can be configured in Claude Desktop, Cursor, ChatGPT custom connectors or Apps SDK, Continue, Cline, and other MCP-compatible clients. Restart or reload the client after adding the server so its tools become available.

Tools and capabilities

  • get_country_vat_rates looks up one country by ISO alpha-2 code and returns rates plus VAT-number formatting data.
  • list_eu_vat_rates returns current rates for all EU member states and XI.
  • check_vat_format performs an offline country-specific syntax check.
  • list_supported_countries reports available countries and whether each supports VIES validation.
  • validate_vat_number verifies an EU VAT number through VIES and returns registration details when available.

The rate and country tools are useful for comparisons, country selection, and determining whether live validation is supported. Validation applies only to EU-27 and XI; other supported countries provide rate and format data but cannot be checked through VIES.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Vatnode MCP

vatnode/vatnode-mcp is an MCP server that connects AI clients to European VAT data and the EU VIES service. Its main tools look up country and EU-wide VAT rates, check VAT-number formats, list supported countries, and validate EU VAT numbers with company details through a vatnode API key.

Install it by configuring your MCP client to run `npx -y vatnode-mcp`. Add `VATNODE_API_KEY` only if you need live VAT-number validation; offline rates, country listings, and format checks work without the key.

Yes, vatnode/vatnode-mcp works with Cursor through its MCP settings. Add a server that runs `npx -y vatnode-mcp`, and optionally provide `VATNODE_API_KEY` in the server environment for VIES validation.

No, live VIES validation supports only EU-27 countries and Northern Ireland, represented by XI. The server can still provide VAT rates and number-format data for other supported European jurisdictions such as Norway, Switzerland, Great Britain, Ukraine, and Türkiye.

No, `check_vat_format` only compares the number's syntax with the country-specific pattern. Use `validate_vat_number` for live verification against VIES; that tool requires a vatnode API key and uses a monthly request quota.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewVatnode MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/vatnode-vatnode-mcp?style=directory)](https://allmcps.com/mcp/vatnode-vatnode-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/vatnode-vatnode-mcp"><img src="https://allmcps.com/api/badge/vatnode-vatnode-mcp?style=directory" alt="Vatnode MCP on AllMCPs" /></a>