EU VAT rates
Standard VAT rate in any EU member state on any date since 2016. Offline, no API key.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@duty27/eu-vat-mcpclaude mcp add eu-vat-rates -- npx -y @duty27/eu-vat-mcp@0.1.1
{
"mcpServers": {
"eu-vat-rates": {
"command": "npx",
"args": [
"-y",
"@duty27/eu-vat-mcp@0.1.1"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
eu-vat
The standard VAT rate in every EU member state on any date since 1 January 2016, as small libraries with no dependencies that work offline.
| Language | Package | Install | Status |
|---|---|---|---|
| Node and the browser (TypeScript) | @duty27/eu-vat | npm install @duty27/eu-vat | on npm |
| Python 3.9+ | duty27-eu-vat | pip install duty27-eu-vat | on PyPI |
| Java 11+ | com.duty27:eu-vat | Maven or Gradle, see java/ | on Maven Central |
| AI assistants (MCP server) | @duty27/eu-vat-mcp | claude mcp add eu-vat -- npx -y @duty27/eu-vat-mcp | on npm |
import { getStandardRate } from '@duty27/eu-vat';
getStandardRate('DE', '2020-07-01'); // 16 (Germany's temporary cut)
from duty27_eu_vat import get_standard_rate
get_standard_rate("DE", "2020-07-01") # Decimal('16')
EuVat.getStandardRate("DE", "2020-07-01"); // 16
All three give identical answers (so does the MCP server) and are built from the same dataset, which Duty27 publishes at https://duty27.com/vat-rates/history, as CSV and JSON at https://duty27.com/data/eu-standard-vat-rates.json. Every rate change there cites the law or tax-authority notice that made it, and the 2016 starting rates cite the European Commission's rate table; the citations are on that page and in the CSV and JSON, not in the packages. It covers standard rates only; reduced rates are not included. It looks rates up; it does not calculate tax. This is information, not tax advice.
For deciding what to charge (B2B reverse charge, the EU €10,000 threshold, VIES checks) and keeping the proof (archive and OSS reports), see the Duty27 API, which is free to try.
Taking just the one you need
Most people never need this repository: install the package from its registry. To read or work on one library, each folder is self-contained: it has its own README, licences, build file and tests, and needs nothing from the rest of the repo. To fetch only one folder instead of the whole repository:
git clone --filter=blob:none --no-checkout https://github.com/duty27/eu-vat.git
cd eu-vat
git sparse-checkout set python # or node, or java
git checkout main
How they stay identical
One file, data/eu-standard-vat-rates.json, is the source. ./build.sh turns it into each
language's data module and a shared set of expected answers (test-vectors.csv, worked out by a plain scan of the
data, not by any library), then builds and tests all three libraries and the MCP server (which bundles the Node library's data), and finishes by
checking that every one of them carries the same source hash.
./build.sh # regenerate the data, then build and test node, python, java and the MCP server
./build.sh java # one language (or node, python, mcp)
./build.sh refresh # fetch the published rates and update the snapshot
./build.sh check # fail if the published rates changed, or a generated file was edited by hand
Licence
Code: MIT (LICENSE). Data: CC BY 4.0 (DATA-LICENSE.md), credit
Rate data: Duty27 (https://duty27.com/vat-rates/history), CC BY 4.0.
Frequently asked questions
What is EU VAT rates?
Standard VAT rate in any EU member state on any date since 2016. Offline, no API key.
How do I install EU VAT rates?
It runs on your machine. In Claude Code: claude mcp add eu-vat-rates -- npx -y @duty27/eu-vat-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does EU VAT rates need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is EU VAT rates open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains EU VAT rates?
It is published by duty27. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.