MCP server

euroref — European government reference data Official

dev.euroref/reference-data

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

European govt data, cited: rates, VAT, tax, wages, holidays, FX. 34 countries + EU; Germany free.

Website

At a glance

Type

MCP server

Publisher

euroref.dev (verified by the MCP Registry)

Status

Working at last check

Tools

32

Token cost

About 14,604 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http reference-data https://euroref.dev/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.reference-data]
url = "https://euroref.dev/mcp"

Gemini CLI

{"mcpServers":{"reference-data":{"httpUrl":"https://euroref.dev/mcp"}}}

Cursor

{"mcpServers":{"reference-data":{"url":"https://euroref.dev/mcp"}}}

VS Code

{"servers":{"reference-data":{"type":"http","url":"https://euroref.dev/mcp"}}}

Antigravity

agy mcp add reference-data https://euroref.dev/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"reference-data","server_url":"https://euroref.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"reference-data","server_url":"https://euroref.dev/mcp"}

Tools

• add_business_days ~382 tokens
  FREE, unmetered. The date n business days after (or, for negative n, before) a start date. The start date is day 0 and never counted; n = 0 returns the date itself if it is a business day, otherwise the next one. Lists every non-business day skipped and why. Uses the country's national public-holida
• business_days_between ~381 tokens
  FREE, unmetered. Business days between two dates. business_days counts (from, to] and is negative when to is before from, so add_business_days(from, business_days) lands on to whenever to is a business day; business_days_inclusive counts both ends. Also returns weekend days and the public holidays i
• charge_sale Moves money · ~558 tokens
  PAID ($0.50). Charge this sale: should this invoice carry VAT, which country's and how much - place of supply under the EU, UK and South Africa rules, net/VAT/gross, registration threshold, rule cited. Omit buyer_country for single-country rate maths. Anything we cannot answer in full is refused fre
• charge_sale_certified Moves money · ~543 tokens
  PAID ($0.75). The charge_sale dossier plus an Ed25519-signed certified extract of the governing VAT rate, for a filing. Refused free when the governing source cannot be certified right now. Anything we cannot answer in full is refused free (coverage_gap, no_charge). Shares the 3 free calls per IP pe
• check_minimum_wage ~549 tokens
  PAID ($0.02). Compliance verdict: is a salary at, above or below the country's statutory minimum wage? Returns verdict, margin, the statutory floor and the legal instrument it rests on. Honest statuses when no enforceable floor exists or the period doesn't match the floor's period (cross-period conv
• compare_series ~287 tokens
  PAID ($0.02). One series (e.g. vat, policy-rate, minimum-wage, corporate-tax) across up to 10 countries of this brand in one call; each row carries its own source, dates and labels, and countries without the series are listed under missing. Malformed requests are refused free. Pass api_key if you ha
• compute_employment_cost ~708 tokens
  PAID ($0.05). Cost to employ: prices every statutory contribution on both the employee and employer sides for a gross salary, returning line-by-line amounts with instrument citations and an explicit refused list for schemes that could not be priced (unknown, not zero). Does NOT compute income tax —
• compute_income_tax ~568 tokens
  PAID ($0.02). Statutory income tax on a TAXABLE-income figure using the country's verified marginal bracket schedule, with full per-bracket workings, effective rate and marginal rate. You pass the amount in local currency. IMPORTANT: this is tax on taxable income, NOT net take-home pay — reliefs/all
• compute_statutory_interest ~672 tokens
  PAID ($0.02). Simple statutory interest on a principal at the cited statutory-interest series rate: Actual/365 simple, principal × (rate/100) × (days/365). Pass days, or from and to as YYYY-MM-DD (from inclusive, to exclusive). If both are sent and disagree, the call is refused free. A series with n
• compute_vat ~511 tokens
  PAID ($0.01). VAT breakdown for an amount: net, tax and gross using the country's current statutory rate, including per-levy components where the rate is composite (e.g. Ghana VAT + NHIL + GETFund). mode=add treats the amount as net; mode=extract backs VAT out of a gross amount. Pass api_key if you
• cost_hire ~607 tokens
  PAID ($0.50). Cost this hire: one cited dossier for a salary - wage-floor verdict, employer and employee contributions (or PAYE net pay for NG/KE), employer cost, optional income tax on taxable_income and first working day on or after start_date. Countries here: DE, ES, GB, IT, PL. Anything we canno
• count_working_days ~562 tokens
  PAID ($0.002). Working days in a date range for a country: weekends (Egypt's Fri–Sat handled) and statutory public holidays applied, with the holidays hit by name and the next working day after the range. Range max 366 days. Pass api_key if you have one (instant card checkout at /pricing); otherwise
• evidence_pack ~498 tokens
  PAID ($0.25). Country evidence pack: the full cited country brief plus up to 3 Ed25519-signed certified extracts (default the first certifiable of vat, policy-rate, minimum-wage). Named series must all be certifiable. Anything we cannot answer in full is refused free (coverage_gap, no_charge). Share
• get_calendar ~302 tokens
  FREE, unmetered. GET /v1/calendar for this brand's continent. Optional country (ISO 3166-1 alpha-2) and series. Derives reverify_by from last_confirmed + update_cycle_days (the same window that sets stale) and, only when current.effective_to is a non-empty string, next_effective_known with basis eff
• get_changes ~296 tokens
  FREE unmetered change + freshness feed. After any paid series or answer call, call this before you assume the cached value is still the law. Returns every series whose current value took effect on or after `since` (default last 30 days), newest first, each with last_confirmed and stale, PLUS a datas
• get_country_brief ~301 tokens
  PAID ($0.01). Country brief: every reference series we hold for one country (policy rate, VAT/GST, CPI, taxes, minimum wage, holidays...) in one call, each with value, unit, effective and last-confirmed dates, official source and confidence label. Cheaper than buying the series one by one. Pass api_
• get_filing_deadlines ~568 tokens
  PAID ($0.003, same as any series). Recurring statutory tax deadlines for a country — VAT/GST returns and payments, PAYE/payroll withholding remittances, corporate income tax returns and provisional/instalment payments — as RULES, each cited to the official source with the verbatim phrase that states
• get_key_balance ~131 tokens
  FREE. Remaining allowance for an API key (free, card or metered): plan, quota, used, remaining, reset date and what the key covers. Never metered. Pass api_key, or send the key as the X-API-Key header on /mcp.
• get_public_holidays ~288 tokens
  FREE. Official public-holiday calendar for a supported country, including gazetted movable holidays, with the official government source cited. Some countries also carry sub-national calendars (e.g. the German Laender): the `subdivisions` field lists them, and passing `subdivision` (ISO 3166-2, e.g.
• get_public_holidays_worldwide ~444 tokens
  FREE with any API key, including the free key by email (https://euroref.dev/free-key). Same as get_public_holidays, but for every country across all seven brands, not only European. Unmetered: never counts against the key's allowance. Pass api_key, or send the key as the X-API-Key header on /mcp.
• get_series ~325 tokens
  PAID ($0.003). Current value of a reference series — e.g. series=policy-rate, vat, minimum-wage. Every value carries its official source citation, effective date, last-confirmed date and staleness flag. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains
• get_series_history ~327 tokens
  PAID ($0.003). Historical values of a reference series with effective date ranges, optionally filtered by from/to (YYYY-MM-DD). Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every DE series is free to try. After a 200, bind get
• get_snapshot ~171 tokens
  PAID ($0.02). Snapshot of every series for every country in one call. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every DE series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Registe
• hire_compare ~541 tokens
  PAID ($0.75 for 2 countries, $1.00 for 3-5). Employer cost, employer and employee contributions, on-cost percent and wage-floor verdict side by side and ranked, every figure cited. Countries (any brand): AE, AU, CA, DE, ES, GB, IT, MX, PL, US. Gross is in each country's own currency; currencies are
• invoice_payable ~683 tokens
  PAID ($0.40). Is this invoice overdue, by how many days, and how much statutory late-payment interest is owed (Actual/365 simple, rate and workings cited). Late-payment regime: AT, BE, BG, CY, DE, DK, EE, ES, FI, FR, GB, GR, HR, IE, IT, LT, LU, LV, MT, NL, PL, PT, SE, SI, SK; statutory interest only
• is_business_day ~331 tokens
  FREE, unmetered. Is this date a business day in this country? Returns is_business_day, the reason (weekend, public_holiday, makeup_workday…), the holiday names, and the next and previous business day. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Friday+Sat
• list_series ~335 tokens
  FREE. Catalog of all euroref reference-data series: supported countries, series ids, descriptions, freshness metadata and per-series URLs. Call this first to discover what data exists. Paid answer tools accept receipt=true (included in the answer price, no extra USDC) and, on a paid success, return
• next_filings ~534 tokens
  PAID ($0.35). Upcoming VAT, PAYE and corporate-tax due dates in a window (default the next 90 days), rolled for weekends and national public holidays, each rule cited. Countries with verified rules here: CH, CZ, DE, DK, ES, FI, FR, GB, IE, IT, LU, NL, NO, PL, PT, RO, SE, TR. Anything we cannot answe
• register_alert ~536 tokens
  Bind a webhook so the next gazette does not silently stale a value you already paid for. REGISTERING IS FREE. Register: $0 · Delivery after trial: $0.05. First 3 deliveries are free; later deliveries are $0.05 and refunded if the webhook fails to send. HMAC-SHA256 signed. Two watch types on the same
• settlement_date ~798 tokens
  PAID ($0.02). Settlement/value date: the date n business days after a trade date, computed on the INTERSECTION of the calendars you name, with a per-day trail showing every skipped day and why, on which calendar. Supply business_days for a cycle you are trading under, or market + instrument_class to
• validate_tax_id ~374 tokens
  PAID ($0.003). Offline format and check-digit validation of a business tax ID or VAT number for one country of this brand: valid/invalid, normalised form, id type, check level (checksum only where the authority publishes the algorithm) and why it failed, with official sources. Does not confirm regis
• verify_answer_receipt ~493 tokens
  FREE. Verify an answer receipt (kind answer_receipt) with the Ed25519 public key only. Pass the receipt object or its canonical JSON, signature_value when the signature is not inside the receipt, and public_key_pem to verify offline. If public_key_pem is omitted, the tool may GET signature.public_ke

Browse

• Email
• Calendars
• Payments
• Invoicing and accounting

Related MCP servers

• Reference Data
  Oceania govt data, cited: rates, VAT, tax, wages, holidays, FX. 8 countries; Australia free.
• Reference Data
  Asian govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 28 countries; Japan free.
• Reference Data
  LatAm govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 22 countries; Brazil free.
• Reference Data
  Mid-East govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 9 countries; UAE free.
• Reference Data
  N American govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 10 countries; USA free.
• Afriref: cited government reference data
  Cited official data: tax, VAT, CPI, policy rates, wages, holidays, FX. 128 countries+EU, 7 regions.
• Refnusa
  Indonesia reference data: holidays, wages, regions, postal codes, tax, food prices, KBLI, BPS stats
• A.U.G.U.R Foresight · World
  Weather, geocoding, FX rates, holidays, time zones, countries, earthquakes, sun and moon.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/dev.euroref/reference-data.svg)](https://aptlynx.net/servers/dev.euroref/reference-data)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents