oecd-mcp-server
Server Details
Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/oecd-mcp-server
- GitHub Stars
- 4
- Server Listing
- OECD MCP Server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 7 tools
The toolset follows a clear discovery→metadata→query pipeline, and each tool's role in it is spelled out (list_agencies → search_datasets → get_dataset_info → get_dimension_values → query_dataset). The only mild overlap is between oecd_query_dataset (key-based observation retrieval) and oecd_dataframe_query (SQL over a spilled canvas), which the descriptions distinguish but an agent could still initially confuse.
All names share a consistent oecd_ prefix and snake_case, and five follow a clean verb_noun pattern (get_dataset_info, list_agencies, query_dataset, search_datasets, get_dimension_values). The two DataCanvas tools break the pattern by placing the noun first (dataframe_describe, dataframe_query), a minor but noticeable deviation.
Seven tools is well-scoped for a read-only statistical data server: four cover discovery/metadata, two cover data retrieval including SQL spillover, and one covers agency enumeration. Every tool has a distinct step in the workflow and none appear redundant.
The surface covers the full read path — agency listing, keyword search, structure inspection, codelist resolution, and observation retrieval via both key and SQL. Minor gaps remain: there is no tool to browse/enumerate all dataflows without a keyword, no explicit availability/constraint lookup (time coverage, allowed key values), and no way to release or manage staged DataCanvas tables.
Available Tools
7 toolsoecd_dataframe_describeOecd Dataframe DescribeARead-onlyIdempotentInspect
List tables and columns staged on a DataCanvas by a prior oecd_query_dataset spill. Call this before oecd_dataframe_query to discover exact table and column names for SQL. Unavailable when the server runs with DataCanvas disabled.
Inputs: canvas_id (required). Returns: error, tables, canvas_id, table_count
oecd_dataframe_queryOecd Dataframe QueryARead-onlyIdempotentInspect
Run a read-only SQL SELECT against OECD observation tables staged on a DataCanvas by oecd_query_dataset. Call oecd_dataframe_describe first to discover exact table and column names, then use this tool for aggregation, filtering, GROUP BY, JOIN, and window functions. Returns up to limit rows (default 100, at most 1,000 per call) and at most 1 MiB of row data; truncated: true marks a result with more rows than came back, and its notice says how to reach the rest. A query still running after 30 seconds is stopped. Unavailable when the server runs with DataCanvas disabled.
Inputs: sql (required), canvas_id (required), limit. Returns: rows, error, notice, row_count, +2 more
oecd_get_dataset_infoOecd Get Dataset InfoARead-onlyIdempotentInspect
Fetch a dataflow's dimensions, their order, and how to construct a query key. Returns per-dimension names, codelist references, and position in the dot-delimited key. Required before calling oecd_query_dataset to understand key structure.
Inputs: flow_ref (required). Returns: error, source, flow_ref, dimensions, +3 more
oecd_get_dimension_valuesOecd Get Dimension ValuesARead-onlyIdempotentInspect
Fetch the valid codes and labels for one dimension of a dataflow. Use to resolve human-readable names (countries, measures) to SDMX codes before querying with oecd_query_dataset. Pass query to match a code or label by substring — codelists run to a thousand-plus entries, and the response is a page of at most limit codes either way.
Inputs: flow_ref (required), dimension_id (required), limit, query, +1 more. Returns: codes, error, notice, source, +5 more
oecd_list_agenciesOecd List AgenciesARead-onlyIdempotentInspect
List OECD SDMX agencies, the directorate each belongs to, and the number of dataflows each publishes. Use to discover agency IDs before filtering oecd_search_datasets by department.
Inputs: no named parameters. Returns: error, source, agencies, total_agencies, +1 more
oecd_query_datasetOecd Query DatasetARead-onlyIdempotentInspect
Fetch observations from an OECD dataflow filtered by a dimension key and optional time range. Returns decoded rows (one per observation) with dimension and attribute labels, and values already scaled by the observation unit multiplier. Large multi-country time-series spill to a DataCanvas table — inspect columns with oecd_dataframe_describe, then query the full table with SQL using oecd_dataframe_query; without DataCanvas every row still comes back, but the rendered table stops at a preview slice. Call oecd_get_dataset_info first to learn the dimension order for constructing the key.
Inputs: key (required), flow_ref (required), canvas_id, end_period, +1 more. Returns: rows, error, notice, source, +10 more
oecd_search_datasetsOecd Search DatasetsARead-onlyIdempotentInspect
Search OECD dataflows by keyword or theme, matching against dataflow names and descriptions. Returns flow_ref identifiers, names, and agency IDs for use with oecd_get_dataset_info.
Inputs: query (required), limit, offset, agency_id. Returns: error, offset, source, dataflows, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
OECD MCP — Organisation for Economic Co-operation and Development data (free, no auth) via the…
Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.
SDMX Structure MCP — dataflow dimensions and code lists for any SDMX 2.1 registry: Eurostat, OECD…
Search ILOSTAT labour indicators, query and compare series, build country profiles, run SQL.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides AI assistants access to over 5,000 OECD economic and statistical datasets via the SDMX API for search, analysis, and comparison across 38 countries.939 npm7MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying OECD data through MCP, including searching curated dataflows, fetching tidy dataset rows from the OECD SDMX REST API, and asking natural-language questions via the Pipeworx gateway.147 npmMIT
- AlicenseAqualityDmaintenanceProvides OECD statistical data (employment, wages, etc.) through SDMX API, supporting Korean-language queries. Enables listing indicators, retrieving stats, trends, comparisons, and rankings among OECD countries.8MIT
- AlicenseAqualityCmaintenanceEnables users to search the Statistics Netherlands table catalog, inspect dimensions and measures, and query statistical datasets with filters and pagination.6MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.