mcpField
E
EU VAT rates

EU VAT rates

Local
duty27.comFinance0Updated 2w ago
RepositoryVisit website

About EU VAT rates

EU VAT rates is an offline MCP server for assistants and finance workflows that need standard VAT rates for EU member states. Its bundled data supports historical lookups from 2016 without network calls or an API key.

Key features

  1. 01Look up a country's rate on a date
  2. 02Retrieve a country's rate history
  3. 03List EU-wide rate changes
  4. 04List member states and codes
  5. 05Offline, read-only queries

Use cases

  1. 01Check a VAT rate for an earlier transaction date
  2. 02Review rate changes across EU countries
  3. 03Confirm a country's standard VAT rate today

MCP support

Exposes four read-only tools to MCP clients for querying standard VAT rates and changes across the 27 EU member states. Queries run locally against bundled data without network calls.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "duty27-eu-vat": {
      "command": "npx",
      "args": [
        "-y",
        "@duty27/eu-vat-mcp"
      ]
    }
  }
}
Run commandnpx -y @duty27/eu-vat-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@duty27/eu-vat-mcp0.1.1

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
datestringNoDay as YYYY-MM-DD, for example "2020-07-01". Optional: today (UTC) when omitted.
countrystringYesEU member state code such as "DE" or "FR" (case does not matter). Greece is "EL"; "GR" is accepted too.

Details

From the project README

@duty27/eu-vat-mcp

An MCP server that lets an AI assistant answer "what was the VAT rate in Germany on 1 July 2020?" correctly, for all 27 EU member states, any day since 2016.

It runs on your machine, offline, with no API key and no account. The rates are bundled in the package.

Use it

Claude Code

claude mcp add eu-vat -- npx -y @duty27/eu-vat-mcp

Claude Desktop, Cursor and other clients (add to the client's MCP config)

{
  "mcpServers": {
    "eu-vat": { "command": "npx", "args": ["-y", "@duty27/eu-vat-mcp"] }
  }
}

Then ask: "Which EU countries changed their standard VAT rate since 2024?"

Tools

ToolAnswers
get_standard_rateThe standard rate in one country on one day (today if no day is given).
get_rate_historyEvery standard rate a country has had, with the first day of each.
list_rate_changesRate changes across the EU, newest first; filter by country and/or a start date.
list_countriesThe 27 member states and their codes (Greece is EL; GR also works).

All four are read-only and make no network calls.

What it will not do

  • Standard rates only. Reduced rates (e-books, food, ...) are not included.
  • Lookup, not calculation. It returns the rate. It does not work out net or gross amounts, rounding, whether a sale is reverse-charged, or OSS reports: those are in the Duty27 API.
  • Nothing is guessed. An unknown country, a date before 2016-01-01 or a malformed date is returned as an error the assistant can read, never a plausible-looking wrong rate.
  • It is a snapshot. Every answer says when the data was last checked (dataAsOf). A rate that changed after that date appears in the next release. A pull request that updates the data opens automatically when Duty27's published rates change, and is released after a person checks it against the primary source.
  • The citations are on the web, not in the answers. Every rate change cites the law or tax-authority notice that made it (the 2016 starting rates cite the European Commission's rate table), listed at https://duty27.com/vat-rates/history.

Need more than a rate?

Deciding what to charge and keeping the proof (B2B reverse charge, the EU €10,000 threshold, VIES checks, an archive and OSS reports) is what the Duty27 API does. It is free to try, no credit card.

Same data as the libraries

This server uses exactly the data of the Node, Python and Java libraries from the same repository: one shared source, one hash, one set of test vectors checked in every language and through this server.

Licence

Code: MIT (LICENSE). Rate data: CC BY 4.0 (DATA-LICENSE.md); the answers include the credit it asks for: Rate data: Duty27 (https://duty27.com/vat-rates/history), CC BY 4.0.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.