# io.github.cyanheads/oecd-mcp-server (remote · oecd.caseyjhand.com)

Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.

- Trust score: 88/100 (high trust)
- Change this week: +8
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-28

## Components

- remote · `oecd.caseyjhand.com`: 88/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-oecd-mcp-server/oecd.md), [page](https://verifymcp.io/servers/cyanheads-oecd-mcp-server/oecd)
- npm · `@cyanheads/oecd-mcp-server`: 82/100, [markdown](https://verifymcp.io/servers/cyanheads-oecd-mcp-server/cyanheads-oecd-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-oecd-mcp-server/cyanheads-oecd-mcp-server)

## Channel facts

- Endpoint: `https://oecd.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.3.2`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-28.

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1467 tokens (~209/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 100/100
  - No destabilizing schema changes in the last 30 days.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 7 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the io.github.cyanheads/oecd-mcp-server server?

io.github.cyanheads/oecd-mcp-server is a hosted endpoint at https://oecd.caseyjhand.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http cyanheads-oecd-mcp-server 'https://oecd.caseyjhand.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "cyanheads-oecd-mcp-server": {
      "url": "https://oecd.caseyjhand.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "cyanheads-oecd-mcp-server": {
      "type": "http",
      "url": "https://oecd.caseyjhand.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.cyanheads-oecd-mcp-server]
url = "https://oecd.caseyjhand.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-oecd-mcp-server": {
      "type": "remote",
      "url": "https://oecd.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-oecd-mcp-server --url 'https://oecd.caseyjhand.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-oecd-mcp-server:
    url: "https://oecd.caseyjhand.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "cyanheads-oecd-mcp-server": {
      "Transport": "http",
      "Url": "https://oecd.caseyjhand.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add cyanheads-oecd-mcp-server -t streamable-http -u 'https://oecd.caseyjhand.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-oecd-mcp-server": {
      "type": "http",
      "url": "https://oecd.caseyjhand.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-28 (score 88, +7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-25 (score 81, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-24 (score 81, 0)

- [security] Stability: 0.97 → pass

### 2026-09-23 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-21 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-20 (score 79, 0)

- [functional] Server version: 0.3.1 → 0.3.2
- [cosmetic] “oecd_dataframe_query” reworded the description of “canvas_id”
- [cosmetic] “oecd_query_dataset” reworded the description of “canvas_id”
- [cosmetic] “oecd_dataframe_describe” reworded the description of “canvas_id”

### 2026-09-19 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-17 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (7)

### `oecd_list_agencies` (~48 tokens)

Oecd List Agencies

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.

Output parameters:

- `agencies` (array): Agencies and their dataflow counts, sorted descending by count.
- `error` (object): Present when the call failed. Absent on success.
- `source` (string): Data source attribution — always "OECD".
- `total_agencies` (number): Total number of distinct agencies.
- `total_dataflows` (number): Total number of dataflows across all agencies.

### `oecd_search_datasets` (~192 tokens)

Oecd Search Datasets

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.

Input parameters:

- `agency_id` (string): Optional agency identifier to restrict the search scope — e.g. "OECD.SDD.NAD". Obtain valid agency IDs from oecd_list_agencies.
- `limit` (integer): Maximum number of results to return (1–100, default 20).
- `offset` (integer): Zero-based index of the first match to return, applied before limit. Page through results past the limit by advancing it; an offset at or past total_matches returns an empty list.
- `query` (string, required): Keyword or phrase to search for in dataflow names and descriptions — e.g. "GDP", "employment", "education". Every whitespace-separated token must appear somewhere in the name or description.

Output parameters:

- `dataflows` (array): Matching dataflows for the requested page, up to the requested limit.
- `error` (object): Present when the call failed. Absent on success.
- `offset` (number): Zero-based index of the first returned result within the full match list.
- `result_count` (number): Number of results returned (may be less than total_matches).
- `source` (string): Data source attribution — always "OECD".
- `totalCount` (number): Total dataflows matching the query, disclosed when matches remain beyond the returned page.
- `total_matches` (number): Total dataflows matching the query before applying offset and limit.

### `oecd_get_dataset_info` (~143 tokens)

Oecd Get Dataset Info

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.

Input parameters:

- `flow_ref` (string, required): Full flow reference, either {agencyID},{dsd_id}@{df_id} — e.g. "OECD.SDD.NAD,DSD_NAAG@DF_NAAG_I" — or the bare {agencyID},{df_id} form OECD uses for the few dataflows published without a datastructur…

Output parameters:

- `dimensions` (array): Dimensions in ascending position order.
- `error` (object): Present when the call failed. Absent on success.
- `flow_ref` (string): The resolved flow reference.
- `key_example` (string): Example dot-delimited key with wildcards — each dot corresponds to one dimension in position order. Empty segments are wildcards. Replace with actual codes from oecd_get_dimension_values.
- `non_production` (boolean): True if OECD flagged this dataflow as experimental or deprecated.
- `source` (string): Data source attribution — always "OECD".
- `time_dimension` (object): Time dimension — used for startPeriod/endPeriod filtering in oecd_query_dataset.

### `oecd_get_dimension_values` (~303 tokens)

Oecd Get Dimension Values

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.

Input parameters:

- `dimension_id` (string, required): Dimension identifier to fetch codes for — e.g. "REF_AREA" or "MEASURE". Obtain valid dimension IDs from oecd_get_dataset_info.
- `flow_ref` (string, required): Full flow reference — e.g. "OECD.SDD.NAD,DSD_NAAG@DF_NAAG_I", or the bare "OECD.TAD.ARP,DF_AEI2024_DASHBOARD" form for a dataflow published without a datastructure prefix. Obtain from oecd_search_dat…
- `limit` (integer): Maximum codes to return (1–500, default 50).
- `offset` (integer): Zero-based index of the first code to return within the matching list, applied before limit. Advance it to page; an offset past the last match returns an empty page.
- `query` (string): Case-insensitive substring matched against both the code and its label, so "PA" and "percent" each reach the code "PA" / "Percent per annum". Omit to page the whole codelist.

Output parameters:

- `code_count` (number): Number of codes in this page — not the size of the dimension's codelist.
- `codes` (array): The requested page of codes, after query, offset, and limit are applied.
- `dimension_id` (string): The dimension whose codes are listed.
- `effectiveQuery` (string): The substring filter as applied. Absent when the whole codelist was paged.
- `error` (object): Present when the call failed. Absent on success.
- `flow_ref` (string): The flow reference this dimension belongs to.
- `notice` (string): Present when the page needs explaining — the dimension has no codelist, the query matched nothing, or codes remain beyond the page. States how to reach the rest.
- `source` (string): Data source attribution — always "OECD".
- `totalCount` (number): Codes matching before offset and limit, disclosed when the page does not cover them all.

### `oecd_query_dataset` (~416 tokens)

Oecd Query Dataset

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 — follow up with 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.

Input parameters:

- `canvas_id` (string): Canvas ID from a prior oecd_query_dataset call — exactly 10 characters of letters, digits, hyphens, and underscores — to stage this result alongside that one. Omit to let the server mint a canvas if…
- `end_period` (string): End of the time range — ISO period code such as "2023" or "2023-Q4". Omit to include up to the latest available period.
- `flow_ref` (string, required): Full flow reference — e.g. "OECD.SDD.NAD,DSD_NAAG@DF_NAAG_I", or the bare "OECD.TAD.ARP,DF_AEI2024_DASHBOARD" form for a dataflow published without a datastructure prefix. Obtain from oecd_search_dat…
- `key` (string, required): Dot-delimited dimension key matching the dimension order from oecd_get_dataset_info. Empty segments are wildcards; "+" separates multiple values per segment. Example: "A.USA+DEU.B1GQ.." — Annual, USA…
- `start_period` (string): Start of the time range — ISO period code such as "2010", "2010-Q1", or "2010-01". Omit to include all history (may produce very large results).

Output parameters:

- `canvas_id` (string): Canvas handle for the staged result. Present only when DataCanvas is configured and the result exceeded the inline budget; absent when DataCanvas is off, and absent when it is on but the result fit i…
- `content_table_capped` (boolean): True when the rendered table shows only the leading rows of the result. Distinct from truncated: nothing was staged anywhere, and structuredContent.rows still holds every row. To shrink the result it…
- `content_table_rows` (number): Rows the rendered table shows when content_table_capped is true.
- `error` (object): Present when the call failed. Absent on success.
- `query_end_period` (string): End period filter applied in this query, if any.
- `query_flow_ref` (string): Flow reference used in this query.
- `query_key` (string): Dimension key used in this query.
- `query_start_period` (string): Start period filter applied in this query, if any.
- `row_count` (number): Total rows in the result (or on the canvas when truncated).
- `rows` (array): Observation rows. Every row of the result when truncated is absent; the leading preview slice when truncated is true — query the canvas table for the rest.
- `source` (string): Data source attribution — always "OECD".
- `table_name` (string): Canvas table name holding the full result — present when canvas_id is set.
- `truncated` (boolean): True when rows is a preview slice and the full result was staged on DataCanvas; omitted entirely (never false) when rows holds the complete result. Use oecd_dataframe_query with the canvas_id for ana…

### `oecd_dataframe_describe` (~103 tokens)

Oecd Dataframe Describe

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. Only available when CANVAS_PROVIDER_TYPE=duckdb is set.

Input parameters:

- `canvas_id` (string, required): Canvas ID returned by oecd_query_dataset — exactly 10 characters of letters, digits, hyphens, and underscores. Identifies the DataCanvas session holding the staged observation tables.

Output parameters:

- `canvas_id` (string): The canvas ID whose tables are listed.
- `error` (object): Present when the call failed. Absent on success.
- `table_count` (number): Total number of tables and views.
- `tables` (array): Tables and views staged on this canvas.

### `oecd_dataframe_query` (~163 tokens)

Oecd Dataframe Query

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. Only available when CANVAS_PROVIDER_TYPE=duckdb is set.

Input parameters:

- `canvas_id` (string, required): Canvas ID returned by oecd_query_dataset — exactly 10 characters of letters, digits, hyphens, and underscores. Identifies the DataCanvas session holding the observation tables.
- `sql` (string, required): Read-only SELECT statement. Reference tables by the names returned by oecd_dataframe_describe. Only SELECT statements are allowed — DDL, DML, and file-reading functions are rejected.

Output parameters:

- `column_names` (array): Column names in the result, in order.
- `error` (object): Present when the call failed. Absent on success.
- `row_count` (number): Full result count before any row cap.
- `rows` (array): Result rows from the SQL query (capped at the canvas row limit).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-oecd-mcp-server/oecd#diagnostics

## Score history

- 2026-09-28: 88
- 2026-09-27: 81
- 2026-09-26: 81
- 2026-09-25: 81
- 2026-09-24: 81
- 2026-09-23: 81
- 2026-09-22: 80
- 2026-09-21: 80
- 2026-09-20: 79
- 2026-09-19: 79
- 2026-09-18: 78
- 2026-09-17: 78
- 2026-09-16: 77
- 2026-09-15: 77
- 2026-09-14: 77
- 2026-09-13: 76
- 2026-09-12: 76
- 2026-09-11: 75
- 2026-09-10: 75
- 2026-09-09: 74
- 2026-09-08: 74
- 2026-09-07: 73
- 2026-09-06: 73
- 2026-09-05: 72
- 2026-09-04: 72
- 2026-09-03: 71
- 2026-09-02: 71
- 2026-09-01: 70
- 2026-08-31: 70
- 2026-08-30: 70

## Common questions

### What is the io.github.cyanheads/oecd-mcp-server server?

io.github.cyanheads/oecd-mcp-server is listed in the public MCP registry as io.github.cyanheads/oecd-mcp-server. Search and query 1,500+ OECD statistical datasets via SDMX. Keyless. This page covers its hosted endpoint (https://oecd.caseyjhand.com/mcp).

### Is the io.github.cyanheads/oecd-mcp-server server safe to use?

io.github.cyanheads/oecd-mcp-server scores 88 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.cyanheads/oecd-mcp-server server expose?

io.github.cyanheads/oecd-mcp-server exposes 7 tools: oecd_list_agencies, oecd_search_datasets, oecd_get_dataset_info, oecd_get_dimension_values, oecd_query_dataset, and 2 more. Their descriptions and schemas cost roughly 1,368 tokens of context every time the server is loaded.

### Does the io.github.cyanheads/oecd-mcp-server server require authentication?

No. We connected to io.github.cyanheads/oecd-mcp-server without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the io.github.cyanheads/oecd-mcp-server server still maintained?

io.github.cyanheads/oecd-mcp-server is still listed as active in the MCP registry. We last reached this channel on 28 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://oecd.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/oecd-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-oecd-mcp-server/oecd.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-oecd-mcp-server/oecd.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-oecd-mcp-server/oecd