# nexusforge-tools/mcp-eu-finance [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/nexusforge-tools/mcp-eu-finance  
**GitHub Stars:** 1  
**npm Downloads (last month):** 350  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/nexusforge-tools-mcp-eu-finance

## Description
MCP server for European financial data — ECB rates, Eurostat inflation, GDP, unemployment. Works with Claude, Cursor, Windsurf.

## Tools
Capabilities this server exposes over MCP:

- **get_ecb_rates** — Fetches the three ECB key interest rates from the ECB Statistical Data Warehouse (SDMX). Returns a JSON object with `rates` containing three entries — `deposit_facility`, `main_refinancing`, and `marginal_lending` — each with `date` (YYYY-MM-DD of the last rate change) and `value` (percentage as a number). Also includes `source` and `retrieved_at` as ISO 8601. Results are cached for 1 hour. USAGE: These are ECB policy rates, not real-time market rates — they only change at Governing Council meetings (roughly every 6 weeks). The `date` field indicates when the current rate was set, not today's date. For currency conversion use get_euro_exchange; these rates are not applicable for forex calculations. Use get_eu_inflation alongside this tool to assess the real interest rate (nominal rate minus inflation).
- **get_euro_exchange** — Fetches EUR exchange rates against other currencies from the ECB via Frankfurter API. Returns a JSON object with: `base` ("EUR"), `date` (YYYY-MM-DD of the rate), `rates` (object mapping 3-letter currency codes to numeric values representing how many units of that currency equal 1 EUR), `source`, and `retrieved_at` as ISO 8601. Latest rates are cached 1 hour; historical rates are cached permanently. USAGE: Supports 33 currencies including USD, GBP, JPY, CHF, CNY, SEK, PLN, and others. Omit `date` for the latest available rates. Provide `date` in YYYY-MM-DD format for historical rates (available from 1999-01-04). These are ECB reference rates published at ~16:00 CET — not real-time mid-market rates; expect small spreads vs live quotes. Requests for weekends or ECB holidays return the previous business day's rates. Returns an error for dates before 1999-01-04 or future dates.
- **get_eu_inflation** — Fetches HICP (Harmonised Index of Consumer Prices) annual inflation rates for EU countries from Eurostat (dataset: prc_hicp_manr). Returns a JSON object with: `data` (array of objects containing `country` as full name, `period` in YYYY-MM format, and `rate` as a numeric annual percentage change), `unit` ("Annual rate of change (%)"), `source`, and `retrieved_at` as ISO 8601. Defaults to the latest single month for all 29 EU members and aggregates. Data is cached 24 hours. USAGE: HICP is the EU-harmonised inflation standard used by the ECB for monetary policy — use it (not national CPI) for cross-country comparisons. Use country code EA for the Eurozone aggregate or EU27_2020 for the full EU-27 aggregate. Typical data lag is 30-45 days after the reference month. Set periods=12 to retrieve a 12-month trend. Pair with get_ecb_rates to contextualize how the ECB policy rate relates to current inflation.
- **get_eu_gdp** — Fetches quarterly GDP data for EU/Eurozone countries from Eurostat (dataset: namq_10_gdp). Returns a JSON object with: `data` (array of objects, each containing `country` as a full name string, `period` in YYYY-Qq format e.g. "2024-Q3", `value` as a number, and `unit` as a string label), `source`, and `retrieved_at` as ISO 8601. Defaults to year-on-year growth rate (%) for EA20, EU27_2020, DE, FR, IT, ES over the last 4 quarters. Data is cached 24 hours. Missing periods are omitted from the array (not returned as null). USAGE: Use unit=CLV_PCH_SM (default) for cross-country growth comparisons. Use unit=CP_MEUR to compare absolute GDP size. Use unit=CLV_PCH_PRE for quarter-on-quarter momentum. Use unit=CLV10_MEUR for real GDP volume excluding price effects. Typical Eurostat data lag is 60-90 days after quarter end — the most recent quarter may be absent. Request quarters=8 or more for recession analysis or multi-year trend charts.
- **get_eu_unemployment** — Fetches monthly unemployment rates for EU countries from Eurostat (dataset: une_rt_m), seasonally adjusted, as a percentage of the active population. Returns a JSON object with: `data` (array of objects containing `country` as full name, `period` in YYYY-MM format, `rate` as a numeric percentage, `age_group`, and `sex`), `unit` ("Percentage of active population (%)"), `source`, and `retrieved_at` as ISO 8601. Defaults to TOTAL age group for EA20, EU27_2020, DE, FR, IT, ES, PL, NL over the last 3 months. Data is cached 24 hours. USAGE: Use age=Y15-24 for youth unemployment, which is typically 2-3x the overall rate. Data is seasonally adjusted (SA) — do not apply additional seasonal correction. Typical Eurostat lag is 30-60 days after the reference month. Set months=12 or more for trend and cyclical analysis. Non-EU countries (e.g. US, UK) are not available — use this tool only for EU member states and EA20/EU27_2020 aggregates.
- **compare_eu_economies** — Fetches the latest inflation, GDP growth, and unemployment for 2-10 EU countries in a single parallel call to Eurostat. Returns a JSON object with: `countries` (array of per-country snapshots, each containing `country` as full name, `country_code`, `inflation` as `{rate, period}` or null, `gdp_growth` as `{rate, period}` or null, `unemployment` as `{rate, period}` or null), `source`, and `retrieved_at` as ISO 8601. Each indicator returns the single most recent available value. Inflation period is YYYY-MM; GDP period is YYYY-Qq; unemployment period is YYYY-MM. Data is cached 24 hours. USAGE: Prefer this tool over calling get_eu_inflation, get_eu_gdp, and get_eu_unemployment separately when building dashboards or running multi-indicator comparisons — it reduces latency by parallelizing the three Eurostat requests. Each indicator's period may differ due to different Eurostat release schedules (inflation lags ~30 days, GDP ~90 days). An indicator field is null when Eurostat has not published recent data — always handle null gracefully. Use the `indicators` parameter to skip unneeded metrics and reduce API calls.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-eu-finance": {
    "command": "npx",
    "args": ["-y","@nexusforgetools/eu-finance"]
  }
}
```

## Documentation

## What nexusforge-tools/mcp-eu-finance does

The nexusforge-tools/mcp-eu-finance MCP server exposes European monetary and macroeconomic data as callable MCP tools. It covers the European Central Bank’s main policy rates, EUR exchange rates, Eurostat inflation, GDP, and unemployment datasets. The package is intended for questions that require structured figures rather than general financial commentary.

Available data includes the ECB deposit facility, main refinancing, and marginal lending rates. Exchange-rate queries return EUR values against a selected currency and can target either the latest available figure or a specific date. Eurostat-backed tools cover annual HICP percentage changes, quarterly GDP figures or growth rates, and seasonally adjusted monthly unemployment by age group.

The comparison tool combines inflation, GDP, and unemployment into a side-by-side view for between two and ten countries. This supports country comparisons without requiring an agent to make separate calls and assemble the results itself.

## How it works

The server communicates over MCP and makes the listed data operations available to compatible clients. The underlying sources identified by the project are ECB SDW for ECB rates, ECB or Frankfurter for exchange rates, and Eurostat for inflation, GDP, and unemployment.

A client can ask for a single indicator, request a historical exchange rate, or compare several EU economies. The tool descriptions indicate that country-level inflation, GDP, and unemployment coverage applies across EU countries. Results depend on the availability and update schedule of those upstream public data sources.

## Setup and configuration

The nexusforge-tools/mcp-eu-finance MCP server can be launched locally from npm with:

```bash
npx -y @nexusforgetools/eu-finance
```

For Claude Desktop, Cursor, or Windsurf, add an MCP entry with `npx` as the command and `-y`, followed by `@nexusforgetools/eu-finance`, as the arguments. Claude Code has a corresponding `claude mcp add` command in the project instructions.

No API key or other credential is listed as required.

## Tools and capabilities

- `get_ecb_rates`: Retrieves the ECB deposit facility, main refinancing, and marginal lending rates.
- `get_euro_exchange`: Looks up EUR exchange rates against a requested currency for the latest date or a specified historical date.
- `get_eu_inflation`: Returns annual HICP inflation percentages for EU countries.
- `get_eu_gdp`: Returns quarterly GDP as a growth rate or an absolute value.
- `get_eu_unemployment`: Returns monthly, seasonally adjusted unemployment rates with age-group selection.
- `compare_eu_economies`: Produces a combined inflation, GDP, and unemployment snapshot for 2–10 countries.

These capabilities fit macroeconomic research, country monitoring, and agent workflows that need to compare European economies using consistent indicator categories.

## Limitations and notes

The project does not list authentication settings, custom environment variables, or options for connecting private financial datasets. Its documented scope is European financial and macroeconomic information; it does not claim to provide investment recommendations, portfolio management, or real-time market feeds beyond the supported indicators.

The README labels the software as being free during beta and signals a possible paid Pro tier later. Exchange-rate data may come from ECB or Frankfurter, while the other indicators are attributed to ECB or Eurostat sources as described above.

_Full upstream README: https://allmcps.com/mcp/nexusforge-tools-mcp-eu-finance/readme_

