@cyanheads/imf-mcp-server 0.1.1

package/dist/config/server-config.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Server-specific environment variable configuration for imf-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    baseUrl: z
+        .string()
+        .default('https://api.imf.org/external/sdmx/3.0')
+        .describe('IMF SDMX 3.0 base URL'),
+    requestTimeoutMs: z.coerce
+        .number()
+        .default(30_000)
+        .describe('Per-request timeout in milliseconds'),
+});
+let _config;
+/** Returns the parsed, cached server configuration. */
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        baseUrl: 'IMF_BASE_URL',
+        requestTimeoutMs: 'IMF_REQUEST_TIMEOUT_MS',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,OAAO,CAAC,uCAAuC,CAAC;SAChD,QAAQ,CAAC,uBAAuB,CAAC;IACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM;SACvB,MAAM,EAAE;SACR,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC,CAAC;AAEH,IAAI,OAAuD,CAAC;AAE5D,uDAAuD;AACvD,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,OAAO,EAAE,cAAc;QACvB,gBAAgB,EAAE,wBAAwB;KAC3C,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview imf-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview imf-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+import { allPromptDefinitions } from './mcp-server/prompts/definitions/index.js';
+import { allResourceDefinitions } from './mcp-server/resources/definitions/index.js';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { setCanvas } from './services/canvas/canvas-accessor.js';
+import { initImfSdmxService } from './services/imf-sdmx/imf-sdmx-service.js';
+await createApp({
+    tools: allToolDefinitions,
+    resources: allResourceDefinitions,
+    prompts: allPromptDefinitions,
+    instructions: 'IMF SDMX 3.0 macroeconomic data server. Keyless — no API key required.\n' +
+        'Workflow: imf_list_databases → imf_get_database → imf_query_dataset\n' +
+        'Country codes are ISO 3-letter (USA, GBR, DEU — not US, GB, DE).\n' +
+        'Large multi-country queries spill to DataCanvas; use imf_dataframe_query for SQL analysis.\n' +
+        'Key legacy note: the IFS monolithic database is decomposed — use CPI, ER, IL, MFS_* instead.',
+    setup(core) {
+        const cfg = getServerConfig();
+        initImfSdmxService(core.config, core.storage, cfg.baseUrl, cfg.requestTimeoutMs);
+        setCanvas(core.canvas);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,oBAAoB;IAC7B,YAAY,EACV,0EAA0E;QAC1E,uEAAuE;QACvE,oEAAoE;QACpE,8FAA8F;QAC9F,8FAA8F;IAChG,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACjF,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export for IMF MCP prompt definitions.
+ * No prompts — this is a pure data server.
+ * @module mcp-server/prompts/definitions/index
+ */
+export declare const allPromptDefinitions: never[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/prompts/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,EAAE,KAAK,EAAO,CAAC"}

package/dist/mcp-server/prompts/definitions/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export for IMF MCP prompt definitions.
+ * No prompts — this is a pure data server.
+ * @module mcp-server/prompts/definitions/index
+ */
+export const allPromptDefinitions = [];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/prompts/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAY,EAAE,CAAC"}

package/dist/mcp-server/resources/definitions/imf-database.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Resource: imf://database/{dataflow_id} — stable metadata for a dataflow.
+ * @module mcp-server/resources/definitions/imf-database.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const imfDatabaseResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    dataflow_id: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=imf-database.resource.d.ts.map

package/dist/mcp-server/resources/definitions/imf-database.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-database.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/imf-database.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,mBAAmB;;wCAqE9B,CAAC"}

package/dist/mcp-server/resources/definitions/imf-database.resource.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Resource: imf://database/{dataflow_id} — stable metadata for a dataflow.
+ * @module mcp-server/resources/definitions/imf-database.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { getImfSdmxService } from '../../../services/imf-sdmx/imf-sdmx-service.js';
+export const imfDatabaseResource = resource('imf://database/{dataflow_id}', {
+    name: 'imf-database',
+    title: 'IMF Dataflow Metadata',
+    description: 'Metadata for a single IMF SDMX dataflow — dimensions with full codelists, key_format, name, and description. ' +
+        'Stable URI-addressable reference for known dataflow IDs (WEO, BOP, CPI, etc.).',
+    mimeType: 'application/json',
+    params: z.object({
+        dataflow_id: z
+            .string()
+            .describe('Dataflow identifier from imf_list_databases, e.g. WEO, BOP, CPI.'),
+    }),
+    async handler(params, ctx) {
+        const svc = getImfSdmxService();
+        const dataflow = await svc.findDataflow(params.dataflow_id, undefined, undefined, ctx);
+        if (!dataflow) {
+            throw notFound(`Dataflow '${params.dataflow_id}' not found`, {
+                reason: 'dataflow_not_found',
+                dataflowId: params.dataflow_id,
+            });
+        }
+        let structure;
+        try {
+            structure = await svc.fetchDataflowStructure(params.dataflow_id, dataflow.agencyId, dataflow.version, ctx);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('not found')) {
+                throw notFound(`Dataflow '${params.dataflow_id}' not found`, {
+                    reason: 'dataflow_not_found',
+                    dataflowId: params.dataflow_id,
+                }, { cause: err });
+            }
+            throw serviceUnavailable(`Structure unavailable for dataflow '${params.dataflow_id}'`, {
+                reason: 'structure_unavailable',
+                dataflowId: params.dataflow_id,
+            }, { cause: err });
+        }
+        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: structure.dimensions.map((dim) => ({
+                id: dim.id,
+                name: dim.name,
+                position: dim.position,
+                codelist: dim.codelist,
+            })),
+        };
+    },
+});
+//# sourceMappingURL=imf-database.resource.js.map

package/dist/mcp-server/resources/definitions/imf-database.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-database.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/imf-database.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,8BAA8B,EAAE;IAC1E,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,+GAA+G;QAC/G,gFAAgF;IAClF,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,CAAC,kEAAkE,CAAC;KAChF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACvF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,QAAQ,CAAC,aAAa,MAAM,CAAC,WAAW,aAAa,EAAE;gBAC3D,MAAM,EAAE,oBAAoB;gBAC5B,UAAU,EAAE,MAAM,CAAC,WAAW;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAiE,CAAC;QACtE,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,GAAG,CAAC,sBAAsB,CAC1C,MAAM,CAAC,WAAW,EAClB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,EAChB,GAAG,CACJ,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9B,MAAM,QAAQ,CACZ,aAAa,MAAM,CAAC,WAAW,aAAa,EAC5C;oBACE,MAAM,EAAE,oBAAoB;oBAC5B,UAAU,EAAE,MAAM,CAAC,WAAW;iBAC/B,EACD,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;YACD,MAAM,kBAAkB,CACtB,uCAAuC,MAAM,CAAC,WAAW,GAAG,EAC5D;gBACE,MAAM,EAAE,uBAAuB;gBAC/B,UAAU,EAAE,MAAM,CAAC,WAAW;aAC/B,EACD,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;QAED,OAAO;YACL,WAAW,EAAE,SAAS,CAAC,UAAU;YACjC,SAAS,EAAE,SAAS,CAAC,QAAQ;YAC7B,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,UAAU,EAAE,SAAS,CAAC,SAAS;YAC/B,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC7C,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Barrel export for all IMF MCP resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+export { imfDatabaseResource } from './imf-database.resource.js';
+export declare const allResourceDefinitions: import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    dataflow_id: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, undefined>[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIjE,eAAO,MAAM,sBAAsB;;yDAAwB,CAAC"}

package/dist/mcp-server/resources/definitions/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel export for all IMF MCP resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+export { imfDatabaseResource } from './imf-database.resource.js';
+import { imfDatabaseResource } from './imf-database.resource.js';
+export const allResourceDefinitions = [imfDatabaseResource];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/imf-dataframe-describe.tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Tool: imf_dataframe_describe — list DataCanvas tables and columns.
+ * @module mcp-server/tools/definitions/imf-dataframe-describe.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const imfDataframeDescribe: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    canvas_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    canvas_id: z.ZodString;
+    tables: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        row_count: z.ZodNumber;
+        columns: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    table_count: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "canvas_id does not match any registered DataCanvas table (expired, wrong session, or canvas disabled)";
+    readonly recovery: "Re-run imf_query_dataset to obtain a fresh canvas_id; ensure CANVAS_PROVIDER_TYPE=duckdb is set.";
+}], undefined>;
+//# sourceMappingURL=imf-dataframe-describe.tool.d.ts.map

package/dist/mcp-server/tools/definitions/imf-dataframe-describe.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imf-dataframe-describe.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-dataframe-describe.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;cA0G/B,CAAC"}

package/dist/mcp-server/tools/definitions/imf-dataframe-describe.tool.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Tool: imf_dataframe_describe — list DataCanvas tables and columns.
+ * @module mcp-server/tools/definitions/imf-dataframe-describe.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCanvas } from '../../../services/canvas/canvas-accessor.js';
+export const imfDataframeDescribe = tool('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.',
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    input: z.object({
+        canvas_id: z
+            .string()
+            .describe('Canvas ID returned by imf_query_dataset when results were too large for inline delivery.'),
+    }),
+    output: z.object({
+        canvas_id: z.string().describe('Canvas session ID that was introspected.'),
+        tables: z
+            .array(z
+            .object({
+            name: z.string().describe('Table name — use this in imf_dataframe_query SQL.'),
+            row_count: z.number().describe('Number of rows in this table.'),
+            columns: z
+                .array(z
+                .object({
+                name: z
+                    .string()
+                    .describe('Column name — use this in SELECT and WHERE clauses.'),
+                type: z.string().describe('DuckDB column type, e.g. VARCHAR, DOUBLE, BIGINT.'),
+            })
+                .describe('A single column definition.'))
+                .describe('Column schema for this table.'),
+        })
+            .describe('A single canvas table with its schema.'))
+            .describe('All tables registered on this canvas.'),
+        table_count: z.number().describe('Total number of tables on the canvas.'),
+    }),
+    errors: [
+        {
+            reason: 'canvas_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'canvas_id does not match any registered DataCanvas table (expired, wrong session, or canvas disabled)',
+            recovery: 'Re-run imf_query_dataset to obtain a fresh canvas_id; ensure CANVAS_PROVIDER_TYPE=duckdb is set.',
+        },
+    ],
+    async handler(input, ctx) {
+        const canvas = getCanvas();
+        if (!canvas) {
+            throw ctx.fail('canvas_not_found', 'DataCanvas is not enabled. Set CANVAS_PROVIDER_TYPE=duckdb.', ctx.recoveryFor('canvas_not_found'));
+        }
+        let instance;
+        try {
+            instance = await canvas.acquire(input.canvas_id, ctx);
+        }
+        catch {
+            throw ctx.fail('canvas_not_found', `Canvas '${input.canvas_id}' not found or expired`, {
+                canvasId: input.canvas_id,
+                ...ctx.recoveryFor('canvas_not_found'),
+            });
+        }
+        const tableInfos = await instance.describe();
+        ctx.log.info('Canvas described', { canvasId: input.canvas_id, tables: tableInfos.length });
+        return {
+            canvas_id: instance.canvasId,
+            tables: tableInfos.map((t) => ({
+                name: t.name,
+                row_count: t.rowCount,
+                columns: t.columns.map((c) => ({ name: c.name, type: c.type })),
+            })),
+            table_count: tableInfos.length,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Canvas:** \`${result.canvas_id}\``,
+            `**Tables:** ${result.table_count}\n`,
+        ];
+        for (const t of result.tables) {
+            lines.push(`### ${t.name} (${t.row_count} rows)`);
+            lines.push('| Column | Type |');
+            lines.push('|:-------|:-----|');
+            for (const col of t.columns) {
+                lines.push(`| ${col.name} | ${col.type} |`);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=imf-dataframe-describe.tool.js.map

package/dist/mcp-server/tools/definitions/imf-dataframe-describe.tool.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Tool: imf_dataframe_query — run read-only SQL SELECT against a DataCanvas table.
+ * @module mcp-server/tools/definitions/imf-dataframe-query.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const imfDataframeQuery: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    canvas_id: z.ZodString;
+    sql: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    row_count: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "canvas_id does not match any registered DataCanvas table (expired, wrong session, or canvas disabled)";
+    readonly recovery: "Re-run imf_query_dataset to obtain a fresh canvas_id; ensure CANVAS_PROVIDER_TYPE=duckdb is set.";
+}, {
+    readonly reason: "invalid_sql";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "sql does not start with SELECT — DML and DDL statements are not permitted";
+    readonly recovery: "Rewrite the statement as a SELECT query referencing tables from imf_dataframe_describe.";
+}], undefined>;
+//# sourceMappingURL=imf-dataframe-query.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imf-dataframe-query.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-dataframe-query.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;cAmH5B,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Tool: imf_dataframe_query — run read-only SQL SELECT against a DataCanvas table.
+ * @module mcp-server/tools/definitions/imf-dataframe-query.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCanvas } from '../../../services/canvas/canvas-accessor.js';
+export const imfDataframeQuery = tool('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. ' +
+        'Only SELECT statements are accepted — DML and DDL are rejected.',
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    input: z.object({
+        canvas_id: z
+            .string()
+            .describe('Canvas ID returned by imf_query_dataset when results were too large for inline delivery.'),
+        sql: z
+            .string()
+            .describe('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 >= '2010' ORDER BY time_period."),
+    }),
+    output: z.object({
+        rows: z
+            .array(z
+            .record(z.string(), z.unknown())
+            .describe('A result row — keys are the selected column names, values match the column DuckDB types (string, number, null).'))
+            .describe('Query result rows, capped at the canvas row limit (default 10,000).'),
+        row_count: z.number().describe('Total matching rows before the cap — may exceed rows.length.'),
+    }),
+    errors: [
+        {
+            reason: 'canvas_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'canvas_id does not match any registered DataCanvas table (expired, wrong session, or canvas disabled)',
+            recovery: 'Re-run imf_query_dataset to obtain a fresh canvas_id; ensure CANVAS_PROVIDER_TYPE=duckdb is set.',
+        },
+        {
+            reason: 'invalid_sql',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'sql does not start with SELECT — DML and DDL statements are not permitted',
+            recovery: 'Rewrite the statement as a SELECT query referencing tables from imf_dataframe_describe.',
+        },
+    ],
+    async handler(input, ctx) {
+        const canvas = getCanvas();
+        if (!canvas) {
+            throw ctx.fail('canvas_not_found', 'DataCanvas is not enabled. Set CANVAS_PROVIDER_TYPE=duckdb.', ctx.recoveryFor('canvas_not_found'));
+        }
+        // Validate SQL starts with SELECT
+        if (!/^\s*SELECT\s/i.test(input.sql)) {
+            throw ctx.fail('invalid_sql', 'SQL must be a SELECT statement. DML and DDL are not permitted.', ctx.recoveryFor('invalid_sql'));
+        }
+        let instance;
+        try {
+            instance = await canvas.acquire(input.canvas_id, ctx);
+        }
+        catch {
+            throw ctx.fail('canvas_not_found', `Canvas '${input.canvas_id}' not found or expired`, {
+                canvasId: input.canvas_id,
+                ...ctx.recoveryFor('canvas_not_found'),
+            });
+        }
+        const result = await instance.query(input.sql, { signal: ctx.signal });
+        ctx.log.info('Canvas query executed', {
+            canvasId: input.canvas_id,
+            rowCount: result.rowCount,
+        });
+        return { rows: result.rows, row_count: result.rowCount };
+    },
+    format: (result) => {
+        if (result.rows.length === 0) {
+            return [{ type: 'text', text: `**0 rows** (${result.row_count} total)` }];
+        }
+        const columns = Object.keys(result.rows[0]);
+        const lines = [
+            `**${result.row_count} row${result.row_count === 1 ? '' : 's'}**\n`,
+            `| ${columns.join(' | ')} |`,
+            `| ${columns.map(() => ':---').join(' | ')} |`,
+        ];
+        for (const row of result.rows) {
+            const cells = columns.map((col) => {
+                const v = row[col];
+                return v == null ? '—' : String(v);
+            });
+            lines.push(`| ${cells.join(' | ')} |`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=imf-dataframe-query.tool.js.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Tool: imf_get_database — fetch a dataflow's dimension list and codelists.
+ * @module mcp-server/tools/definitions/imf-get-database.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const imfGetDatabase: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dataflow_id: z.ZodString;
+    agency_id: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    dataflow_id: z.ZodString;
+    agency_id: z.ZodString;
+    version: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    key_format: z.ZodString;
+    dimensions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        position: z.ZodNumber;
+        codelist: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        codelist_truncated: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, 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: "structure_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "api.imf.org returns non-200 on the DSD endpoint";
+    readonly recovery: "Retry after a short wait; the IMF SDMX 3.0 portal is occasionally slow.";
+}], undefined>;
+//# sourceMappingURL=imf-get-database.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imf-get-database.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/imf-get-database.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8KzB,CAAC"}