# OECD Data API MCP

> OECD Data API lets your AI client query global economic indicators and social statistics directly through natural language conversation. Access authoritative data from thousands of OECD identifiers, instantly auditing regional trends or historical fiscal metrics without ever touching a complex statistical portal.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** macroeconomics, statistical-indicators, policy-research, fiscal-data, sdmx, data-visualization

## Description

Need to run macroeconomics research? This MCP connects your agent to the OECD Data API, giving you access to global economic indicators and social statistics. You stop spending hours logging into multiple data portals and figuring out which dataset ID you need. Instead, you just talk to your AI client. Your agent handles all the complexity: it finds the right historical series, pulls current regional comparisons, and structures the results for immediate use. Everything is verified against the OECD's authoritative source. Because Vinkius hosts this API, you connect once from any MCP-compatible client (Claude, Cursor, Windsurf, etc.) and gain access to this full suite of global data tools.

Your agent acts like a real-time research analyst. It can audit long-term shifts in social indicators or compare fiscal health across different regions—all without you needing to know the specific code for each variable.

## Tools

### check_api_status
Confirms that the OECD data service is online and ready to accept research queries.

### get_oecd_dataset
Pulls specific economic or social numbers using a known OECD dataset ID.

### list_oecd_dataflows
Provides an exhaustive list of all available data types and datasets in the full OECD catalog for research discovery.

## Prompt Examples

**Prompt:** 
```
Get quarterly national accounts (QNA) data from OECD.
```

**Response:** 
```
I've retrieved the QNA dataset! The latest observations show a growth trend of [Value] across member countries. I can provide the full statistical breakdown or specific regional metadata for you.
```

**Prompt:** 
```
List all available dataflows in the OECD catalog.
```

**Response:** 
```
I've scanned the OECD dataflow catalog! There are hundreds of series available, including markers for education, health, and fiscal policy. I can help you retrieve a specific dataset ID for any of these thematic markers.
```

**Prompt:** 
```
What are the latest observations for the 'CPI' dataset in the OECD?
```

**Response:** 
```
I've retrieved the CPI observations! The recent data points indicate an inflation trend of [Value] for [Period]. I can assist you with an audit of the comparative metadata across different OECD regions if you'd like.
```

## Capabilities

### Audit global datasets
Retrieves high-resolution statistical data points for thousands of OECD identifiers, letting you track deep economic changes.

### Query historical indicators
Checks long-term social and fiscal metrics to understand the development pattern or scale distribution over time.

### Browse data structures
Lists all available dataflows within the OECD catalog so you can identify relevant research markers before querying specific numbers.

## Use Cases

### Comparing post-pandemic recovery rates
A policy analyst needs to compare national accounts (QNA) growth across three countries. Instead of pulling three separate reports, they ask their agent for 'QNA data comparing X, Y, and Z from 2019 onward.' The MCP then uses `get_oecd_dataset` to pull the specific numbers and give a comparative summary.

### Finding indicators for a new market report
A journalist writes about developing economies and needs to know what metrics are available. They ask their agent to 'List all relevant dataflows related to education or infrastructure.' The MCP uses `list_oecd_dataflows` to provide a catalog, allowing the journalist to narrow down their focus instantly.

### Validating long-term inflation claims
An economist is arguing about historical inflation trends. They ask their agent for 'CPI observations across OECD regions in the 1980s.' The MCP retrieves this complex, multi-regional data using `get_oecd_dataset`, giving them verifiable proof points.

### Setting up a research pipeline
Before starting, an operations lead wants to make sure the connection is live. They use `check_api_status` first. This quick check confirms that their entire cross-functional team's workflow will run smoothly when they start querying data.

## Benefits

- Stop manual data hunting. Instead of logging into multiple government sites, your agent handles complex statistical searches using the OECD's authoritative dataset.
- Audit long-term trends instantly. You can check historical social and fiscal indicators to understand multi-decade economic scale changes without writing SQL queries.
- Always know where you are. Use `list_oecd_dataflows` to browse every available data type in the catalog, ensuring you don't miss a relevant research marker.
- Verify your findings immediately. The agent retrieves accurate observations for any given period and region, so your intelligence is always precise and sourced correctly.
- Keep your workflow moving. You can use `check_api_status` to confirm the service is operational before starting a major research project.

## How It Works

The bottom line is that you talk to your AI client like talking to a data analyst; it handles the complex statistical searches behind the scenes.

1. Subscribe to this MCP in Vinkius. You won't need an API key because the OECD REST API is a free, open service.
2. Connect your preferred agent (like Claude or Cursor) to the MCP via Vinkius.
3. Tell your agent what you need—for example, 'What were the QNA growth rates in Brazil vs. Germany between 2015 and 2020?' Your agent sends the query, retrieves the numbers, and reports back.

## Frequently Asked Questions

**What is the scope of OECD Data API? Does it cover private company financials?**
No, this MCP only accesses official global social and economic indicators published by the OECD. It cannot retrieve proprietary or private company financial data.

**How do I check if the service is working before starting a project with OECD Data API?**
You run the `check_api_status` tool first. This simple action confirms that the entire OECD REST API connection is live and ready for your complex queries.

**Can I use the OECD Data API to compare multiple countries in one go?**
Yes, you can ask your agent to pull comparative data. The MCP uses `get_oecd_dataset` to retrieve specific metrics across several member states simultaneously for direct comparison.

**Do I need an API key to use the OECD Data API?**
No, you don't. This MCP connects to a free and open service provided by the OECD, so there are no keys required for setup.