OECD MCP Server


A Model Context Protocol (MCP) server providing AI assistants access to OECD's 5,000+ economic and statistical datasets via SDMX API. By connecting to the MCP server, you can use AI to search, analyze, and compare data from 38 OECD countries across economy, health, education, environment, and more.

En Model Context Protocol (MCP) server som ger AI-assistenter tillgång till OECD:s 5,000+ ekonomiska och statistiska dataset via SDMX API. Genom att ansluta till MCP-servern kan du med hjälp av AI söka, analysera och jämföra data från 38 OECD-länder inom ekonomi, hälsa, utbildning, miljö och mer.

---

# Quick Start

Det är enkelt att ansluta en LLM / AI-chatbot till MCP-servern. Anslut antingen direkt till den hostade servern (enkelt och smidigt) eller installera lokalt. Nedan finner du guider för olika klienter.

It's easy to connect an LLM / AI chatbot to the MCP server. Connect either directly to the hosted server (simple and convenient) or install locally. Below you'll find guides for different clients.

---

# # 1. AI Chatbots (Web)

1. Open settings and enable Developer Mode
2. Go to Connectors → Add Connection
3. Enter URL: https://oecd-mcp.onrender.com/mcp
4. Click Connect

# # # Video Guide

1. Go to https://claude.ai and log in
2. Click your profile (bottom left) → Settings
3. Go to Developer or Integrations
4. Click Add MCP Server or Connect
5. Name: OECD, URL: https://oecd-mcp.onrender.com/mcp
6. Click Connect

# # # Video Guide

https://github.com/user-attachments/assets/Claude-Web-MCP-guide.mp4

---

# # 2. Local Installation

1. Clone and build:

git clone https://github.com/isakskogstad/OECD-MCP.git
cd OECD-MCP
npm install && npm run build

2. In Claude Desktop:

• Settings → Developer (not Connectors!)
• Click "Edit Config"

3. Add to the JSON file:

{
  "mcpServers": {
    "oecd": {
      "command": "node",
      "args": ["/absolute/path/to/OECD-MCP/dist/index.js"]
    }
  }
}

4. Save and restart Claude Desktop

Note: Local installation uses stdio transport via the Developer section, not Connectors.

Remote Server:

claude mcp add - -transport http oecd https://oecd-mcp.onrender.com/mcp

Local (from source):

#  After git clone and npm install (see above)
claude mcp add oecd node /absolute/path/to/dist/index.js

Verify: claude mcp list

# # # Remote Server (HTTP)

~/.codex/config.toml:

[mcp.oecd]
url = "https://oecd-mcp.onrender.com/mcp"
transport = "http"

# # # Local Installation

1. Clone and build (if not already done):

git clone https://github.com/isakskogstad/OECD-MCP.git
cd OECD-MCP
npm install && npm run build

2. Configure stdio transport:

~/.codex/config.toml:

[mcp.oecd]
command = "node"
args = ["/absolute/path/to/OECD-MCP/dist/index.js"]
transport = "stdio"

Windows:

[mcp.oecd]
command = "node"
args = ["C:\\Users\\username\\OECD-MCP\\dist\\index.js"]
transport = "stdio"

---

# Features

Servern ansluter till OECD SDMX API och ger tillgång till 5,000+ dataset i 17 kategorier.

OECD SDMX API
Tillgång till kvartalsvis nationalräkenskaper (QNA), huvudsakliga ekonomiska indikatorer (MEI), hälsostatistik, utbildningsdata, miljöindikatorer och mer från 38 OECD-medlemsländer plus partnerekonomier.

MCP-servern implementerar MCP-protokollet med stöd för:

• 9 verktyg — Dataset-upptäckt (5) och dataåtkomst (4)
• 7 resurser — Kategorier, länder, filterguide, ordlista, LLM-instruktioner
• 7 promptmallar — Ekonomisk analys, landsjämförelser, nordiskt fokus

The server connects to the OECD SDMX API providing access to 5,000+ datasets across 17 categories:

OECD SDMX API
Access to quarterly national accounts (QNA), main economic indicators (MEI), health statistics, education data, environmental indicators, and more from 38 OECD member countries plus partner economies.

The MCP server implements the MCP protocol with support for:

• 9 tools — Dataset discovery (5) and data access (4)
• 7 resources — Categories, countries, filter guide, glossary, LLM instructions
• 7 prompt templates — Economic analysis, country comparisons, Nordic focus

# # Tools

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| search_dataflows | Search for datasets by keyword |
| list_dataflows | List datasets by category |
| get_categories | List all 17 data categories |
| get_popular_datasets | Get commonly used datasets |
| search_indicators | Search for specific indicators |
| get_data_structure | Get metadata for a dataset |
| query_data | Query statistical data |
| get_dataflow_url | Generate OECD Data Explorer link |
| list_categories_detailed | Detailed category information |

# # Resources

| Resource | Description |
|- -- -- -- -- -|- -- -- -- -- -- --|
| oecd://categories | 17 data categories with descriptions |
| oecd://dataflows/popular | Curated popular datasets |
| oecd://countries | ISO 3166-1 alpha-3 country codes |
| oecd://filter-guide | SDMX filter syntax guide |
| oecd://glossary | Definitions of OECD terms |
| oecd://llm-instructions | Instructions for AI assistants |
| oecd://api/info | API information |

# # Prompt Templates

| Prompt | Description |
|- -- -- -- -|- -- -- -- -- -- --|
| analyze_economic_trend | Analyze economic trends over time |
| compare_countries | Compare data between countries |
| get_latest_statistics | Get latest statistics |
| explore_dataset | Guided dataset exploration |
| find_data_for_question | Find the right dataset for a question |
| build_filter | Help building SDMX filters |
| nordic_comparison | Compare Nordic countries |

---

# Use Cases

# # Ekonomer & Forskare

Verktyg:

| Verktyg | Beskrivning |
|- -- -- -- --|- -- -- -- -- -- --|
| query_data | Fråga BNP, inflation, arbetslöshetsdata |
| search_dataflows | Hitta dataset för forskningsfrågor |
| get_data_structure | Förstå dataset-dimensioner |

Exempel:

• "Jämför BNP-tillväxt mellan G7-länderna 2020-2024"
• "Analysera inflationstrender i eurozonen"
• "Hitta data om arbetsproduktivitet per sektor"

App-exempel: Mobil ekonomisk brief med BNP-trender och jämförelsediagram.

---

# # Policyanalytiker

Verktyg:

| Verktyg | Beskrivning |
|- -- -- -- --|- -- -- -- -- -- --|
| get_categories | Bläddra i 17 policyområden |
| list_dataflows | Hitta relevanta policy-dataset |
| get_dataflow_url | Generera länkar för rapporter |

Exempel:

• "Vilken sjukvårdsutgiftsdata finns för Sverige?"
• "Hitta utbildningsresultatindikatorer för PISA-analys"
• "Jämför miljöpolicyer i nordiska länder"

App-exempel: Hälsostatistik-dashboard med donutdiagram och landjämförelser.

---

# # Datajournalister

Verktyg:

| Verktyg | Beskrivning |
|- -- -- -- --|- -- -- -- -- -- --|
| search_indicators | Hitta specifika mätvärden |
| get_popular_datasets | Få tillgång till ofta citerad data |
| query_data | Hämta siffror för artiklar |

Exempel:

• "Hämta senaste arbetslöshetssiffror för EU-länder"
• "Hitta inkomstojämlikhetsdata (Gini-koefficient)"
• "Jämför skatteintäkter som % av BNP"

App-exempel: Produktivitetsjämförelse med stapeldiagram och trendlinjer.

# # Economists & Researchers

Tools:

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| query_data | Query GDP, inflation, unemployment data |
| search_dataflows | Find datasets for research questions |
| get_data_structure | Understand dataset dimensions |

Examples:

• "Compare GDP growth between G7 countries 2020-2024"
• "Analyze inflation trends in the Eurozone"
• "Find data on labor productivity by sector"

App Example:

Mobile economic brief with GDP trends, G7 comparison charts, and sparkline visualizations from the QNA dataset.

---

# # Policy Analysts

Tools:

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| get_categories | Browse 17 policy areas |
| list_dataflows | Find relevant policy datasets |
| get_dataflow_url | Generate links for reports |

Examples:

• "What healthcare spending data is available for Sweden?"
• "Find education outcome indicators for PISA analysis"
• "Compare environmental policies across Nordic countries"

App Example:

Health statistics dashboard with donut chart overview and country comparison from the HEALTH_STAT dataset.

---

# # Data Journalists

Tools:

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| search_indicators | Find specific metrics |
| get_popular_datasets | Access commonly cited data |
| query_data | Get numbers for stories |

Examples:

• "Get latest unemployment figures for EU countries"
• "Find income inequality data (Gini coefficient)"
• "Compare tax revenues as % of GDP"

---

# # Data Categories

| Category | Code | Description | Datasets |
|- -- -- -- -- -|- -- -- -|- -- -- -- -- -- --|- -- -- -- -- -|
| Economy | ECO | GDP, growth, inflation, interest rates | 500+ |
| Employment | JOB | Labor market, wages | 300+ |
| Trade | TRD | International trade | 250+ |
| Health | HEA | Healthcare, life expectancy | 200+ |
| Education | EDU | PISA, outcomes | 180+ |
| Environment | ENV | Climate, emissions | 150+ |
| Innovation | STI | R&D, patents, AI | 140+ |
| Energy | NRG | Production, renewables | 120+ |
| Taxation | TAX | Tax revenues, tax rates | 100+ |
| Finance | FIN | Markets, banking | 95+ |
| Government | GOV | Governance, public sector | 90+ |
| Social | SOC | Inequality, quality of life | 85+ |
| Agriculture | AGR | Production, food security | 75+ |
| Industry | IND | Industrial production | 70+ |
| Development | DEV | Development aid | 60+ |
| Transport | TRA | Infrastructure, mobility | 50+ |
| Regional | REG | Subnational data | 45+ |

---

# About

Skapad av: Isak Skogstad

Kontakt: isak.skogstad@me.com

Fristående: Detta projekt är fristående och är inte anslutet till, godkänt av eller officiellt kopplat till OECD (Organisationen för ekonomiskt samarbete och utveckling).

Användarvillkor: Data tillhandahålls via OECD:s öppna SDMX API. Se OECD:s användarvillkor för användningsvillkor.

Created by: Isak Skogstad

Contact: isak.skogstad@me.com

Disclaimer: This project is independent and not affiliated with, endorsed by, or officially connected to the OECD (Organisation for Economic Co-operation and Development).

Terms of use: Data is provided via OECD's open SDMX API. See OECD Terms and Conditions for usage conditions.

---

# Resources

• OECD Data Portal: https://data.oecd.org/
• SDMX Standard: https://sdmx.org/
• MCP Documentation: https://modelcontextprotocol.io/
• npm Package: https://www.npmjs.com/package/oecd-mcp
• Issues: GitHub Issues

---

Built with Model Context Protocol SDK | Version 4.0.0