# ECB Discovery MCP

> ECB Discovery provides universal access to the European Central Bank's statistical data catalog. It lets you browse every available dataset—from exchange rates and monetary aggregates to banking supervision—and query any specific piece of financial data using custom keys. You get a single endpoint for all ECB statistics.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** economic-data, sdmx, statistical-catalog, eurozone-data, financial-reporting, data-query

## Description

This MCP connects your agent directly to the full suite of European Central Bank (ECB) economic data. Instead of navigating dozens of separate ECB portals, you can treat them all like one massive, queryable database. First, you use the available catalog tool to see every code and description for datasets, whether they cover financial markets or payment statistics. Once you know the dataset's code, you run the main query function, providing the specific dataflow ID and a detailed SDMX series key. Your agent handles the complexity of mapping these codes and keys into usable economic data, giving you everything from historical USD/EUR exchange rates to complex monetary aggregates like M1/M2/M3. Vinkius puts this entire catalog at your fingertips, letting your AI client pull highly specific time-series metrics directly into your workflow.

## Tools

### list_dataflows
Use this tool to get a complete list of all available codes for ECB statistical datasets, like 'EXR' or 'BSI'.

### query_ecb_data
Execute queries against any specific dataset by providing the code and the detailed SDMX series key to pull actual data.

## Prompt Examples

**Prompt:** 
```
What ECB datasets are available?
```

**Response:** 
```
📋 **ECB Dataflows**

| Code | Description |
|------|-------------|
| EXR | Exchange Rates |
| FM | Financial Markets |
| BSI | Balance Sheet Items (M1/M2/M3) |
| MIR | MFI Interest Rates |
| YC | Yield Curves |
| BKN | Banknotes |
| CBD | Consolidated Banking Data |
| SEC | Securities Issues |
| STP | Payment Statistics |

...and many more
```

**Prompt:** 
```
Query the Balance Sheet Items (BSI) dataset.
```

**Response:** 
```
I successfully queried the BSI dataset. Here is a summary of the latest balance sheet components and their outstanding amounts for the Euro area, indicating M1, M2, and M3 broad monetary aggregates status.
```

**Prompt:** 
```
Extract the latest MFI Interest Rates.
```

**Response:** 
```
The latest MFI Interest Rates (MIR) report has been fetched. The average annualized interest rate for household deposits with an agreed maturity of up to one year has been extracted and tabulated for you.
```

## Capabilities

### Browse the full ECB statistical catalog
You can list every available dataflow code (like EXR or FM) to understand what kind of economic statistics the ECB collects.

### Query specific financial metrics
You run complex queries by providing a known dataset code and an exact SDMX key to pull precise time-series data points.

### Access monetary aggregates
The MCP pulls detailed historical data for major money supply components, such as M1, M2, and M3.

### Track currency exchange rates
You retrieve daily or period-specific foreign exchange rate movements between currencies like USD and EUR.

## Use Cases

### Comparing currency shifts over time
A portfolio manager needs to see the historical USD/EUR rate changes alongside major financial market movements. They first use `list_dataflows` to confirm 'EXR' is available, then use `query_ecb_data` with two specific keys to pull both data streams into one comparison chart.

### Analyzing monetary policy impact
An academic researcher wants a longitudinal study of M1/M2 growth. They query the 'BSI' dataset using `query_ecb_data` to get consistent data on monetary aggregates, ensuring their findings are based on standardized ECB metrics.

### Drafting a banking supervision report
An analyst needs to compile recent balance sheet data for multiple Eurozone banks. They use the catalog tool to identify 'BSI' and then run `query_ecb_data` repeatedly with different key identifiers to build a comprehensive industry overview.

### Tracking payment system volume
A fintech developer needs real-time data on cross-border transactions. They use the catalog tool, identify 'STP' for Payment Statistics, and then query that specific dataset to track transaction volumes over a period.

## Benefits

- Stop wasting time on multiple government sites. You get a single, unified source for all European Central Bank data, dramatically cutting research overhead.
- The ability to use the `list_dataflows` tool means you don't have to guess which dataset holds your information; you see the entire catalog first.
- It handles complex SDMX keys. Instead of writing messy API calls, you just name the series key and pull precise time-series data for anything from banking items to payment stats.
- You get access to core monetary metrics—like M1/M2/M3 aggregates or specific interest rates (MIR)—without needing specialized economic knowledge on how to structure the request.
- The MCP allows your agent to process raw, highly structured financial data. This means you're getting clean inputs for modeling, not just PDFs and screenshots.

## How It Works

The bottom line is that you skip manual website navigation and jump straight from question to structured economic answer.

1. First, you call the catalog tool to list all available ECB dataflow codes (e.g., EXR, BSI). This tells you exactly what datasets exist.
2. Next, you use a known code and specify your exact required metric using an SDMX key format. The agent combines these inputs to form the query.
3. Finally, the MCP returns a structured dataset containing the requested time-series data points directly for analysis.

## Frequently Asked Questions

**How do I know what datasets are available using ECB Discovery — Universal Statistical Data Access MCP?**
You use the `list_dataflows` tool. This function runs first, giving you a comprehensive list of all available dataflow codes (like EXR or FM) that you can reference later.

**What is the difference between `list_dataflows` and `query_ecb_data`?**
`list_dataflows` only gives you the list of available codes. You need to use `query_ecb_data` afterward, providing one of those codes plus a specific key, to actually get data.

**Can this MCP pull data for non-Eurozone currencies?**
Yes, the tool supports foreign exchange rates. You can use `query_ecb_data` with the appropriate code and keys to track various currency pairs.

**Does ECB Discovery — Universal Statistical Data Access MCP handle different date formats?**
The underlying mechanism handles standard SDMX time series formats. As long as you provide a valid key, it returns structured data that your agent can process regardless of the initial input format.

**What if I don't know the specific dataflow code?**
Don't worry. Start by calling `list_dataflows` first. This catalog tool helps you identify the correct code (e.g., BSI) before attempting to query it.