Log inSubmit server
Oecd MCP Server logo

Oecd MCP Server

Searches and queries 1,500+ OECD SDMX datasets, with DuckDB-backed SQL analysis for large result sets.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Oecd MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "oecd-mcp-server": {
      "command": "bunx",
      "args": [
        "@cyanheads/oecd-mcp-server@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

bunx @cyanheads/oecd-mcp-server@latest

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked Today.

Overview

oecd-mcp-server connects MCP clients to the public OECD SDMX 2.1 API for discovering datasets, inspecting dimensions, and retrieving observations without an API key. Its workflow passes dataset references from search into metadata, code-list, and query tools. Large query results can be staged in DataCanvas, where read-only SQL supports further analysis. Use it for OECD indicators across areas such as national accounts, employment, trade, education, health, and taxation.

Use cases

  • Search OECD dataflows by topic or agency
  • Inspect dimensions and valid country or measure codes
  • Query multi-country time series by period
  • Run read-only SQL over large observation sets
  • Explore national accounts, employment, trade, education, or health statistics

Key features

  • Keyless access to the public OECD SDMX API
  • Search across 1,500+ OECD dataflows
  • Dimension metadata and codelist lookup
  • Flat observation results with decoded labels
  • DuckDB DataCanvas staging for large queries
  • STDIO and Streamable HTTP transports

Tools8

What Oecd MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~196 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

6/6 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · @cyanheads/oecd-mcp-server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads561Package downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed8Callable tools this server registers over MCP.

How Oecd MCP Server works

What oecd-mcp-server does

OECD statistical data becomes available through MCP tools for dataset discovery, metadata inspection, dimension lookup, observation retrieval, and follow-up analysis. The catalog covers more than 1,500 dataflows spanning areas such as national accounts, employment, inflation, trade, education, health, environment, taxation, and inequality.

The server uses the OECD SDMX 2.1 REST API and does not require an API key. Search results include a flow_ref, which can be passed directly to the metadata, dimension-value, and query tools. A matching MCP resource, oecd://dataflow/{agency_id}/{flow_id}, exposes the same dataflow metadata as the dataset-info tool.

How it works

A typical workflow starts with oecd_list_agencies or oecd_search_datasets. Agency listing returns publisher identifiers, directorates where applicable, and dataflow counts. Dataset search supports keyword or theme matching, optional agency filtering, and pagination.

After selecting a flow, oecd_get_dataset_info returns its dimensions in key order, concept names, codelist references, and an example query key. oecd_get_dimension_values then provides valid codes and labels for a selected dimension, such as geography, measure, or frequency.

oecd_query_dataset accepts the flow reference, a dot-delimited SDMX key, and optional start and end periods. Multiple values use +, while empty key segments act as wildcards. Returned observations are flattened into rows with dimensions and attributes as columns. Values are adjusted using the dataset's value_scale.

Large result sets are materialized in a DuckDB DataCanvas. The response identifies the canvas and table, allowing an agent to inspect the schema with oecd_dataframe_describe and issue a read-only SQL SELECT through oecd_dataframe_query.

Setup and configuration

A hosted Streamable HTTP instance is available at https://oecd.caseyjhand.com/mcp, so clients can connect without installing the package. Claude Code can register it with:

Terminal
claude mcp add --transport http oecd-mcp-server https://oecd.caseyjhand.com/mcp

The repository also provides installation links for Claude Desktop, Cursor, and VS Code. The package supports both STDIO and Streamable HTTP transports when run as a local server. OECD access is keyless. DuckDB DataCanvas support requires CANVAS_PROVIDER_TYPE=duckdb; the dataframe tools depend on that provider.

Tools and capabilities

  • oecd_list_agencies: Enumerates agencies, directorates, and published dataflow counts.
  • oecd_search_datasets: Finds dataflows by matching names and descriptions, with agency scoping and paging.
  • oecd_get_dataset_info: Resolves dimensions, key order, codelists, and a usable key example.
  • oecd_get_dimension_values: Searches or pages through valid codes and labels for a dimension.
  • oecd_query_dataset: Retrieves observations for selected dimensions and periods.
  • oecd_dataframe_describe: Reports staged DataCanvas tables, row counts, columns, and types.
  • oecd_dataframe_query: Runs one read-only SQL SELECT against staged tables.
  • oecd_dataframe_drop: Removes a staged table or view when explicitly enabled with OECD_DATAFRAME_DROP_ENABLED=true.

The server resolves delegated dataflows and follows the structure links used by the OECD catalog. It also decodes SDMX data into flat, labeled rows rather than exposing raw index arrays.

Limitations and notes

Results that fit inline remain in structured tool output; larger responses are redirected to DataCanvas and signal this with truncated: true. SQL output is capped at the canvas row limit, while the response reports the full row count. Dataframe queries reject writes, DDL, and system-catalog access.

The drop tool is listed but unavailable unless explicitly enabled. Some agencies in the catalog, including external publishers such as ESTAT and IAEG-SDGs, do not have an OECD directorate. Data availability and labels follow the OECD dataflow and codelist definitions.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Oecd MCP Server

oecd-mcp-server is an MCP server that connects AI clients to the public OECD SDMX API. Its main tools search dataflows, inspect dimensions and valid codes, query observations, and run read-only SQL over large results staged in DuckDB DataCanvas. No OECD API key is required.

Use the hosted Streamable HTTP endpoint at https://oecd.caseyjhand.com/mcp, or install the package locally through the provided client setup links. Claude Code can register the hosted server with `claude mcp add --transport http oecd-mcp-server https://oecd.caseyjhand.com/mcp`.

No, it uses the public OECD SDMX 2.1 REST API and does not require an API key. You can connect through the hosted Streamable HTTP instance or run the server locally over STDIO or Streamable HTTP.

Query the dataset with `oecd_query_dataset`; large responses are staged in DataCanvas and return a `canvas_id` and table name. Use `oecd_dataframe_describe` to inspect the schema, then submit a read-only SQL `SELECT` with `oecd_dataframe_query`. DuckDB requires `CANVAS_PROVIDER_TYPE=duckdb`.

Yes, Cursor is supported through the repository's MCP installation link. The server also provides setup paths for Claude Desktop and VS Code, and its hosted endpoint can be used by clients that support Streamable HTTP.

Related MCP servers

All in Data Science Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOecd MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/oecd-mcp-server?style=directory)](https://allmcps.com/mcp/oecd-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/oecd-mcp-server"><img src="https://allmcps.com/api/badge/oecd-mcp-server?style=directory" alt="Oecd MCP Server on AllMCPs" /></a>