{"report":{"v":1,"package":"@cyanheads/imf-mcp-server","version":"0.6.0","ranAt":"2026-11-16T11:50:46.861Z","install":{"ok":true,"integrity":"sha512-rVmmyN5tGPKP9bZUmRJ+vV4OE/kS7qpttVGED4SsxCsEuksjzPHHXFJhlUVgDkmjzW4Tgez0SC5/4Lb7IgVUXw==","deps":47,"scripts":[],"bins":["imf-mcp-server"],"license":"Apache-2.0","engines":"node >=24.0.0","repository":"git+https://github.com/cyanheads/imf-mcp-server.git","bin":"imf-mcp-server"},"start":{"ok":true,"ms":366,"serverName":"imf-mcp-server","serverVersion":"0.6.0","protocol":"2025-06-18","stderr":"level\":20,\"time\":1794829860992,\"env\":\"development\",\"version\":\"0.6.0\",\"pid\":59,\"operation\":\"StorageService.set\",\"requestId\":\"LZ290-DG20K\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:51:00.315Z\",\"jsonRpcId\":3,\"toolName\":\"imf_list_databases\",\"key\":\"imf/dataflows/all\",\"hasTTL\":true,\"ttl\":3600,\"msg\":\"[StorageService] set operation\"}\n{\"level\":20,\"time\":1794829860992,\"env\":\"development\",\"version\":\"0.6.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"LZ290-DG20K\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:51:00.315Z\",\"jsonRpcId\":3,\"toolName\":\"imf_list_databases\",\"msg\":\"[InMemoryProvider] Setting key: imf/dataflows/all for tenant: default\"}\n{\"level\":30,\"time\":1794829860993,\"env\":\"development\",\"version\":\"0.6.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"LZ290-DG20K\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:51:00.315Z\",\"jsonRpcId\":3,\"toolName\":\"imf_list_databases\",\"count\":231,\"msg\":\"Dataflows fetched and cached\"}\n{\"level\":30,\"time\":1794829860993,\"env\":\"development\",\"version\":\"0.6.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"LZ290-DG20K\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:51:00.315Z\",\"jsonRpcId\":3,\"toolName\":\"imf_list_databases\",\"total\":105,\"returned\":50,\"offset\":0,\"msg\":\"Dataflows listed\"}\n{\"level\":30,\"time\":1794829860996,\"env\":\"development\",\"version\":\"0.6.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"LZ290-DG20K\",\"timestamp\":\"2026-11-16T11:51:00.315Z\",\"jsonRpcId\":3,\"toolName\":\"imf_list_databases\",\"metrics\":{\"durationMs\":678.69,\"isSuccess\":true,\"inputBytes\":48,\"outputBytes\":16294},\"msg\":\"Tool execution finished.\"}\n"},"tools":[{"name":"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.","params":["filter","include_vintages","limit","offset"]},{"name":"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.","params":["dataflow_id","agency_id","version","codelist_filter","available_only","dimension_id","limit","offset"]},{"name":"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.","params":["dataflow_id","agency_id","version","key","start_period","end_period","last_n_observations","canvas_id","output_mode"]},{"name":"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.","params":["canvas_id"]},{"name":"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.","params":["canvas_id","sql"]}],"toolsHash":"da9e61f7b0d0bcfb0c603eccc280addcfc636cf958384bfcebe7cb31751dbcac","wrote":[],"callsAt":"2026-11-16T11:50:59.311Z","calls":[{"tool":"imf_list_databases","ok":true,"ms":686,"bytes":15463}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":["api.imf.org"],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"very-long","tool":"imf_query_dataset","quote":"2871 characters or more"}],"tools":5,"wrote":0,"callsTried":1,"callsAnswered":1,"callContacts":["api.imf.org"]},"history":[{"package":"@cyanheads/imf-mcp-server","version":"0.6.0","ranAt":"2026-11-16T11:50:46.861Z","outcome":"started","tools":5,"contacts":0,"flags":1,"serious":0,"toolsHash":"da9e61f7b0d0bcfb0c603eccc280addcfc636cf958384bfcebe7cb31751dbcac"}],"page":"https://bragproof.smaverk.com/r/%40cyanheads/imf-mcp-server"}