OECD MCP Server

Model Context Protocol server for OECD statistical data - Connect LLMs and AI assistants to 5,000+ economic datasets from the OECD via SDMX API.

OECD (Organisation for Economic Co-operation and Development) is an intergovernmental organisation with 38 member countries providing comprehensive economic and statistical data.

🚀 Quick Start

Remote Server (Recommended)

Use this URL in any MCP-compatible client:

https://oecd-mcp-server.onrender.com/mcp

No authentication required! Just paste the URL - works instantly with any MCP client.

Compatible with: ChatGPT, Claude Web, VS Code Copilot, Cursor, and 400+ MCP clients.

Local Installation

# Run directly with npx (recommended)
npx oecd-mcp

# Or install globally
npm install -g oecd-mcp
oecd-mcp

Requirements: Node.js >= 18.0.0

✨ Features

9 MCP Tools - Search, query, and analyze OECD data
5,000+ Datasets - Across 17 categories (economy, health, education, etc.)
No Authentication - Public API access
Multiple Transports - HTTP/JSON-RPC, SSE, and stdio
Auto-Monitoring - Daily tests ensure reliability

📊 Popular Datasets

Dataset	ID	Description
Quarterly National Accounts	QNA	GDP, consumption, investment by quarter
Main Economic Indicators	MEI	CPI, unemployment, production indices
Economic Outlook	EO	Economic projections and forecasts
Health Statistics	HEALTH_STAT	Healthcare systems and outcomes
PISA Results	PISA	Education assessment results
Green Growth	GREEN_GROWTH	Environmental and economic indicators

🔧 Tools

Dataset Discovery

search_dataflows - Search datasets by keyword
list_dataflows - Browse datasets by category
get_categories - List all 17 data categories
get_popular_datasets - Get commonly used datasets
search_indicators - Search specific indicators

Data Access

get_data_structure - Get dataset metadata
query_data - Query statistical data
get_dataflow_url - Generate OECD Data Explorer URL
list_categories_detailed - Detailed category information

📖 Example Usage

// Search for GDP datasets
await use_mcp_tool("oecd", "search_dataflows", {
  query: "GDP"
});

// Query USA GDP data
await use_mcp_tool("oecd", "query_data", {
  dataflow_id: "QNA",
  filter: "USA.GDP..",
  start_period: "2020-Q1",
  end_period: "2023-Q4"
});

🔌 Client Configuration (Click to expand)

Anthropic Products

Claude Web (claude.ai)

Go to Settings → Integrations
Click Add custom connector
Enter: https://oecd-mcp-server.onrender.com/mcp

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "oecd": {
      "url": "https://oecd-mcp-server.onrender.com/mcp"
    }
  }
}

Or local installation:

{
  "mcpServers": {
    "oecd": {
      "command": "npx",
      "args": ["-y", "oecd-mcp"]
    }
  }
}

Claude Code (CLI)

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

# Local
claude mcp add oecd -- npx -y oecd-mcp

OpenAI Products

ChatGPT (Developer Mode)

Settings → Connectors → Advanced
Enable Developer Mode
Create connector with URL: https://oecd-mcp-server.onrender.com/mcp

VS Code with GitHub Copilot

Settings → Extensions → MCP → Add Server:

{
  "mcpServers": {
    "oecd": {
      "url": "https://oecd-mcp-server.onrender.com/mcp",
      "transport": "http"
    }
  }
}

Other Clients

Cursor AI

{
  "mcpServers": {
    "oecd": {
      "command": "npx",
      "args": ["-y", "oecd-mcp"]
    }
  }
}

Lovable.dev / Firebase Studio

{
  "mcpServers": {
    "oecd": {
      "url": "https://oecd-mcp-server.onrender.com/sse",
      "transport": "sse"
    }
  }
}

📂 OECD Data Categories (17 categories - Click to expand)

Category	Code	Topics	Datasets
Economy	ECO	GDP, inflation, forecasts	500+
Employment	JOB	Labour 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, rates	100+
Finance	FIN	Markets, banking	95+
Government	GOV	Public sector, governance	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	Sub-national data	45+

💻 Development & Deployment (Click to expand)

Project Structure

oecd-mcp/
├── src/
│   ├── index.ts              # MCP server (stdio)
│   ├── http-server.ts        # HTTP server
│   ├── http-jsonrpc-transport.ts
│   ├── oecd-client.ts
│   ├── sdmx-client.ts
│   └── types.ts
├── tests/contract/
├── Dockerfile
├── render.yaml
└── server.json

Commands

npm run build       # Compile TypeScript
npm start           # Start HTTP server
npm test            # Run tests
npm run dev         # Watch mode

Deployment

Render:

git push origin main
# Auto-deploys via render.yaml
# Health: https://oecd-mcp-server.onrender.com/health

Docker:

docker build -t oecd-mcp .
docker run -p 3000:3000 oecd-mcp

API Endpoints

Endpoint	Method	Description
`/mcp`	GET/POST	MCP protocol
`/sse`	GET	SSE transport
`/health`	GET	Health check

🔍 Troubleshooting (Click to expand)

OECD API Returns No Data

Verify dataflow ID with search_dataflows
Check filter syntax matches SDMX
Use get_data_structure to understand dimensions

Connection Issues

Check OECD API status: https://sdmx.oecd.org/public/rest/
Review GitHub Actions for monitoring
Check server logs

Cold Starts (Render Free Tier)

First request after 15 min idle takes 30-60s
Subsequent requests are fast (~100-150ms)
Upgrade to paid plan ($7/mo) for always-on

🤝 Contributing (Click to expand)

Contributions welcome! Areas for improvement:

Add verified dataflows to src/known-dataflows.ts
Examples and tutorials
Enhanced tools
Bug fixes and tests

Submit a pull request

📜 License

MIT License - See LICENSE

📚 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

Created by Isak Skogstad | Built with Model Context Protocol SDK

oecd-mcp

Documentation