Agents Index

euroref — European government reference data

Online

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

Visit publisherConnectJSON

What it can do: 33 tools

  • list_series read-onlyFREE. 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=tr
  • get_public_holidays read-onlyFREE. 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):
  • get_public_holidays_worldwide read-onlyFREE 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 ke
  • get_key_balance read-onlyFREE. 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.
  • is_business_day read-onlyFREE, 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
  • add_business_days read-onlyFREE, 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 e
  • business_days_between read-onlyFREE, 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
  • get_series read-onlyPAID ($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 y
  • get_series_history read-onlyPAID ($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 exp
  • get_filing_deadlines read-onlyPAID ($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 —
  • check_minimum_wage read-onlyPAID ($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 enforceabl
  • compute_vat read-onlyPAID ($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 a
  • count_working_days read-onlyPAID ($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 d
  • settlement_date read-onlyPAID ($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
  • compute_income_tax read-onlyPAID ($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 currenc
  • compute_statutory_interest read-onlyPAID ($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 excl
  • compute_employment_cost read-onlyPAID ($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 sche
  • cost_hire read-onlyPAID ($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 d
  • charge_sale read-onlyPAID ($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
  • charge_sale_certified read-onlyPAID ($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 f
  • invoice_payable read-onlyPAID ($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,
  • invoice_check read-onlyPAID ($0.60). Check an invoice in one call: is the VAT right (place of supply, rate, expected amount vs vat_charged), is it overdue and how much statutory late interest is owed, and do seller/buyer tax IDs pass the offic
  • evidence_pack read-onlyPAID ($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. An
  • hire_compare read-onlyPAID ($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,
  • next_filings read-onlyPAID ($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,
  • verify_answer_receipt read-onlyFREE. 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 ve
  • get_snapshot read-onlyPAID ($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.
  • get_country_brief read-onlyPAID ($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 s
  • compare_series read-onlyPAID ($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 l
  • validate_tax_id read-onlyPAID ($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
  • get_changes read-onlyFREE 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` (defau
  • get_calendar read-onlyFREE, 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
  • register_alertBind 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 refund

Connect it

Claude Code
claude mcp add --transport http euroref-european-government-reference-da https://euroref.dev/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://euroref.dev/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "euroref-european-government-reference-da": {
      "url": "https://euroref.dev/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "euroref-european-government-reference-da": {
      "type": "http",
      "url": "https://euroref.dev/mcp"
    }
  }
}

Questions

What does euroref — European government reference data do?

European govt data, cited: rates, VAT, tax, wages, holidays, FX. 34 countries + EU; Germany free. It exposes 33 tools to AI assistants.

What tools does euroref — European government reference data provide?

33 tools, including list_series, get_public_holidays, get_public_holidays_worldwide, get_key_balance, is_business_day, add_business_days, business_days_between, get_series, get_series_history, get_filing_deadlines, check_minimum_wage, compute_vat….

How do I connect euroref — European government reference data to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://euroref.dev/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does euroref — European government reference data require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is euroref — European government reference data online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes euroref — European government reference data?

euroref.dev. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Finance & Payments