@cyanheads/imf-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/imf-get-database.tool.js

@@ -0,0 +1,155 @@
+/**
+ * @fileoverview Tool: imf_get_database — fetch a dataflow's dimension list and codelists.
+ * @module mcp-server/tools/definitions/imf-get-database.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getImfSdmxService } from '../../../services/imf-sdmx/imf-sdmx-service.js';
+const MAX_CODELIST_ENTRIES = 50;
+export const imfGetDatabase = tool('imf_get_database', {
+    description: "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.',
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    input: z.object({
+        dataflow_id: z
+            .string()
+            .describe('Dataflow identifier from imf_list_databases, e.g. WEO, BOP, CPI. ' + 'Case-sensitive.'),
+        agency_id: z
+            .string()
+            .optional()
+            .describe('Agency ID that publishes this dataflow, e.g. IMF.RES or IMF.STA. ' +
+            'Auto-detected from the dataflow list when omitted.'),
+        version: z
+            .string()
+            .optional()
+            .describe('Dataflow version, e.g. 9.0.0. Auto-detected from the dataflow list when omitted.'),
+    }),
+    output: z.object({
+        dataflow_id: z.string().describe('Dataflow identifier, e.g. WEO, BOP, CPI.'),
+        agency_id: z.string().describe('Agency that publishes this dataflow, e.g. IMF.RES, IMF.STA.'),
+        version: z.string().describe('Dataflow version string, e.g. 9.0.0.'),
+        name: z.string().describe('Human-readable dataflow name.'),
+        description: z.string().optional().describe('Extended description, if available.'),
+        key_format: z
+            .string()
+            .describe('Dimension names in dot-separated keyPosition order, e.g. COUNTRY.INDICATOR.FREQUENCY. ' +
+            'Use this exact format when constructing the key for imf_query_dataset.'),
+        dimensions: z
+            .array(z
+            .object({
+            id: z.string().describe('Dimension identifier used in the key, e.g. COUNTRY.'),
+            name: z.string().describe('Human-readable dimension name.'),
+            position: z.number().describe('Zero-based position in the key string.'),
+            codelist: z
+                .array(z
+                .object({
+                id: z.string().describe('Machine code for this dimension value, e.g. USA.'),
+                name: z
+                    .string()
+                    .describe('Human-readable label for this value, e.g. United States.'),
+            })
+                .describe('A single codelist entry: machine code and human-readable name.'))
+                .describe('Valid codes for this dimension. ' +
+                `Up to ${MAX_CODELIST_ENTRIES} entries shown; full list available via the imf://database resource.`),
+            codelist_truncated: z
+                .boolean()
+                .describe(`True when the codelist has more than ${MAX_CODELIST_ENTRIES} entries and was truncated.`),
+        })
+            .describe('A single dimension with its codelist.'))
+            .describe('All dimensions of this dataflow with their codelists.'),
+    }),
+    errors: [
+        {
+            reason: 'dataflow_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'dataflow_id does not match any known dataflow on api.imf.org',
+            recovery: 'Call imf_list_databases to browse available dataflow IDs.',
+        },
+        {
+            reason: 'structure_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'api.imf.org returns non-200 on the DSD endpoint',
+            recovery: 'Retry after a short wait; the IMF SDMX 3.0 portal is occasionally slow.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getImfSdmxService();
+        const dataflow = await svc.findDataflow(input.dataflow_id, input.agency_id, input.version, ctx);
+        if (!dataflow) {
+            throw ctx.fail('dataflow_not_found', `Dataflow '${input.dataflow_id}' not found`, {
+                dataflowId: input.dataflow_id,
+                ...ctx.recoveryFor('dataflow_not_found'),
+            });
+        }
+        let structure;
+        try {
+            structure = await svc.fetchDataflowStructure(input.dataflow_id, input.agency_id ?? dataflow.agencyId, input.version ?? dataflow.version, ctx);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('not found')) {
+                throw ctx.fail('dataflow_not_found', msg, ctx.recoveryFor('dataflow_not_found'));
+            }
+            throw ctx.fail('structure_unavailable', msg, ctx.recoveryFor('structure_unavailable'));
+        }
+        ctx.log.info('Dataflow structure fetched', {
+            dataflowId: input.dataflow_id,
+            dimensions: structure.dimensions.length,
+        });
+        const dimensions = structure.dimensions.map((dim) => {
+            const truncated = dim.codelist.length > MAX_CODELIST_ENTRIES;
+            return {
+                id: dim.id,
+                name: dim.name,
+                position: dim.position,
+                codelist: dim.codelist.slice(0, MAX_CODELIST_ENTRIES),
+                codelist_truncated: truncated,
+            };
+        });
+        return {
+            dataflow_id: structure.dataflowId,
+            agency_id: structure.agencyId,
+            version: structure.version,
+            name: structure.name,
+            ...(structure.description ? { description: structure.description } : {}),
+            key_format: structure.keyFormat,
+            dimensions,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## ${result.name}`);
+        lines.push(`**Dataflow:** ${result.dataflow_id} | **Agency:** ${result.agency_id} | **Version:** ${result.version}`);
+        if (result.description)
+            lines.push(`\n${result.description}`);
+        lines.push(`\n**Key format:** \`${result.key_format}\``);
+        lines.push('\n### Dimensions\n');
+        for (const dim of result.dimensions) {
+            lines.push(`#### ${dim.id} (position ${dim.position})`);
+            lines.push(`**Name:** ${dim.name}`);
+            if (dim.codelist.length > 0) {
+                lines.push('**Codes:**');
+                for (const code of dim.codelist) {
+                    lines.push(`- \`${code.id}\` — ${code.name}`);
+                }
+                if (dim.codelist_truncated) {
+                    lines.push(`_(truncated at ${MAX_CODELIST_ENTRIES} entries)_`);
+                }
+            }
+            else {
+                lines.push('_(no codelist entries available)_');
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=imf-get-database.tool.js.map

package/dist/mcp-server/tools/definitions/imf-get-database.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-get-database.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-get-database.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/imf-list-databases.tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Tool: imf_list_databases — list all IMF SDMX dataflows available on the portal.
+ * @module mcp-server/tools/definitions/imf-list-databases.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const imfListDatabases: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    include_vintages: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    dataflows: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        agency_id: z.ZodString;
+        version: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total_count: z.ZodNumber;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=imf-list-databases.tool.d.ts.map

package/dist/mcp-server/tools/definitions/imf-list-databases.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-list-databases.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-list-databases.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;wCAiG3B,CAAC"}

package/dist/mcp-server/tools/definitions/imf-list-databases.tool.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Tool: imf_list_databases — list all IMF SDMX dataflows available on the portal.
+ * @module mcp-server/tools/definitions/imf-list-databases.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getImfSdmxService } from '../../../services/imf-sdmx/imf-sdmx-service.js';
+const VINTAGE_PATTERN = /VINTAGE/i;
+export const imfListDatabases = tool('imf_list_databases', {
+    description: 'List all IMF SDMX dataflows available on the portal (193 total). ' +
+        '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.',
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    input: z.object({
+        filter: z
+            .string()
+            .optional()
+            .describe('Optional name or ID substring to filter results. Case-insensitive. ' +
+            'Example: "exchange rate" returns ER and related dataflows.'),
+        include_vintages: z
+            .boolean()
+            .default(false)
+            .describe('Include vintage (historical snapshot) dataflows such as WEO_2025_OCT_VINTAGE. ' +
+            'Default false — vintages are excluded to keep the discovery surface clean.'),
+    }),
+    output: z.object({
+        dataflows: z
+            .array(z
+            .object({
+            id: z.string().describe('Dataflow identifier, e.g. WEO, BOP, CPI.'),
+            agency_id: z.string().describe('Agency that publishes this dataflow, e.g. IMF.RES.'),
+            version: z.string().describe('Dataflow version, e.g. 9.0.0.'),
+            name: z.string().describe('Human-readable dataflow name.'),
+            description: z
+                .string()
+                .optional()
+                .describe('Extended description of the dataflow, if available.'),
+        })
+            .describe('A single IMF SDMX dataflow entry.'))
+            .describe('Matching dataflows; pass the id to imf_get_database to resolve dimension codelists.'),
+        total_count: z.number().describe('Total number of matching dataflows returned.'),
+    }),
+    async handler(input, ctx) {
+        const svc = getImfSdmxService();
+        let dataflows = await svc.fetchDataflows(ctx);
+        // Filter vintages
+        if (!input.include_vintages) {
+            dataflows = dataflows.filter((df) => !VINTAGE_PATTERN.test(df.id));
+        }
+        // Name/ID substring filter
+        const filterLower = input.filter?.toLowerCase().trim();
+        if (filterLower) {
+            dataflows = dataflows.filter((df) => df.id.toLowerCase().includes(filterLower) ||
+                df.name.toLowerCase().includes(filterLower) ||
+                (df.description?.toLowerCase().includes(filterLower) ?? false));
+        }
+        ctx.log.info('Dataflows listed', { count: dataflows.length, filter: input.filter });
+        const result = {
+            dataflows: dataflows.map((df) => ({
+                id: df.id,
+                agency_id: df.agencyId,
+                version: df.version,
+                name: df.name,
+                ...(df.description ? { description: df.description } : {}),
+            })),
+            total_count: dataflows.length,
+        };
+        return result;
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.total_count} dataflow${result.total_count === 1 ? '' : 's'}**\n`,
+        ];
+        for (const df of result.dataflows) {
+            lines.push(`### ${df.id}`);
+            lines.push(`**Agency:** ${df.agency_id} | **Version:** ${df.version}`);
+            lines.push(`**Name:** ${df.name}`);
+            if (df.description)
+                lines.push(df.description);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=imf-list-databases.tool.js.map

package/dist/mcp-server/tools/definitions/imf-list-databases.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-list-databases.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-list-databases.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/imf-query-dataset.tool.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Tool: imf_query_dataset — query a dataflow by dimension key over a time range.
+ * Large result sets spill to DataCanvas for SQL analysis.
+ * @module mcp-server/tools/definitions/imf-query-dataset.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const imfQueryDataset: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dataflow_id: z.ZodString;
+    agency_id: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    start_period: z.ZodOptional<z.ZodString>;
+    end_period: z.ZodOptional<z.ZodString>;
+    canvas_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    dataflow_id: z.ZodString;
+    key: z.ZodString;
+    start_period: z.ZodOptional<z.ZodString>;
+    end_period: z.ZodOptional<z.ZodString>;
+    observations: z.ZodArray<z.ZodObject<{
+        series_key: z.ZodString;
+        time_period: z.ZodString;
+        value: z.ZodNullable<z.ZodNumber>;
+        status: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    series_attributes: z.ZodObject<{
+        unit: z.ZodNullable<z.ZodString>;
+        scale: z.ZodNullable<z.ZodString>;
+        decimals: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    observation_count: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    canvas_id: z.ZodOptional<z.ZodString>;
+    table_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "dataflow_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "dataflow_id does not match any known dataflow on api.imf.org";
+    readonly recovery: "Call imf_list_databases to browse available dataflow IDs.";
+}, {
+    readonly reason: "no_data";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Key is structurally valid but returns an empty dataset — typically an unknown dimension code or no data for the time range";
+    readonly recovery: "Verify dimension codes with imf_get_database; check that start_period/end_period overlap available data.";
+}, {
+    readonly reason: "key_dimension_mismatch";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Number of dot-separated segments in key does not match the dataflow's DSD dimension count";
+    readonly recovery: "Call imf_get_database to get the correct key_format for this dataflow, then reconstruct the key.";
+}, {
+    readonly reason: "structure_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "api.imf.org returns non-200 on the data endpoint";
+    readonly recovery: "Retry after a short wait.";
+}], undefined>;
+//# sourceMappingURL=imf-query-dataset.tool.d.ts.map

package/dist/mcp-server/tools/definitions/imf-query-dataset.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-query-dataset.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-query-dataset.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkV1B,CAAC"}

package/dist/mcp-server/tools/definitions/imf-query-dataset.tool.js

@@ -0,0 +1,277 @@
+/**
+ * @fileoverview Tool: imf_query_dataset — query a dataflow by dimension key over a time range.
+ * Large result sets spill to DataCanvas for SQL analysis.
+ * @module mcp-server/tools/definitions/imf-query-dataset.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { spillover } from '@cyanheads/mcp-ts-core/canvas';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCanvas } from '../../../services/canvas/canvas-accessor.js';
+import { getImfSdmxService } from '../../../services/imf-sdmx/imf-sdmx-service.js';
+const PREVIEW_CHARS = 100_000;
+export const imfQueryDataset = tool('imf_query_dataset', {
+    description: '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). ' +
+        'Large analytical result sets (multi-country, long time range) spill to DataCanvas; ' +
+        'imf_dataframe_query provides SQL analysis of spilled results.',
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    input: z.object({
+        dataflow_id: z
+            .string()
+            .describe('Dataflow identifier from imf_list_databases, e.g. WEO, BOP, CPI.'),
+        agency_id: z
+            .string()
+            .optional()
+            .describe('Agency ID, e.g. IMF.RES or IMF.STA. Auto-detected from dataflow list when omitted.'),
+        version: z
+            .string()
+            .optional()
+            .describe('Dataflow version. Auto-detected from dataflow list when omitted.'),
+        key: z
+            .string()
+            .describe('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 ISO 3-letter: USA not US, GBR not GB, DEU not DE.'),
+        start_period: z
+            .string()
+            .optional()
+            .describe('Requested start of time range. Format matches the dataflow frequency: ' +
+            'YYYY (annual), YYYY-QN (quarterly, e.g. 2023-Q1), YYYY-MM (monthly). ' +
+            'Note: the IMF SDMX 3.0 compact JSON endpoint returns the full available series ' +
+            'regardless of this parameter — observations outside the requested range may still appear.'),
+        end_period: z
+            .string()
+            .optional()
+            .describe('Requested end of time range. Same format as start_period. ' +
+            'See start_period note: the API returns the full series; this parameter is passed through ' +
+            'but may not filter observations.'),
+        canvas_id: z
+            .string()
+            .optional()
+            .describe('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.'),
+    }),
+    output: z.object({
+        dataflow_id: z.string().describe('Dataflow identifier that was queried, e.g. WEO.'),
+        key: z.string().describe('Dimension key used in the query, e.g. USA.NGDP_RPCH.A.'),
+        start_period: z
+            .string()
+            .optional()
+            .describe('Earliest period covered; absent when the full available range was used.'),
+        end_period: z
+            .string()
+            .optional()
+            .describe('Latest period covered; absent when the full available range was used.'),
+        observations: z
+            .array(z
+            .object({
+            series_key: z
+                .string()
+                .describe('Dot-separated dimension codes identifying this series, e.g. USA.NGDP_RPCH.A. ' +
+                'Matches the single-country equivalent of the query key — useful when a query covers multiple countries.'),
+            time_period: z.string().describe('Time label, e.g. 2023 or 2023-Q1 or 2023-01.'),
+            value: z.number().nullable().describe('Observation value, null when missing.'),
+            status: z
+                .string()
+                .nullable()
+                .describe('Observation status flag, e.g. E (estimate) or null when absent.'),
+        })
+            .describe('A single time-series observation.'))
+            .describe('Inline observations. Empty when results spilled to canvas (see canvas_id / table_name).'),
+        series_attributes: z
+            .object({
+            unit: z.string().nullable().describe('Unit of measure, e.g. Percent, USD.'),
+            scale: z.string().nullable().describe('Scale multiplier, e.g. Billions.'),
+            decimals: z.number().nullable().describe('Number of decimal places shown.'),
+        })
+            .describe('Series-level attributes (unit, scale, decimals).'),
+        observation_count: z.number().describe('Total observations in the result.'),
+        truncated: z
+            .boolean()
+            .describe('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.'),
+        canvas_id: z
+            .string()
+            .optional()
+            .describe('DataCanvas session ID — present when truncated=true. ' +
+            'Pass to imf_dataframe_query or imf_dataframe_describe to query the full result.'),
+        table_name: z
+            .string()
+            .optional()
+            .describe('DuckDB table name on the canvas — present when truncated=true; reference in SQL via FROM <table_name>.'),
+    }),
+    errors: [
+        {
+            reason: 'dataflow_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'dataflow_id does not match any known dataflow on api.imf.org',
+            recovery: 'Call imf_list_databases to browse available dataflow IDs.',
+        },
+        {
+            reason: 'no_data',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Key is structurally valid but returns an empty dataset — typically an unknown dimension code or no data for the time range',
+            recovery: 'Verify dimension codes with imf_get_database; check that start_period/end_period overlap available data.',
+        },
+        {
+            reason: 'key_dimension_mismatch',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: "Number of dot-separated segments in key does not match the dataflow's DSD dimension count",
+            recovery: 'Call imf_get_database to get the correct key_format for this dataflow, then reconstruct the key.',
+        },
+        {
+            reason: 'structure_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'api.imf.org returns non-200 on the data endpoint',
+            recovery: 'Retry after a short wait.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getImfSdmxService();
+        // Resolve dataflow
+        const dataflow = await svc.findDataflow(input.dataflow_id, input.agency_id, input.version, ctx);
+        if (!dataflow) {
+            throw ctx.fail('dataflow_not_found', `Dataflow '${input.dataflow_id}' not found`, {
+                dataflowId: input.dataflow_id,
+                ...ctx.recoveryFor('dataflow_not_found'),
+            });
+        }
+        // Get DSD to validate key dimension count
+        let structure;
+        try {
+            structure = await svc.fetchDataflowStructure(input.dataflow_id, input.agency_id ?? dataflow.agencyId, input.version ?? dataflow.version, ctx);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('not found')) {
+                throw ctx.fail('dataflow_not_found', msg, ctx.recoveryFor('dataflow_not_found'));
+            }
+            throw ctx.fail('structure_unavailable', msg, ctx.recoveryFor('structure_unavailable'));
+        }
+        // Validate key dimension count
+        const expectedDims = structure.dimensions.length;
+        const keySegments = input.key.split('.');
+        if (expectedDims > 0 && keySegments.length !== expectedDims) {
+            throw ctx.fail('key_dimension_mismatch', `Key has ${keySegments.length} segment(s) but dataflow '${input.dataflow_id}' has ${expectedDims} dimension(s) (${structure.keyFormat})`, {
+                keySegments: keySegments.length,
+                expectedDimensions: expectedDims,
+                keyFormat: structure.keyFormat,
+                ...ctx.recoveryFor('key_dimension_mismatch'),
+            });
+        }
+        // Fetch data
+        let queryResult;
+        try {
+            queryResult = await svc.fetchData(dataflow.agencyId, input.dataflow_id, dataflow.version, input.key, input.start_period, input.end_period, ctx, ctx.signal);
+        }
+        catch {
+            throw ctx.fail('structure_unavailable', `IMF SDMX data endpoint unavailable for dataflow '${input.dataflow_id}'`, ctx.recoveryFor('structure_unavailable'));
+        }
+        // Detect empty result
+        if (queryResult.observations.length === 0) {
+            throw ctx.fail('no_data', `No data returned for key '${input.key}' in dataflow '${input.dataflow_id}'`, {
+                key: input.key,
+                dataflowId: input.dataflow_id,
+                ...ctx.recoveryFor('no_data'),
+            });
+        }
+        ctx.log.info('Data query completed', {
+            dataflowId: input.dataflow_id,
+            key: input.key,
+            observations: queryResult.observations.length,
+        });
+        // Canvas spill path
+        const canvas = getCanvas();
+        if (canvas) {
+            const instance = await canvas.acquire(input.canvas_id, ctx);
+            const rows = queryResult.observations.map((obs) => ({
+                dataflow_id: input.dataflow_id,
+                series_key: obs.series_key,
+                time_period: obs.time_period,
+                value: obs.value,
+                status: obs.status,
+                unit: queryResult.seriesAttributes.unit,
+                scale: queryResult.seriesAttributes.scale,
+                decimals: queryResult.seriesAttributes.decimals,
+            }));
+            const result = await spillover({
+                canvas: instance,
+                source: rows,
+                previewChars: PREVIEW_CHARS,
+                signal: ctx.signal,
+            });
+            if (result.spilled) {
+                return {
+                    dataflow_id: input.dataflow_id,
+                    key: input.key,
+                    ...(input.start_period ? { start_period: input.start_period } : {}),
+                    ...(input.end_period ? { end_period: input.end_period } : {}),
+                    observations: result.previewRows.map((r) => ({
+                        series_key: r.series_key,
+                        time_period: r.time_period,
+                        value: r.value,
+                        status: r.status,
+                    })),
+                    series_attributes: queryResult.seriesAttributes,
+                    observation_count: result.handle.rowCount,
+                    truncated: true,
+                    canvas_id: instance.canvasId,
+                    table_name: result.handle.tableName,
+                };
+            }
+        }
+        // Inline path (no canvas, or result fit in preview)
+        return {
+            dataflow_id: input.dataflow_id,
+            key: input.key,
+            ...(input.start_period ? { start_period: input.start_period } : {}),
+            ...(input.end_period ? { end_period: input.end_period } : {}),
+            observations: queryResult.observations,
+            series_attributes: queryResult.seriesAttributes,
+            observation_count: queryResult.observations.length,
+            truncated: false,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## IMF Data: ${result.dataflow_id} — \`${result.key}\``);
+        if (result.start_period || result.end_period) {
+            const range = [result.start_period, result.end_period].filter(Boolean).join(' – ');
+            lines.push(`**Requested period:** ${range} _(note: the IMF API returns the full available series; observations may extend beyond this range)_`);
+        }
+        const { unit, scale, decimals } = result.series_attributes;
+        if (unit || scale) {
+            const meta = [unit, scale, decimals != null ? `${decimals} decimals` : null]
+                .filter(Boolean)
+                .join(' | ');
+            lines.push(`**Series:** ${meta}`);
+        }
+        lines.push(`**Observations:** ${result.observation_count} | **Truncated:** ${result.truncated}`);
+        if (result.truncated) {
+            lines.push(`\n> Result exceeds inline limit. Full dataset staged on canvas.` +
+                `\n> **Canvas ID:** \`${result.canvas_id}\`` +
+                `\n> **Table:** \`${result.table_name}\`` +
+                `\n> Use \`imf_dataframe_describe\` then \`imf_dataframe_query\` to analyze.`);
+        }
+        if (result.observations.length > 0) {
+            lines.push('\n| Series Key | Time Period | Value | Status |');
+            lines.push('|:-----------|:------------|------:|:-------|');
+            for (const obs of result.observations) {
+                const val = obs.value != null ? obs.value.toString() : '—';
+                const status = obs.status ?? '—';
+                lines.push(`| ${obs.series_key} | ${obs.time_period} | ${val} | ${status} |`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=imf-query-dataset.tool.js.map

package/dist/mcp-server/tools/definitions/imf-query-dataset.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-query-dataset.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-query-dataset.tool.ts"],"names":[],"mappings":"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"}