
Official Model Context Protocol (MCP) server for vatnode — EU VAT validation, rates, and format
Official Model Context Protocol (MCP) server for vatnode — EU VAT validation, rates, and format checks for AI agents (Claude, Cursor, ChatGPT).
·
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.
npx| Tool | Free | Description |
|---|---|---|
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.
Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.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).
Settings → MCP → Add new server:
{
"mcpServers": {
"vatnode": {
"command": "npx",
"args": ["-y", "vatnode-mcp"],
"env": { "VATNODE_API_KEY": "vat_live_your_key_here" }
}
}
}Configure as an stdio MCP server with the same npx -y vatnode-mcp command. See the Apps SDK docs.
Any MCP-compatible client can connect — point it at npx -y vatnode-mcp and (optionally) pass VATNODE_API_KEY via environment.
validate_vat_number requires a vatnode account. The platform also offers things the MCP doesn't expose:
You: What's the VAT rate in Finland and Germany?
(Agent calls
get_country_vat_ratesfor 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.
| Env var | Required | Default | Purpose |
|---|---|---|---|
VATNODE_API_KEY | for validate_vat_number | — | API key from https://vatnode.dev |
VATNODE_API_URL | no | https://api.vatnode.dev | Override the API base (self-hosting / staging) |
Bug reports and PRs welcome. Open an issue first for non-trivial changes so we can align on direction.
git clone https://github.com/vatnode/vatnode-mcp.git
cd vatnode-mcp
npm install
npm testReleases are published to npm via Trusted Publishing — no NPM_TOKEN secret, every release signed with npm provenance.
# 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.2
git push --tagsCI on .github/workflows/release.yml picks up the tag and publishes.
MIT
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add vatnode -- npx -y vatnode-mcp{
"mcpServers": {
"vatnode": {
"env": {
"VATNODE_API_KEY": ""
},
"args": [
"-y",
"vatnode-mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"vatnode","env":{"VATNODE_API_KEY":""},"args":["-y","vatnode-mcp"],"command":"npx"}'[mcp_servers.vatnode]
command = "npx"
args = ["-y", "vatnode-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/vatnode-mcp to learn what the "Vatnode Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
| Name | What it does |
|---|---|
list_eu_vat_rates | Returns current VAT rates for all EU member states (plus XI for Northern Ireland). Read-only and offline: no network call, no API key, no rate limit, no side effects. Takes no arguments. Output: { rat |
get_country_vat_rates | Returns the standard, reduced, super-reduced and parking VAT rates for a single European country, plus the VAT number format and regex. Read-only and offline: no network call, no API key, no rate limi |
check_vat_format | Performs an offline syntactic check of a VAT number against the country-specific regex pattern. Read-only and offline: no network call, no API key, no rate limit, no side effects. Does NOT verify the |
list_supported_countries | Returns every country the vatnode server has VAT data for (EU-27 + XI for Northern Ireland + ~17 other European jurisdictions such as NO, CH, GB, UA, TR). Read-only and offline: no network call, no AP |
validate_vat_number | Verifies an EU VAT number against the official VIES service and returns validity, company name, address, registration date and other metadata. The VIES consultation number (`consultationNumber`) is re |
Read live from the server on September 26, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/vatnode-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "vatnode-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.