@cyanheads/eurostat-mcp-server 0.1.1

package/dist/config/server-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Server-specific environment variable configuration for eurostat-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    baseUrl: z.ZodDefault<z.ZodString>;
+    requestTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare function getServerConfig(): z.infer<typeof ServerConfigSchema>;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;iBAYtB,CAAC;AAIH,wBAAgB,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAMpE"}

package/dist/config/server-config.js

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Server-specific environment variable configuration for eurostat-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()
+        .url()
+        .default('https://ec.europa.eu/eurostat/api/dissemination')
+        .describe('Eurostat API base URL'),
+    requestTimeoutMs: z.coerce
+        .number()
+        .int()
+        .positive()
+        .default(30_000)
+        .describe('HTTP request timeout in milliseconds'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        baseUrl: 'EUROSTAT_BASE_URL',
+        requestTimeoutMs: 'EUROSTAT_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,GAAG,EAAE;SACL,OAAO,CAAC,iDAAiD,CAAC;SAC1D,QAAQ,CAAC,uBAAuB,CAAC;IACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM;SACvB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC,CAAC;AAEH,IAAI,OAAuD,CAAC;AAE5D,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,6BAA6B;KAChD,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview eurostat-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,36 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview eurostat-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { eurostatDatasetResource } from './mcp-server/resources/definitions/eurostat-dataset.resource.js';
+import { eurostatBrowseThemes } from './mcp-server/tools/definitions/eurostat-browse-themes.tool.js';
+import { eurostatGetDatasetInfo } from './mcp-server/tools/definitions/eurostat-get-dataset-info.tool.js';
+import { eurostatGetDimensionValues } from './mcp-server/tools/definitions/eurostat-get-dimension-values.tool.js';
+import { eurostatQueryDataset } from './mcp-server/tools/definitions/eurostat-query-dataset.tool.js';
+import { eurostatSearchDatasets } from './mcp-server/tools/definitions/eurostat-search-datasets.tool.js';
+import { initEurostatCatalogueService } from './services/eurostat-catalogue/eurostat-catalogue-service.js';
+import { initEurostatDataService } from './services/eurostat-data/eurostat-data-service.js';
+await createApp({
+    tools: [
+        eurostatSearchDatasets,
+        eurostatBrowseThemes,
+        eurostatGetDatasetInfo,
+        eurostatGetDimensionValues,
+        eurostatQueryDataset,
+    ],
+    resources: [eurostatDatasetResource],
+    prompts: [],
+    instructions: 'Eurostat MCP server — EU statistical data across 8,933 datasets.\n' +
+        'Workflow: eurostat_search_datasets or eurostat_browse_themes to find a dataset code → ' +
+        'eurostat_get_dataset_info to see dimensions → ' +
+        'eurostat_get_dimension_values to list valid filter values → ' +
+        'eurostat_query_dataset to fetch observations.\n' +
+        'Apply dimension filters to avoid async response errors on large datasets.',
+    setup(core) {
+        initEurostatCatalogueService(core.config, core.storage);
+        initEurostatDataService(core.config, core.storage);
+    },
+});
+//# 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,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AAClH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AACzG,OAAO,EAAE,4BAA4B,EAAE,MAAM,6DAA6D,CAAC;AAC3G,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,sBAAsB;QACtB,oBAAoB;QACpB,sBAAsB;QACtB,0BAA0B;QAC1B,oBAAoB;KACrB;IACD,SAAS,EAAE,CAAC,uBAAuB,CAAC;IACpC,OAAO,EAAE,EAAE;IACX,YAAY,EACV,oEAAoE;QACpE,wFAAwF;QACxF,gDAAgD;QAChD,8DAA8D;QAC9D,iDAAiD;QACjD,2EAA2E;IAC7E,KAAK,CAAC,IAAI;QACR,4BAA4B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/eurostat-dataset.resource.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Resource for fetching Eurostat dataset metadata by URI.
+ * @module mcp-server/resources/definitions/eurostat-dataset.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const eurostatDatasetResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    dataset_code: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    dimensions: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        valuesCount: z.ZodNumber;
+        sampleValues: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    timeRange: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>;
+    obsCount: z.ZodNumber;
+    lastUpdated: z.ZodString;
+    metadataUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=eurostat-dataset.resource.d.ts.map

package/dist/mcp-server/resources/definitions/eurostat-dataset.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-dataset.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/eurostat-dataset.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;6BA+ClC,CAAC"}

package/dist/mcp-server/resources/definitions/eurostat-dataset.resource.js

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Resource for fetching Eurostat dataset metadata by URI.
+ * @module mcp-server/resources/definitions/eurostat-dataset.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getEurostatDataService } from '../../../services/eurostat-data/eurostat-data-service.js';
+export const eurostatDatasetResource = resource('eurostat://dataset/{dataset_code}', {
+    name: 'eurostat-dataset-info',
+    description: 'Dataset metadata for a Eurostat dataset — dimensions, time range, observation count, and last-updated date. Equivalent to eurostat_get_dataset_info but accessible as a resource URI for cache-injectable context.',
+    mimeType: 'application/json',
+    params: z.object({
+        dataset_code: z.string().describe('Dataset code (e.g., "nama_10_gdp").'),
+    }),
+    output: z.object({
+        code: z.string().describe('Dataset code.'),
+        label: z.string().describe('Human-readable dataset title.'),
+        dimensions: z
+            .array(z
+            .object({
+            code: z.string().describe('Dimension code.'),
+            label: z.string().describe('Dimension name.'),
+            valuesCount: z.number().describe('Number of distinct values.'),
+            sampleValues: z
+                .array(z
+                .object({
+                code: z.string().describe('Value code.'),
+                label: z.string().describe('Value label.'),
+            })
+                .describe('A dimension value code and label pair.'))
+                .describe('First 10 values for orientation.'),
+        })
+            .describe('A dataset dimension with its valid values.'))
+            .describe('Dataset dimensions.'),
+        timeRange: z
+            .object({
+            start: z.string().describe('Earliest available period.'),
+            end: z.string().describe('Most recent available period.'),
+        })
+            .describe('Overall data coverage period.'),
+        obsCount: z.number().describe('Total number of observations.'),
+        lastUpdated: z.string().describe('ISO 8601 timestamp of last data update.'),
+        metadataUrl: z.string().optional().describe('Link to ESMS metadata page, when available.'),
+    }),
+    async handler(params, ctx) {
+        const svc = getEurostatDataService();
+        return svc.getDatasetInfo(params.dataset_code, ctx);
+    },
+});
+//# sourceMappingURL=eurostat-dataset.resource.js.map

package/dist/mcp-server/resources/definitions/eurostat-dataset.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-dataset.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/eurostat-dataset.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAE3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC,mCAAmC,EAAE;IACnF,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,oNAAoN;IACtN,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACzE,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC3D,UAAU,EAAE,CAAC;aACV,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC9D,YAAY,EAAE,CAAC;iBACZ,KAAK,CACJ,CAAC;iBACE,MAAM,CAAC;gBACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;aAC3C,CAAC;iBACD,QAAQ,CAAC,wCAAwC,CAAC,CACtD;iBACA,QAAQ,CAAC,kCAAkC,CAAC;SAChD,CAAC;aACD,QAAQ,CAAC,4CAA4C,CAAC,CAC1D;aACA,QAAQ,CAAC,qBAAqB,CAAC;QAClC,SAAS,EAAE,CAAC;aACT,MAAM,CAAC;YACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACxD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;SAC1D,CAAC;aACD,QAAQ,CAAC,+BAA+B,CAAC;QAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KAC3F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAC;QACrC,OAAO,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/eurostat-browse-themes.tool.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Tool for browsing the Eurostat theme hierarchy.
+ * @module mcp-server/tools/definitions/eurostat-browse-themes.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurostatBrowseThemes: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    theme_code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            dataset: "dataset";
+            table: "table";
+            folder: "folder";
+        }>;
+        hasChildren: z.ZodBoolean;
+        dataStart: z.ZodOptional<z.ZodString>;
+        dataEnd: z.ZodOptional<z.ZodString>;
+        obsCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    parentPath: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The provided theme_code does not exist as a folder in the TOC.";
+    readonly recovery: "Call eurostat_browse_themes without theme_code to see valid root themes, then navigate from there.";
+}]>;
+//# sourceMappingURL=eurostat-browse-themes.tool.d.ts.map

package/dist/mcp-server/tools/definitions/eurostat-browse-themes.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-browse-themes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-browse-themes.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;;;;;;;;;;;;;;;;;;;;;;GAqG/B,CAAC"}

package/dist/mcp-server/tools/definitions/eurostat-browse-themes.tool.js

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Tool for browsing the Eurostat theme hierarchy.
+ * @module mcp-server/tools/definitions/eurostat-browse-themes.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEurostatCatalogueService } from '../../../services/eurostat-catalogue/eurostat-catalogue-service.js';
+export const eurostatBrowseThemes = tool('eurostat_browse_themes', {
+    title: 'Browse Eurostat Theme Hierarchy',
+    description: 'Navigate the Eurostat theme tree. Without theme_code returns the 11 top-level theme folders (Economy, Population, Transport, etc.) — the practical starting points. With a theme_code returns its immediate children: subtheme folders and datasets in that branch. Use this for structured discovery when you know the domain but not the dataset code, or to drill down from a broad topic to a specific dataset. Pair with eurostat_search_datasets for keyword-based discovery.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        theme_code: z
+            .string()
+            .optional()
+            .describe('Folder code to expand (e.g., "econ", "reg"). Omit to list the 11 top-level theme folders.'),
+    }),
+    output: z.object({
+        items: z
+            .array(z
+            .object({
+            code: z
+                .string()
+                .describe('Theme or dataset code. Pass to theme_code to drill into a folder, or use as dataset_code for data tools.'),
+            label: z.string().describe('Human-readable name.'),
+            type: z
+                .enum(['folder', 'dataset', 'table'])
+                .describe('Item type: "folder" has sub-items; "dataset"/"table" can be queried for data.'),
+            hasChildren: z
+                .boolean()
+                .describe('True when this folder contains sub-items. Only meaningful for type "folder".'),
+            dataStart: z
+                .string()
+                .optional()
+                .describe('Earliest data period (e.g., "1995"). Omitted for folders and when not reported.'),
+            dataEnd: z
+                .string()
+                .optional()
+                .describe('Most recent data period. Omitted for folders and when not reported.'),
+            obsCount: z
+                .number()
+                .optional()
+                .describe('Approximate observation count. Omitted for folders and when not reported.'),
+        })
+            .describe('A theme folder, dataset, or table entry.'))
+            .describe('Immediate children of the requested theme, or the 11 root themes if theme_code was omitted.'),
+        parentPath: z
+            .array(z.string())
+            .describe('Breadcrumb from root to the requested theme (e.g., ["Economy and finance", "National accounts"]). Empty when browsing root.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The provided theme_code does not exist as a folder in the TOC.',
+            recovery: 'Call eurostat_browse_themes without theme_code to see valid root themes, then navigate from there.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getEurostatCatalogueService();
+        const themeCode = input.theme_code && input.theme_code.trim() ? input.theme_code.trim() : undefined;
+        const { items, parentPath } = await svc.browse(themeCode, ctx);
+        ctx.log.info('Theme browse complete', { themeCode, itemCount: items.length });
+        return { items, parentPath };
+    },
+    format: (result) => {
+        const lines = [];
+        if (result.parentPath.length > 0) {
+            lines.push(`**Path:** ${result.parentPath.join(' › ')}\n`);
+        }
+        lines.push(`**${result.items.length} item${result.items.length !== 1 ? 's' : ''}**\n`);
+        for (const item of result.items) {
+            const icon = item.type === 'folder' ? '📁' : '📊';
+            lines.push(`${icon} **${item.label}**`);
+            lines.push(`  **Code:** ${item.code} | **Type:** ${item.type}${item.hasChildren ? ' (has children)' : ''}`);
+            if (item.dataStart || item.dataEnd) {
+                lines.push(`  **Period:** ${item.dataStart ?? '?'} – ${item.dataEnd ?? '?'}`);
+            }
+            if (item.obsCount != null)
+                lines.push(`  **Observations:** ${item.obsCount.toLocaleString()}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurostat-browse-themes.tool.js.map

package/dist/mcp-server/tools/definitions/eurostat-browse-themes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-browse-themes.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-browse-themes.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAE1G,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,wBAAwB,EAAE;IACjE,KAAK,EAAE,iCAAiC;IACxC,WAAW,EACT,qdAAqd;IACvd,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,2FAA2F,CAC5F;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,0GAA0G,CAC3G;YACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YAClD,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;iBACpC,QAAQ,CACP,+EAA+E,CAChF;YACH,WAAW,EAAE,CAAC;iBACX,OAAO,EAAE;iBACT,QAAQ,CACP,8EAA8E,CAC/E;YACH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,iFAAiF,CAClF;YACH,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qEAAqE,CAAC;YAClF,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,2EAA2E,CAC5E;SACJ,CAAC;aACD,QAAQ,CAAC,0CAA0C,CAAC,CACxD;aACA,QAAQ,CACP,6FAA6F,CAC9F;QACH,UAAU,EAAE,CAAC;aACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,6HAA6H,CAC9H;KACJ,CAAC;IACF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,gEAAgE;YACtE,QAAQ,EACN,oGAAoG;SACvG;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,2BAA2B,EAAE,CAAC;QAC1C,MAAM,SAAS,GACb,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACvF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CACR,eAAe,IAAI,CAAC,IAAI,gBAAgB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,CAChG,CAAC;YACF,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YAChF,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI;gBACvB,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/eurostat-get-dataset-info.tool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Tool for fetching metadata about a specific Eurostat dataset.
+ * @module mcp-server/tools/definitions/eurostat-get-dataset-info.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurostatGetDatasetInfo: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dataset_code: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    dimensions: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        valuesCount: z.ZodNumber;
+        sampleValues: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    timeRange: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>;
+    obsCount: z.ZodNumber;
+    lastUpdated: z.ZodString;
+    metadataUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The dataset code does not exist or is not available for dissemination.";
+    readonly recovery: "Use eurostat_search_datasets or eurostat_browse_themes to find a valid dataset code.";
+}, {
+    readonly reason: "async_response";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Eurostat returned an async response (query too large for the API).";
+    readonly retryable: true;
+    readonly recovery: "This is unexpected for a metadata call; retry in a few seconds. If it persists, the dataset may be unusually large.";
+}]>;
+//# sourceMappingURL=eurostat-get-dataset-info.tool.d.ts.map

package/dist/mcp-server/tools/definitions/eurostat-get-dataset-info.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-get-dataset-info.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-get-dataset-info.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,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqHjC,CAAC"}

package/dist/mcp-server/tools/definitions/eurostat-get-dataset-info.tool.js

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview Tool for fetching metadata about a specific Eurostat dataset.
+ * @module mcp-server/tools/definitions/eurostat-get-dataset-info.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEurostatDataService } from '../../../services/eurostat-data/eurostat-data-service.js';
+export const eurostatGetDatasetInfo = tool('eurostat_get_dataset_info', {
+    title: 'Get Eurostat Dataset Info',
+    description: 'Fetch metadata for a Eurostat dataset: dimensions with valid values, time range, observation count, and last-update date. Call this before eurostat_query_dataset to discover what dimension codes are valid (unit, na_item, geo, etc.). Uses a minimal Statistics API call (most recent period only) to extract dimension structure. Returns up to 10 sample values per dimension for orientation; use eurostat_get_dimension_values to list the full set for large dimensions.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        dataset_code: z
+            .string()
+            .min(1)
+            .describe('Dataset code (e.g., "nama_10_gdp"). Use eurostat_search_datasets or eurostat_browse_themes to find codes.'),
+    }),
+    output: z.object({
+        code: z.string().describe('Dataset code as provided.'),
+        label: z.string().describe('Human-readable dataset title.'),
+        dimensions: z
+            .array(z
+            .object({
+            code: z
+                .string()
+                .describe('Dimension code (e.g., "unit", "geo", "na_item"). Use these as filter keys in eurostat_query_dataset.'),
+            label: z.string().describe('Human-readable dimension name (e.g., "Unit of measure").'),
+            valuesCount: z
+                .number()
+                .describe('Number of distinct values in this dimension for the most recent period.'),
+            sampleValues: z
+                .array(z
+                .object({
+                code: z.string().describe('Dimension value code.'),
+                label: z.string().describe('Human-readable label for this value.'),
+            })
+                .describe('A dimension value code and label pair.'))
+                .describe('First 10 dimension values for orientation. Use eurostat_get_dimension_values for the full list.'),
+        })
+            .describe('A dataset dimension with its valid values.'))
+            .describe('All dimensions of the dataset with their valid codes and labels.'),
+        timeRange: z
+            .object({
+            start: z.string().describe('Earliest available period (e.g., "1975").'),
+            end: z.string().describe('Most recent available period (e.g., "2024").'),
+        })
+            .describe('Overall data coverage period for this dataset.'),
+        obsCount: z
+            .number()
+            .describe('Total number of observations in the full dataset (all periods).'),
+        lastUpdated: z.string().describe('ISO 8601 timestamp of the most recent data update.'),
+        metadataUrl: z
+            .string()
+            .optional()
+            .describe('URL to the ESMS HTML metadata page for this dataset. Omitted when not provided by Eurostat.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The dataset code does not exist or is not available for dissemination.',
+            recovery: 'Use eurostat_search_datasets or eurostat_browse_themes to find a valid dataset code.',
+        },
+        {
+            reason: 'async_response',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Eurostat returned an async response (query too large for the API).',
+            retryable: true,
+            recovery: 'This is unexpected for a metadata call; retry in a few seconds. If it persists, the dataset may be unusually large.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getEurostatDataService();
+        const meta = await svc.getDatasetInfo(input.dataset_code, ctx);
+        ctx.log.info('Dataset info fetched', {
+            datasetCode: input.dataset_code,
+            dimensionCount: meta.dimensions.length,
+            obsCount: meta.obsCount,
+        });
+        return meta;
+    },
+    format: (result) => {
+        const lines = [
+            `# ${result.label}`,
+            `**Code:** ${result.code}`,
+            `**Period:** ${result.timeRange.start} – ${result.timeRange.end}`,
+            `**Observations:** ${result.obsCount.toLocaleString()}`,
+            `**Last updated:** ${result.lastUpdated}`,
+        ];
+        if (result.metadataUrl)
+            lines.push(`**Metadata:** ${result.metadataUrl}`);
+        lines.push(`\n## Dimensions (${result.dimensions.length})`);
+        for (const dim of result.dimensions) {
+            lines.push(`\n### ${dim.label} (\`${dim.code}\`) — ${dim.valuesCount} value${dim.valuesCount !== 1 ? 's' : ''}`);
+            if (dim.sampleValues.length > 0) {
+                const samples = dim.sampleValues.map((v) => `\`${v.code}\` ${v.label}`).join(', ');
+                lines.push(`Sample: ${samples}`);
+                if (dim.valuesCount > dim.sampleValues.length) {
+                    lines.push(`_(${dim.valuesCount - dim.sampleValues.length} more — use eurostat_get_dimension_values for the full list)_`);
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurostat-get-dataset-info.tool.js.map

package/dist/mcp-server/tools/definitions/eurostat-get-dataset-info.tool.js.map

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

package/dist/mcp-server/tools/definitions/eurostat-get-dimension-values.tool.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Tool for listing all valid values for a specific Eurostat dataset dimension.
+ * @module mcp-server/tools/definitions/eurostat-get-dimension-values.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurostatGetDimensionValues: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dataset_code: z.ZodString;
+    dimension: z.ZodString;
+    geo_level: z.ZodOptional<z.ZodEnum<{
+        aggregate: "aggregate";
+        country: "country";
+        nuts1: "nuts1";
+        nuts2: "nuts2";
+        nuts3: "nuts3";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    dimensionCode: z.ZodString;
+    dimensionLabel: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The dataset code or dimension code does not exist.";
+    readonly recovery: "Verify the dataset code with eurostat_search_datasets and the dimension code with eurostat_get_dataset_info.";
+}]>;
+//# sourceMappingURL=eurostat-get-dimension-values.tool.d.ts.map

package/dist/mcp-server/tools/definitions/eurostat-get-dimension-values.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/eurostat-get-dimension-values.tool.js

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Tool for listing all valid values for a specific Eurostat dataset dimension.
+ * @module mcp-server/tools/definitions/eurostat-get-dimension-values.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEurostatDataService } from '../../../services/eurostat-data/eurostat-data-service.js';
+import { GEO_LEVEL_VALUES } from '../../../services/eurostat-data/types.js';
+export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values', {
+    title: 'Get Eurostat Dimension Values',
+    description: 'List all valid values for a specific dimension in a Eurostat dataset (e.g., all unit codes for nama_10_gdp, all geo codes for a regional dataset). Use this when eurostat_get_dataset_info returns more values than the 10-item sample, or to confirm exact codes before querying. For the "geo" dimension, use geo_level to filter by NUTS hierarchy (country, nuts1, nuts2, nuts3) — country is the default. Invalid dimension_value codes passed to eurostat_query_dataset silently return no data; use this tool to verify codes first.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        dataset_code: z.string().min(1).describe('Dataset code (e.g., "nama_10_gdp").'),
+        dimension: z
+            .string()
+            .min(1)
+            .describe('Dimension code to retrieve values for (e.g., "unit", "na_item", "geo"). Use eurostat_get_dataset_info to see available dimensions.'),
+        geo_level: z
+            .enum(GEO_LEVEL_VALUES)
+            .optional()
+            .describe('NUTS hierarchy level filter — only relevant when dimension is "geo". Options: "aggregate" (EU/EA codes), "country" (2-letter codes, default), "nuts1" (3-char), "nuts2" (4-char), "nuts3" (5-char).'),
+    }),
+    output: z.object({
+        dimensionCode: z.string().describe('The dimension code that was queried.'),
+        dimensionLabel: z.string().describe('Human-readable dimension name.'),
+        values: z
+            .array(z
+            .object({
+            code: z
+                .string()
+                .describe('Dimension value code. Use these as filter values in eurostat_query_dataset.'),
+            label: z.string().describe('Human-readable label for this value.'),
+        })
+            .describe('A dimension value code and label pair.'))
+            .describe('All valid values for this dimension in the dataset.'),
+        totalCount: z.number().describe('Total number of distinct values returned.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The dataset code or dimension code does not exist.',
+            recovery: 'Verify the dataset code with eurostat_search_datasets and the dimension code with eurostat_get_dataset_info.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getEurostatDataService();
+        const result = await svc.getDimensionValues(input.dataset_code, input.dimension, input.geo_level, ctx);
+        ctx.log.info('Dimension values fetched', {
+            datasetCode: input.dataset_code,
+            dimension: input.dimension,
+            totalCount: result.totalCount,
+        });
+        return result;
+    },
+    format: (result) => {
+        const lines = [
+            `**Dimension:** ${result.dimensionLabel} (\`${result.dimensionCode}\`)`,
+            `**Total values:** ${result.totalCount}\n`,
+        ];
+        for (const v of result.values) {
+            lines.push(`- \`${v.code}\` — ${v.label}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurostat-get-dimension-values.tool.js.map

package/dist/mcp-server/tools/definitions/eurostat-get-dimension-values.tool.js.map

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