Skip to main content
Glama

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

Related MCP server: mcp-europe-business

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.

Available Tools

4 tools
get_rate_historyEvery standard VAT rate a country has hadA
Read-onlyIdempotent

List every standard VAT rate one EU member state has had since 2016-01-01, with the first day each one applied. Use this for "how has the VAT rate in Ireland changed?". Standard VAT rates only (not reduced rates), from 2016-01-01. Data checked against the published rates on 2026-10-04; a change made after that date appears in a newer release.

Inputs: country (required). Returns: country, windows, dataAsOf, attribution

get_standard_rateEU standard VAT rate on a dateA
Read-onlyIdempotent

Look up the standard VAT rate in force in one EU member state on a given day (any day since 2016-01-01). Use this for "what was the VAT rate in Germany on 1 July 2020?" or "what is the VAT rate in Finland today?". The day a rate changes is the first day of the new rate. Standard VAT rates only (not reduced rates), from 2016-01-01. Data checked against the published rates on 2026-10-04; a change made after that date appears in a newer release.

Inputs: country (required), date. Returns: date, rate, country, dataAsOf, +1 more

list_countriesThe 27 EU member states and their codesA
Read-onlyIdempotent

List the 27 EU member states with the codes the other tools expect. Greece is "EL", the code the European Union uses ("GR" is also accepted). Use this to find a code. The United Kingdom and other non-EU countries are not covered.

Inputs: no named parameters. Returns: dataAsOf, countries, attribution

list_rate_changesStandard VAT rate changes across the EUA
Read-onlyIdempotent

List the changes of the standard VAT rate across the EU, newest first, optionally for one country and/or since a date. Use this for "which EU countries changed their VAT rate this year?". Each change gives the old rate, the new rate, and the first day of the new rate. Standard VAT rates only (not reduced rates), from 2016-01-01. Data checked against the published rates on 2026-10-04; a change made after that date appears in a newer release.

Inputs: since, country. Returns: changes, dataAsOf, attribution

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool has a clearly stated distinct purpose: point-in-time lookup, per-country history, country code list, and cross-country change feed. There is mild overlap between get_rate_history and list_rate_changes (both surface rate changes for a country), but the descriptions make the intended use cases distinguishable.

    Naming Consistency5/5

    All four tools follow a consistent verb_noun snake_case pattern (get_standard_rate, get_rate_history, list_countries, list_rate_changes). No deviations in convention or style.

    Tool Count5/5

    Four tools is well-scoped for a narrow domain (EU standard VAT rates). Each tool earns its place with no redundancy or bloat.

    Completeness5/5

    The surface covers lookup, full history, cross-country change monitoring, and the country code reference needed to use the other tools. Reduced rates are explicitly out of scope, so within the stated domain there are no dead ends.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      European business compliance suite for AI agents — 28 tools covering tax ID validation (PT, ES, FR, DE, IT, UK, NL), IBAN verification, EU VAT rates, invoice requirements, e-invoicing rules, payment terms, labor calendar helpers, VAT breakdown calculations and invoice schema validation for 18+ European countries.
      28
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      SLA'd EU VAT number validation for AI agents via VIES, with caching and circuit-breaking to handle flaky upstream, returning valid/invalid/unavailable responses.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Validates EU and Northern Ireland VAT numbers against the official VIES service, returning validity, company name and address, and distinguishing invalid from unavailable. Supports bulk checking up to 100 VAT IDs.
      -