Vatnode Mcp

io.github.vatnodePublished by GitHub account vatnodev1.3.0Updated Oct 24, 2026

Official MCP server: EU VAT validation via VIES, plus offline rates and format checks.

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant look up European VAT rates, check VAT number formats offline, and validate EU VAT IDs against VIES.

What you can do
An official vatnode MCP server exposing five tools. Four work offline with bundled data: get_country_vat_rates returns standard, reduced, super-reduced and parking rates plus the number format for a country; list_eu_vat_rates returns all EU member states at once; check_vat_format runs a syntactic check against the country regex; list_supported_countries lists the 45 supported countries and which support full VIES validation. The fifth tool, validate_vat_number, performs live VIES validation and returns validity, company name, address, registration date and, when a requester VAT is configured, the VIES consultation number.
When to use it
Useful when an assistant needs EU VAT rates or VAT number checks while drafting invoices, quotes, or customer records, or when verifying that a business VAT ID is registered. The offline tools suit quick lookups without any account; the live validation tool is for cases where the registered company details matter.
Requirements
Runs locally over stdio, typically started with npx, so Node.js is needed. The four offline tools need no account or key. validate_vat_number requires a vatnode API key supplied as the VATNODE_API_KEY environment variable; the free tier has a monthly request quota. VATNODE_API_URL optionally overrides the API base URL for self-hosting or staging. Network access is needed only for live validation.
Before you install
validate_vat_number sends the VAT number being checked to the vatnode API, so treat it as data leaving the machine. The VATNODE_API_KEY secret is passed via environment variable and should not be committed to shared configuration files. Live validation consumes the free tier's monthly request quota. The other four tools run offline and send nothing.

Installation

In SourceWeft

  1. Open Vatnode Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

vatnode-mcp

[npm version] [Tests] [License: MIT] [vatnode/vatnode-mcp MCP server]

Official Model Context Protocol server for vatnode — VAT validation and EU tax data for AI agents.

Lets AI assistants (Claude Desktop, Cursor, ChatGPT, Continue, Cline, …) look up VAT rates, check VAT number formats, and validate VAT IDs against the EU VIES service without leaving the chat.

  • Free, offline — VAT rates and format checks for 45 European countries, no account needed
  • Live validation — verify EU VAT numbers against VIES, get the registered company + the VIES consultation number (requires a free vatnode API key; the consultation number is produced once you set your own VAT as requester in dashboard Account details)
  • Five focused tools — well-described for accurate agent tool selection
  • Pure stdio, zero hosted dependencies, runs locally via npx

Tools

ToolFreeDescription
get_country_vat_rates✅Standard / reduced / super-reduced / parking rates + VAT number format for a country
list_eu_vat_rates✅All 27 EU member states (plus XI for Northern Ireland) at once
check_vat_format✅Offline syntactic check of a VAT number against the country regex
list_supported_countries✅All 45 supported countries and which ones support full VIES validation
validate_vat_number🔑Live VIES validation — returns validity, company name, address, registration date, and (when a requester VAT is set in dashboard Account details) the VIES consultation number

Free tools work fully offline — data is bundled via eu-vat-rates-data and updated daily from the European Commission TEDB.

validate_vat_number requires a vatnode API key. The free tier includes a monthly request quota — get one in 30 seconds.

Install

Claude Desktop

Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Restart Claude Desktop. The vatnode tools will appear in the tool picker.

You can omit VATNODE_API_KEY if you only need the free tools (rates, format checks).

Cursor

Settings → MCP → Add new server:

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

ChatGPT (custom connectors / Apps SDK)

Configure as an stdio MCP server with the same npx -y vatnode-mcp command. See the Apps SDK docs.

Continue / Cline / other clients

Any MCP-compatible client can connect — point it at npx -y vatnode-mcp and (optionally) pass VATNODE_API_KEY via environment.

Get an API key

validate_vat_number requires a vatnode account. The platform also offers things the MCP doesn't expose:

  • Webhooks for VAT status changes (monitor a customer's VAT continuously)
  • Bulk validation
  • National-database fallback when VIES is down
  • VIES consultation numbers (a timestamped record that the check was made against VIES)
  • Per-key rate limiting + dashboard analytics

Sign up free →

Example session

You: What's the VAT rate in Finland and Germany?

(Agent calls get_country_vat_rates for FI and DE — free, no key.)

Agent: Finland's standard VAT is 25.5%, Germany's is 19%. Finland has reduced rates of 14% and 10%; Germany has 7%.

You: Is IE6388047V a valid VAT?

(Agent calls validate_vat_number — requires API key.)

Agent: Yes, it's valid. Registered to GOOGLE IRELAND LIMITED at Gordon House, Barrow Street, Dublin 4.

Configuration

Env varRequiredDefaultPurpose
VATNODE_API_KEYfor validate_vat_number—API key from https://vatnode.dev
VATNODE_API_URLnohttps://api.vatnode.devOverride the API base (self-hosting / staging)

Contributing

Bug reports and PRs welcome. Open an issue first for non-trivial changes so we can align on direction.

bash
git clone https://github.com/vatnode/vatnode-mcp.gitcd vatnode-mcpnpm installnpm test

Releasing

Releases are published to npm via Trusted Publishing — no NPM_TOKEN secret, every release signed with npm provenance.

bash
# bump the version in ALL of: package.json, src/index.ts (VERSION),# and server.json (top-level "version" + packages[0].version — the MCP# Registry publish reads server.json and rejects a duplicate version).# Commit, then:git tag v0.3.2git push --tags

CI on .github/workflows/release.yml picks up the tag and publishes.

License

MIT

Source: README.md at commit 303a8ed

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

4
  1. v1.3.0LatestSep 30, 2026
  2. v1.1.5Sep 22, 2026
  3. v1.1.4Sep 20, 2026
  4. v1.1.2Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts