io.github.cyanheads/imf-mcp-server
REMOTE · IMF.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3
Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.
Available components
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. How we score →
Endpoint Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 5 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability65
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1370 tokens (~274/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · imf.caseyjhand.com
claude mcp add --transport http cyanheads-imf-mcp-server https://imf.caseyjhand.com/mcp
[mcp_servers.cyanheads-imf-mcp-server] url = "https://imf.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-imf-mcp-server": {
"type": "remote",
"url": "https://imf.caseyjhand.com/mcp",
"enabled": true
}
}
} openclaw mcp add cyanheads-imf-mcp-server --url https://imf.caseyjhand.com/mcp --transport streamable-http
mcp_servers:
cyanheads-imf-mcp-server:
url: "https://imf.caseyjhand.com/mcp" {
"mcpServers": {
"cyanheads-imf-mcp-server": {
"type": "http",
"url": "https://imf.caseyjhand.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Jul 26 +2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 63
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://imf.caseyjhand.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=caseyjhand.com | CN=WE1,O=Google Trust Services,C=US | 7 Jul 2026 | 5 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | 5aad900eb2055a0b0ea55912ec19680c |
| SANs: caseyjhand.com, *.caseyjhand.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC secure
Validation of imf.caseyjhand.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| caseyjhand.com. | present | 2371 | 13 | Verified |
| imf.caseyjhand.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://imf.caseyjhand.com/mcp | Verified | 200 | |
| http (plaintext) | http://imf.caseyjhand.com/mcp | HTTPS enforced | 301 | https://imf.caseyjhand.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
imf_dataframe_describe Imf Dataframe Describe ~86
List DataCanvas tables and columns staged by a prior imf_query_dataset call. Returns each table's name, row count, and column schema (name + DuckDB type). Required before imf_dataframe_query to discover the table and column names for SQL.
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | yes | Canvas ID returned by imf_query_dataset when results were too large for inline delivery. |
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | yes | Canvas session ID that was introspected. |
| table_count | number | yes | Total number of tables on the canvas. |
| tables | array | yes | All tables registered on this canvas. |
No examples provided.
imf_dataframe_query Imf Dataframe Query ~150
Run a read-only SQL SELECT against a DataCanvas table staged by imf_query_dataset. Supports multi-country comparisons, time-series aggregation, and cross-indicator joins. Requires imf_dataframe_describe first to discover table and column names. Only SELECT statements are accepted — DML and DDL are rejected.
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | yes | Canvas ID returned by imf_query_dataset when results were too large for inline delivery. |
| sql | string | yes | Read-only SQL SELECT statement. Must start with SELECT. Reference tables by the names returned by imf_dataframe_describe. Example: SELECT time_period, value FROM spilled_abc123 WHERE time_period >= '… |
| Name | Type | Req | Description |
|---|---|---|---|
| row_count | number | yes | Total matching rows before the cap — may exceed rows.length. |
| rows | array | yes | Query result rows, capped at the canvas row limit (default 10,000). |
No examples provided.
imf_get_database Imf Get Database ~339
Fetch a dataflow's dimension list and complete codelist for each dimension. Resolves human-readable terms to SDMX codes (e.g. "United States" → USA, "real GDP growth" → NGDP_RPCH). Required before imf_query_dataset — SDMX keys are opaque without codelist lookups. Country codes are ISO 3-letter (USA, GBR, DEU), not ISO 2-letter (US, GB, DE). The key_format field shows the exact dimension order required by imf_query_dataset. Note: codelists enumerate the code universe, not actual coverage — valid codes can still return no_data if the combination has no series in this dataflow.
| Name | Type | Req | Description |
|---|---|---|---|
| agency_id | string | — | Agency ID that publishes this dataflow, e.g. IMF.RES or IMF.STA. Auto-detected from the dataflow list when omitted. |
| codelist_filter | string | — | Optional case-insensitive substring to search within each dimension's codelist (code ID and name). When set, returns all matching entries per dimension instead of the first-50 window — useful for lar… |
| dataflow_id | string | yes | Dataflow identifier from imf_list_databases, e.g. WEO, BOP, CPI. Case-sensitive. |
| version | string | — | Dataflow version, e.g. 9.0.0. Auto-detected from the dataflow list when omitted. |
| Name | Type | Req | Description |
|---|---|---|---|
| agency_id | string | yes | Agency that publishes this dataflow, e.g. IMF.RES, IMF.STA. |
| dataflow_id | string | yes | Dataflow identifier, e.g. WEO, BOP, CPI. |
| description | string | — | Extended description, if available. |
| dimensions | array | yes | All dimensions of this dataflow with their codelists. |
| dsd_version | string | — | Version of the underlying data structure definition (DSD) that backs this dataflow. Differs from version when the dataflow references a shared DSD (e.g. IIP → DSD_BOP at 24.0.0). |
| key_format | string | yes | Dimension names in dot-separated keyPosition order, e.g. COUNTRY.INDICATOR.FREQUENCY. Use this exact format when constructing the key for imf_query_dataset. |
| name | string | yes | Human-readable dataflow name. |
| source | string | yes | Attribution string required by IMF data terms: "Source: International Monetary Fund, <dataflow name>, <link>". |
| structure_ref | string | — | Identifier of the underlying DSD, e.g. DSD_BOP. Several dataflows can share one DSD. |
| version | string | yes | Dataflow version string, e.g. 9.0.0. |
No examples provided.
imf_list_databases Imf List Databases ~172
List IMF SDMX dataflows available on the portal. Entry point for every query: imf_get_database and imf_query_dataset both require a dataflow id obtained here. Vintage (historical snapshot) dataflows such as WEO_2025_OCT_VINTAGE are excluded by default; set include_vintages=true to include them. The returned total_count reflects the current live catalog size.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | string | — | Optional name, ID, or description substring to filter results. Case-insensitive. Example: "exchange rate" returns ER and related dataflows. |
| include_vintages | boolean | — | Include vintage (historical snapshot) dataflows such as WEO_2025_OCT_VINTAGE. Default false — vintages are excluded to keep the discovery surface clean. |
| Name | Type | Req | Description |
|---|---|---|---|
| dataflows | array | yes | Matching dataflows; pass the id to imf_get_database to resolve dimension codelists. |
| notice | string | — | Populated when the filter matches nothing — explains why and suggests next steps. |
| total_count | number | yes | Total number of matching dataflows returned. |
No examples provided.
imf_query_dataset Imf Query Dataset ~516
Query an IMF SDMX dataflow by dimension key over a time range. Returns observations with time_period, value, unit, scale, and status attributes. Requires imf_get_database first to obtain the correct key_format and valid dimension codes. Country codes are ISO 3-letter (USA, GBR, DEU — not US, GB, DE). Key format: dot-separated codes in DSD keyPosition order (e.g. USA.NGDP_RPCH.A for WEO). Use + to specify multiple codes per position (e.g. USA+GBR.NGDP_RPCH.A). Codelists from imf_get_database enumerate the code universe, not actual coverage — valid codes can still return no_data if the combination has no series. start_period and end_period must be valid period strings (YYYY, YYYY-QN, or YYYY-MM) with start_period no later than end_period; malformed or reversed ranges are rejected. Large analytical result sets (multi-country, long time range) spill to DataCanvas; imf_dataframe_query provides SQL analysis of spilled results.
| Name | Type | Req | Description |
|---|---|---|---|
| agency_id | string | — | Agency ID, e.g. IMF.RES or IMF.STA. Auto-detected from dataflow list when omitted. |
| canvas_id | string | — | Existing canvas ID to accumulate results into across multiple queries. Omit to allocate a fresh canvas; the response includes a canvas_id when results spill to DataCanvas. |
| dataflow_id | string | yes | Dataflow identifier from imf_list_databases, e.g. WEO, BOP, CPI. |
| end_period | string | — | End of time range (inclusive). Same format as start_period, and must be greater than or equal to start_period. Observations after this period are excluded from the result. |
| key | string | yes | Dot-separated dimension codes in DSD keyPosition order. Call imf_get_database to get key_format and valid codes first. Use + to specify multiple codes (e.g. USA+GBR.NGDP_RPCH.A). Country codes are IS… |
| start_period | string | — | Start of time range (inclusive). Format matches the dataflow frequency: YYYY (annual), YYYY-QN (quarterly, e.g. 2023-Q1), YYYY-MM (monthly). Observations before this period are excluded from the resu… |
| version | string | — | Dataflow version. Auto-detected from dataflow list when omitted. |
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | — | DataCanvas session ID — present when truncated=true. Pass to imf_dataframe_query or imf_dataframe_describe to query the full result. |
| dataflow_id | string | yes | Dataflow identifier that was queried, e.g. WEO. |
| end_period | string | — | Latest period covered; absent when the full available range was used. |
| key | string | yes | Dimension key used in the query, e.g. USA.NGDP_RPCH.A. |
| observation_count | number | yes | Total observations in the result. |
| observations | array | yes | Inline observations. Empty when results spilled to canvas (see canvas_id / table_name). |
| series_attributes | object | yes | Series-level attributes (unit, scale, decimals). |
| source | string | yes | Attribution string required by IMF data terms: "Source: International Monetary Fund, <dataflow name>, <link>". |
| start_period | string | — | Earliest period covered; absent when the full available range was used. |
| table_name | string | — | DuckDB table name on the canvas — present when truncated=true; reference in SQL via FROM <table_name>. |
| truncated | boolean | yes | True when the result exceeded the inline limit and was staged on a DataCanvas table; canvas_id and table_name are populated and imf_dataframe_query provides SQL access to the full set. |
No examples provided.