{"data":{"name":"io.github.cyanheads/imf-mcp-server","title":null,"description":"Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.","version":"0.4.4","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/imf-mcp-server","remotes":[{"url":"https://imf.caseyjhand.com/mcp","type":"streamable-http"}],"packages":[{"version":"0.4.4","identifier":"@cyanheads/imf-mcp-server","runtimeHint":"stdio","registryType":"npm","runtimeArguments":null,"environmentVariables":null},{"version":"0.4.4","identifier":"@cyanheads/imf-mcp-server","runtimeHint":"streamable-http","registryType":"npm","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-10-16T17:54:41.516Z","updatedAt":"2026-10-16T17:54:41.516Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":null,"source":"official-registry","sourceId":"io.github.cyanheads/imf-mcp-server","updatedAt":"2026-10-16T17:54:41.516Z","confidence":100,"websiteUrl":null,"description":"Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.","verification":"official","repositoryUrl":"https://github.com/cyanheads/imf-mcp-server"}],"toolIndex":{"tools":[{"serverName":"io.github.cyanheads/imf-mcp-server","endpointFingerprint":"6c37d15aefff7aeb0f863333560c10d2c6df24a7d0cf630a425fb0ff18bf6374","name":"imf_dataframe_describe","title":"Imf Dataframe Describe","description":"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.","inputSchema":{"type":"object","properties":{"canvas_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{10}$","description":"Canvas ID returned by imf_query_dataset whenever staged=true, from automatic spillover or output_mode=\"canvas\"."}},"required":["canvas_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"9664d5040ec7c977f0be49ff0e53fe134c5c23536360281d52ea885bc6d4598e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:47.855Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/imf-mcp-server","endpointFingerprint":"6c37d15aefff7aeb0f863333560c10d2c6df24a7d0cf630a425fb0ff18bf6374","name":"imf_dataframe_query","title":"Imf Dataframe Query","description":"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. One SELECT statement per call; a leading WITH … SELECT (CTE) is accepted. DML and DDL are rejected.","inputSchema":{"type":"object","properties":{"canvas_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{10}$","description":"Canvas ID returned by imf_query_dataset whenever staged=true. Call imf_dataframe_describe with it before writing SQL."},"sql":{"type":"string","description":"Read-only SQL SELECT statement — exactly one statement, starting with SELECT or with a WITH … SELECT common table expression. Reference tables by the names returned by imf_dataframe_describe. Example: SELECT time_period, value FROM spilled_abc123 WHERE time_period >= '2010' ORDER BY time_period."}},"required":["canvas_id","sql"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"f9718c700baa5fd7d8ce9fb45d80c10ae60e2d3bc00e58ccaf17ca1894ee5d6d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:47.855Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/imf-mcp-server","endpointFingerprint":"6c37d15aefff7aeb0f863333560c10d2c6df24a7d0cf630a425fb0ff18bf6374","name":"imf_get_database","title":"Imf Get Database","description":"Fetch a dataflow's dimension list with a codelist preview for each dimension. Resolves human-readable terms to SDMX codes (e.g. \"United States\" → USA, \"Constant prices\" → NGDP_RPCH). Required before imf_query_dataset — SDMX keys are opaque without codelist lookups. Each codelist is capped at the first 50 entries by default, including previews filtered by codelist_filter. Set dimension_id to retrieve one codelist with bounded limit/offset paging after the optional codelist_filter, which keeps codes whose ID or name contains every word given. Set available_only=true to page codes the dataflow actually publishes, with series and time coverage metadata; availability filtering happens before codelist_filter and paging. The imf://database/{dataflow_id} resource provides the same bounded discovery summary. 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.","inputSchema":{"type":"object","properties":{"dataflow_id":{"type":"string","description":"Dataflow identifier from imf_list_databases, e.g. WEO, BOP, CPI."},"agency_id":{"description":"Agency ID that publishes this dataflow, e.g. IMF.RES or IMF.STA, matched case-insensitively. Auto-detected from the dataflow list when omitted.","type":"string"},"version":{"description":"Dataflow version, e.g. 9.0.0. Auto-detected from the dataflow list when omitted.","type":"string"},"codelist_filter":{"description":"Optional words to search for in each dimension's codelist, split on spaces and commas. A code matches when every word appears, case-insensitively, in its code ID or name; different words may match different fields. Filtering runs before the 50-entry preview or selected-dimension page. Example: \"CPI\", \"GDP constant prices\", or \"NGDP_RPCH percent\" surfaces matching WEO indicator codes.","type":"string","minLength":1},"available_only":{"description":"Return only codes reported by the dataflow-wide availability constraint. Default false keeps ordinary codelist discovery unchanged.","default":false,"type":"boolean"},"dimension_id":{"description":"Exact dimension ID from this tool, e.g. INDICATOR. Select one dimension to page beyond its preview.","type":"string","minLength":1},"limit":{"description":"Entries to return from the selected dimension. Valid only with dimension_id; default 50. One call returns at most 200, so a larger limit (up to 50,000) returns 200, echoes requested_limit and applied_limit, and next_offset names the rest.","type":"integer","minimum":1,"maximum":50000},"offset":{"description":"Matching entries to skip in the selected dimension before this page. Valid only with dimension_id; default 0.","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["dataflow_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"be96ad6082758c507b009f83066bbced69be4d175b6b63d6d5ec91c6d9db0056","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:47.855Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/imf-mcp-server","endpointFingerprint":"6c37d15aefff7aeb0f863333560c10d2c6df24a7d0cf630a425fb0ff18bf6374","name":"imf_list_databases","title":"Imf List Databases","description":"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. Results are paged — 50 per call by default and at most 200, adjustable with limit and offset — and total_count reports how many dataflows matched. Descriptions are shortened here; imf_get_database returns the full text for a single dataflow.","inputSchema":{"type":"object","properties":{"filter":{"description":"Optional words to filter results by, split on spaces and commas. A dataflow matches when every word appears, case-insensitively, somewhere in its ID, name, or full description. Example: \"exchange rate\" returns ER and related dataflows; \"WEO outlook\" returns WEO and the regional outlooks built on it.","type":"string","minLength":1},"include_vintages":{"description":"Include vintage (historical snapshot) dataflows such as WEO_2025_OCT_VINTAGE. Default false — vintages are excluded to keep the discovery surface clean.","default":false,"type":"boolean"},"limit":{"description":"Maximum dataflows to return in this call. Default 50; one call returns at most 200, so a larger limit (up to 1,000) returns 200 and echoes requested_limit and applied_limit. total_count reports how many matched, so a partial page is always recognizable as one.","default":50,"type":"integer","minimum":1,"maximum":1000},"offset":{"description":"Number of matching dataflows to skip before this page. Combine with limit to page through a broad or unfiltered catalog.","default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"ad6cd20c2cce0bb19fb225647054feb71b4414fd3c305cc71164cb5767c16f87","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:47.855Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/imf-mcp-server","endpointFingerprint":"6c37d15aefff7aeb0f863333560c10d2c6df24a7d0cf630a425fb0ff18bf6374","name":"imf_query_dataset","title":"Imf Query Dataset","description":"Query an IMF SDMX dataflow by dimension key over a time range. Returns observations with time_period, value, and status, plus the unit, scale, and decimals of each series — a key resolving to several series carries one entry per series in series_metadata, since unit and scale differ between them. An index series also carries the reference_period it is based on (e.g. 2010A, 2010=100) exactly as published, on the series and, where the dataflow publishes one per observation, on each observation. 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). Every position must carry a code: use + to combine codes (e.g. USA+GBR.NGDP_RPCH.A) and * to match every code at a position (e.g. *.NGDP_RPCH.A for all countries); * stands alone and cannot join a + list. Codes are matched case-insensitively and checked against each dimension's codelist before the query — an unknown code is rejected with the nearest valid codes. 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. When a + key returns data for some requested series and none for others, missing_series names each empty one with the reason a query for it alone gives (no_data or no_data_in_range). When the extra request that recovers the unit, scale, or decimals a + key suppresses fails, unresolved_attributes names them and how to get them. start_period and end_period must be valid period strings (YYYY, YYYY-SN, YYYY-QN, YYYY-MM, or a calendar-valid YYYY-MM-DD) with start_period no later than end_period; malformed or reversed ranges are rejected. A bound covers the whole period it names, so end_period 2023 includes 2023-M12 and 2023-Q4. last_n_observations keeps each series' last N observations — 1 is each series' latest value, the cheap way to ask many countries for their latest figure. Values are in base units everywhere, staged canvas rows included: scale is the power of ten the IMF publishes a series in (value / 10^scale is the published figure), never a factor still to apply. An inline response is held to 100,000 serialized characters. With DataCanvas enabled (CANVAS_PROVIDER_TYPE=duckdb), a larger result (multi-country, long time range) spills to it and returns a preview, the attributes of its first 20 series and at most 100 observations: call imf_dataframe_describe first to inspect staged tables and columns, then imf_dataframe_query for SQL analysis. Without DataCanvas, or with it at its canvas cap when an auto-mode call omits canvas_id, a larger result returns its earliest observations with truncated=true, and retrieval_guidance names the last period returned and how to narrow the query.","inputSchema":{"type":"object","properties":{"dataflow_id":{"type":"string","description":"Dataflow identifier from imf_list_databases, e.g. WEO, BOP, CPI. Matched case-insensitively; the response echoes the catalog spelling."},"agency_id":{"description":"Agency ID, e.g. IMF.RES or IMF.STA, matched case-insensitively. Auto-detected from dataflow list when omitted.","type":"string"},"version":{"description":"Dataflow version, e.g. 9.0.0. Auto-detected from dataflow list when omitted.","type":"string"},"key":{"type":"string","description":"Dot-separated dimension codes in DSD keyPosition order. Call imf_get_database to get key_format and valid codes first. Use + to combine codes at one position (e.g. USA+GBR.NGDP_RPCH.A). Use * to match every code at a position — *.NGDP_RPCH.A returns the indicator for all countries, and CAN.*.A every indicator for Canada. Every position needs a code or a *; an empty segment (USA..A) is rejected. A * stands alone at its position — combined with other codes (USA+*) it is rejected. Codes are trimmed and matched case-insensitively (usa resolves to USA), empty and repeated + members are dropped (USA++GBR+USA is queried as USA+GBR, and notice says so), and the response echoes the canonical key. A code missing from its dimension's codelist is rejected before the query, naming the nearest valid codes. The portal limits the request URL, so a + list of a few hundred codes is rejected as too long — use * there, or split the codes across calls. Country codes are ISO 3-letter: USA not US, GBR not GB, DEU not DE."},"start_period":{"description":"Start of time range (inclusive). Accepts any of YYYY (annual), YYYY-SN (semi-annual, e.g. 2023-S1), YYYY-QN (quarterly, e.g. 2023-Q1), YYYY-MM (monthly), or a calendar-valid YYYY-MM-DD (daily), whatever the dataflow's frequency. The bound covers the whole period it names, so start_period 2023 admits 2023-M01 and 2023-Q1. Observations before this period are excluded from the result.","type":"string"},"end_period":{"description":"End of time range (inclusive). Same formats as start_period, and must not be earlier than it. The bound covers the whole period it names, so end_period 2023 admits 2023-M12 and 2023-Q4. Observations after this period are excluded from the result.","type":"string"},"last_n_observations":{"description":"Keep only each series' last N observations, an integer from 1 to 1,000,000; 1 returns each series' latest value. Latest is per series: series end at different periods, and a WEO series ends in its projection years (e.g. 2031), so set end_period to stop at a past year. With start_period or end_period, the last N inside that range. A series with fewer than N observations is returned whole. Omit to return every observation.","type":"integer","minimum":1,"maximum":1000000},"canvas_id":{"description":"Existing canvas ID to accumulate results into across multiple queries. This selects the destination only; it does not force staging. Use output_mode=\"canvas\" to stage an under-budget result. A canvas_id that has expired fails as canvas_not_found once the result is staged: omit it to stage onto a fresh canvas. At the canvas cap only a canvas_id you hold can stage; omitted there, auto mode returns the result inline and output_mode=\"canvas\" fails as canvas_capacity_exhausted.","type":"string","pattern":"^[A-Za-z0-9_-]{10}$"},"output_mode":{"description":"Result placement. auto returns an under-budget result inline and spills only when needed. canvas explicitly stages the full result, using canvas_id when supplied or allocating a fresh canvas.","default":"auto","type":"string","enum":["auto","canvas"]}},"required":["dataflow_id","key"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"0bcfb4c42ba42449709417d2128e1482e9d388815444d06fe4eca35bbcacff43","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:47.855Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"6c37d15aefff7aeb0f863333560c10d2c6df24a7d0cf630a425fb0ff18bf6374","protocol":"streamable-http","status":"indexed","toolCount":5,"observedAt":"2026-11-19T07:46:47.855Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.cyanheads/imf-mcp-server":{"url":"https://imf.caseyjhand.com/mcp"}}},"Cursor":{"mcpServers":{"io.github.cyanheads/imf-mcp-server":{"url":"https://imf.caseyjhand.com/mcp"}}},"VS Code":{"servers":{"io.github.cyanheads/imf-mcp-server":{"type":"http","url":"https://imf.caseyjhand.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://imf.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/imf-mcp-server","registryType":"npm","version":"0.4.4"},{"protocol":"mcp","package":"@cyanheads/imf-mcp-server","registryType":"npm","version":"0.4.4"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.cyanheads%2Fimf-mcp-server","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.cyanheads%2Fimf-mcp-server","name":"io.github.cyanheads/imf-mcp-server","description":"Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://imf.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/imf-mcp-server","registryType":"npm","version":"0.4.4"},{"protocol":"mcp","package":"@cyanheads/imf-mcp-server","registryType":"npm","version":"0.4.4"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/imf-mcp-server","version":"0.4.4"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.cyanheads/imf-mcp-server","status":"online","lastCheckedAt":"2026-11-20T09:18:04.335Z","lastSuccessfulCheck":"2026-11-20T09:18:04.335Z","latencyMs":298,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T09:18:04.335Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T09:18:04.335Z"},"security":null,"timestamps":{"createdAt":"2026-10-16T17:54:41.516Z","updatedAt":"2026-10-16T17:54:41.516Z","observedAt":"2026-11-20T09:18:04.335Z"},"compatibility":{"serverVersion":"0.4.4","protocolVersions":[{"protocol":"mcp","version":null}]}}}}