@cyanheads/who-gho-mcp-server 0.1.1

package/dist/config/server-config.js

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Server-specific environment configuration for the WHO GHO 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://ghoapi.azureedge.net/api/')
+        .describe('GHO OData 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: 'GHO_BASE_URL',
+        requestTimeoutMs: 'GHO_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,mCAAmC,CAAC;SAC5C,QAAQ,CAAC,wBAAwB,CAAC;IACrC,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,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 who-gho-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 who-gho-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { whoDimensionValuesResource } from './mcp-server/resources/definitions/who-dimension-values.resource.js';
+import { whoIndicatorMetadataResource } from './mcp-server/resources/definitions/who-indicator-metadata.resource.js';
+import { whoGetIndicatorMetadata } from './mcp-server/tools/definitions/who-get-indicator-metadata.tool.js';
+import { whoListDimensionValues } from './mcp-server/tools/definitions/who-list-dimension-values.tool.js';
+import { whoListDimensions } from './mcp-server/tools/definitions/who-list-dimensions.tool.js';
+import { whoListIndicators } from './mcp-server/tools/definitions/who-list-indicators.tool.js';
+import { whoQueryIndicatorData } from './mcp-server/tools/definitions/who-query-indicator-data.tool.js';
+import { whoSearchIndicators } from './mcp-server/tools/definitions/who-search-indicators.tool.js';
+import { initGhoService } from './services/gho/gho-service.js';
+await createApp({
+    tools: [
+        whoListDimensions,
+        whoListDimensionValues,
+        whoSearchIndicators,
+        whoListIndicators,
+        whoGetIndicatorMetadata,
+        whoQueryIndicatorData,
+    ],
+    resources: [whoIndicatorMetadataResource, whoDimensionValuesResource],
+    prompts: [],
+    instructions: 'WHO Global Health Observatory MCP server. Primary workflow: ' +
+        '(1) who_search_indicators to find indicator codes by keyword, ' +
+        '(2) who_get_indicator_metadata to confirm valid filter dimensions, ' +
+        '(3) who_query_indicator_data to fetch data with country/region/year/sex filters. ' +
+        'Use who_list_dimensions → who_list_dimension_values to discover valid filter codes.',
+    setup(core) {
+        initGhoService(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,0BAA0B,EAAE,MAAM,qEAAqE,CAAC;AACjH,OAAO,EAAE,4BAA4B,EAAE,MAAM,uEAAuE,CAAC;AACrH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mEAAmE,CAAC;AAC5G,OAAO,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,iEAAiE,CAAC;AACxG,OAAO,EAAE,mBAAmB,EAAE,MAAM,8DAA8D,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,iBAAiB;QACjB,sBAAsB;QACtB,mBAAmB;QACnB,iBAAiB;QACjB,uBAAuB;QACvB,qBAAqB;KACtB;IACD,SAAS,EAAE,CAAC,4BAA4B,EAAE,0BAA0B,CAAC;IACrE,OAAO,EAAE,EAAE;IACX,YAAY,EACV,8DAA8D;QAC9D,gEAAgE;QAChE,qEAAqE;QACrE,mFAAmF;QACnF,qFAAqF;IACvF,KAAK,CAAC,IAAI;QACR,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/who-dimension-values.resource.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview WHO GHO dimension values resource — fetch valid values for a dimension type by URI.
+ * @module mcp-server/resources/definitions/who-dimension-values
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const whoDimensionValuesResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    dimensionCode: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    dimension: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        parentCode: z.ZodOptional<z.ZodString>;
+        parentLabel: z.ZodOptional<z.ZodString>;
+        parentDimension: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=who-dimension-values.resource.d.ts.map

package/dist/mcp-server/resources/definitions/who-dimension-values.resource.d.ts.map

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

package/dist/mcp-server/resources/definitions/who-dimension-values.resource.js

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview WHO GHO dimension values resource — fetch valid values for a dimension type by URI.
+ * @module mcp-server/resources/definitions/who-dimension-values
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getGhoService } from '../../../services/gho/gho-service.js';
+export const whoDimensionValuesResource = resource('who://dimension/{dimensionCode}/values', {
+    name: 'who-dimension-values',
+    description: 'All valid values for a WHO GHO dimension type. Stable and useful as injectable context ' +
+        'when building queries with who_query_indicator_data. ' +
+        'Use who_list_dimensions to discover valid dimension type codes.',
+    mimeType: 'application/json',
+    params: z.object({
+        dimensionCode: z
+            .string()
+            .describe('Dimension type code, e.g. "COUNTRY", "REGION", "SEX", "WORLDBANKINCOMEGROUP".'),
+    }),
+    output: z.object({
+        dimension: z.string().describe('The requested dimension type code.'),
+        values: z
+            .array(z
+            .object({
+            code: z.string().describe('Dimension value code.'),
+            label: z.string().describe('Human-readable label.'),
+            parentCode: z.string().optional().describe('Parent value code when hierarchical.'),
+            parentLabel: z.string().optional().describe('Human-readable parent label.'),
+            parentDimension: z.string().optional().describe('Parent dimension type.'),
+        })
+            .describe('A single valid value for this dimension type.'))
+            .describe('Valid values for the dimension.'),
+    }),
+    async handler(params, ctx) {
+        const values = await getGhoService().listDimensionValues(params.dimensionCode, ctx);
+        if (values.length === 0) {
+            throw notFound(`Dimension "${params.dimensionCode}" returned no values — it may not exist. Use who_list_dimensions to discover valid codes.`, { dimensionCode: params.dimensionCode });
+        }
+        return { dimension: params.dimensionCode, values };
+    },
+});
+//# sourceMappingURL=who-dimension-values.resource.js.map

package/dist/mcp-server/resources/definitions/who-dimension-values.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-dimension-values.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/who-dimension-values.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC,wCAAwC,EAAE;IAC3F,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,yFAAyF;QACzF,uDAAuD;QACvD,iEAAiE;IACnE,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,CAAC,+EAA+E,CAAC;KAC7F,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACpE,MAAM,EAAE,CAAC;aACN,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAClF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAC3E,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC1E,CAAC;aACD,QAAQ,CAAC,+CAA+C,CAAC,CAC7D;aACA,QAAQ,CAAC,iCAAiC,CAAC;KAC/C,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACpF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,QAAQ,CACZ,cAAc,MAAM,CAAC,aAAa,2FAA2F,EAC7H,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CACxC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/who-indicator-metadata.resource.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview WHO GHO indicator metadata resource — fetch metadata by indicator code URI.
+ * @module mcp-server/resources/definitions/who-indicator-metadata
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const whoIndicatorMetadataResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    indicatorCode: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    indicatorCode: z.ZodString;
+    indicatorName: z.ZodString;
+    dimensions: z.ZodArray<z.ZodObject<{
+        dimension: z.ZodString;
+        dimensionName: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=who-indicator-metadata.resource.d.ts.map

package/dist/mcp-server/resources/definitions/who-indicator-metadata.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-indicator-metadata.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/who-indicator-metadata.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,4BAA4B;;;;;;;;;6BA6CvC,CAAC"}

package/dist/mcp-server/resources/definitions/who-indicator-metadata.resource.js

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview WHO GHO indicator metadata resource — fetch metadata by indicator code URI.
+ * @module mcp-server/resources/definitions/who-indicator-metadata
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getGhoService } from '../../../services/gho/gho-service.js';
+export const whoIndicatorMetadataResource = resource('who://indicator/{indicatorCode}/metadata', {
+    name: 'who-indicator-metadata',
+    description: 'Metadata for a single WHO GHO indicator: full name and the dimension types it supports for filtering. ' +
+        'Stable and suitable as injectable context before calling who_query_indicator_data.',
+    mimeType: 'application/json',
+    params: z.object({
+        indicatorCode: z.string().describe('Indicator code, e.g. "WHOSIS_000001".'),
+    }),
+    output: z.object({
+        indicatorCode: z.string().describe('Indicator code.'),
+        indicatorName: z.string().describe('Full indicator name.'),
+        dimensions: z
+            .array(z
+            .object({
+            dimension: z.string().describe('Dimension type code, e.g. "COUNTRY", "SEX".'),
+            dimensionName: z.string().describe('Human-readable dimension name.'),
+        })
+            .describe('A dimension entry supported by this indicator.'))
+            .describe('Dimensions this indicator supports.'),
+    }),
+    async handler(params, ctx) {
+        const dimMap = await getGhoService().getIndicatorDimensions([params.indicatorCode], ctx);
+        const dims = dimMap.get(params.indicatorCode);
+        if (!dims) {
+            throw notFound(`Indicator "${params.indicatorCode}" has no metadata — it may not exist. Use who_search_indicators to find valid codes.`, { indicatorCode: params.indicatorCode });
+        }
+        // Look up name
+        const nameResult = await getGhoService().listIndicators({ query: params.indicatorCode, limit: 5, offset: 0 }, ctx);
+        const match = nameResult.indicators.find((i) => i.indicatorCode === params.indicatorCode);
+        return {
+            indicatorCode: params.indicatorCode,
+            indicatorName: match?.indicatorName ?? params.indicatorCode,
+            dimensions: dims,
+        };
+    },
+});
+//# sourceMappingURL=who-indicator-metadata.resource.js.map

package/dist/mcp-server/resources/definitions/who-indicator-metadata.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-indicator-metadata.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/who-indicator-metadata.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,CAAC,MAAM,4BAA4B,GAAG,QAAQ,CAAC,0CAA0C,EAAE;IAC/F,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,wGAAwG;QACxG,oFAAoF;IACtF,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KAC5E,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACrD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC1D,UAAU,EAAE,CAAC;aACV,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YAC7E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;SACrE,CAAC;aACD,QAAQ,CAAC,gDAAgD,CAAC,CAC9D;aACA,QAAQ,CAAC,qCAAqC,CAAC;KACnD,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC;QACzF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,CACZ,cAAc,MAAM,CAAC,aAAa,sFAAsF,EACxH,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CACxC,CAAC;QACJ,CAAC;QACD,eAAe;QACf,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC,cAAc,CACrD,EAAE,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EACpD,GAAG,CACJ,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC;QAC1F,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,aAAa,EAAE,KAAK,EAAE,aAAa,IAAI,MAAM,CAAC,aAAa;YAC3D,UAAU,EAAE,IAAI;SACjB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/who-get-indicator-metadata.tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Fetch dimension metadata for one or more WHO GHO indicator codes.
+ * @module mcp-server/tools/definitions/who-get-indicator-metadata
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const whoGetIndicatorMetadata: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    indicator_codes: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    indicators: z.ZodArray<z.ZodObject<{
+        indicatorCode: z.ZodString;
+        indicatorName: z.ZodString;
+        dimensions: z.ZodArray<z.ZodObject<{
+            dimension: z.ZodString;
+            dimensionName: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    notFound: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "all_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "All requested indicator codes returned empty metadata.";
+    readonly recovery: "Use who_search_indicators to find valid indicator codes matching your topic and retry.";
+}]>;
+//# sourceMappingURL=who-get-indicator-metadata.tool.d.ts.map

package/dist/mcp-server/tools/definitions/who-get-indicator-metadata.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-get-indicator-metadata.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/who-get-indicator-metadata.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,uBAAuB;;;;;;;;;;;;;;;;;GAoIlC,CAAC"}

package/dist/mcp-server/tools/definitions/who-get-indicator-metadata.tool.js

@@ -0,0 +1,112 @@
+/**
+ * @fileoverview Fetch dimension metadata for one or more WHO GHO indicator codes.
+ * @module mcp-server/tools/definitions/who-get-indicator-metadata
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getGhoService } from '../../../services/gho/gho-service.js';
+export const whoGetIndicatorMetadata = tool('who_get_indicator_metadata', {
+    title: 'Get WHO GHO Indicator Metadata',
+    description: 'Fetch metadata for one or more WHO GHO indicator codes: the full indicator name and the dimensions ' +
+        'it supports (e.g. COUNTRY, REGION, SEX, YEAR, WORLDBANKINCOMEGROUP, AGEGROUP). ' +
+        'Call this before querying data with who_query_indicator_data to confirm which filter dimensions ' +
+        'are valid for a given indicator. Accepts up to 10 codes per call. ' +
+        'Codes with no metadata are reported in the notFound array rather than causing an error.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        indicator_codes: z
+            .array(z.string().min(1))
+            .min(1)
+            .max(10)
+            .describe('One to ten indicator codes, e.g. ["WHOSIS_000001", "MDG_0000000026"].'),
+    }),
+    output: z.object({
+        indicators: z
+            .array(z
+            .object({
+            indicatorCode: z.string().describe('Indicator code.'),
+            indicatorName: z
+                .string()
+                .describe('Full indicator name as returned by the GHO catalog.'),
+            dimensions: z
+                .array(z
+                .object({
+                dimension: z
+                    .string()
+                    .describe('Dimension type code, e.g. "COUNTRY", "SEX", "WORLDBANKINCOMEGROUP".'),
+                dimensionName: z
+                    .string()
+                    .describe('Human-readable dimension name, e.g. "Country", "Sex".'),
+            })
+                .describe('A dimension entry supported by this indicator.'))
+                .describe('Dimensions this indicator supports for filtering in who_query_indicator_data.'),
+        })
+            .describe('Metadata for one indicator.'))
+            .describe('Metadata for each code that returned results.'),
+        notFound: z
+            .array(z.string())
+            .describe('Indicator codes that returned no metadata — they may not exist in the GHO catalog.'),
+    }),
+    errors: [
+        {
+            reason: 'all_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'All requested indicator codes returned empty metadata.',
+            recovery: 'Use who_search_indicators to find valid indicator codes matching your topic and retry.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching indicator metadata', { codes: input.indicator_codes });
+        // Fan out all lookups in parallel: dimension metadata + indicator names (one search per code)
+        const [dimMap, ...nameResults] = await Promise.all([
+            getGhoService().getIndicatorDimensions(input.indicator_codes, ctx),
+            ...input.indicator_codes.map((code) => getGhoService().listIndicators({ query: code, limit: 5, offset: 0 }, ctx)),
+        ]);
+        // Build name map from search results
+        const nameMap = new Map();
+        for (let i = 0; i < input.indicator_codes.length; i++) {
+            const code = input.indicator_codes[i];
+            const result = nameResults[i];
+            if (code && result && 'indicators' in result) {
+                const match = result.indicators.find((ind) => ind.indicatorCode === code);
+                if (match)
+                    nameMap.set(code, match.indicatorName);
+            }
+        }
+        const found = [];
+        const notFound = [];
+        for (const code of input.indicator_codes) {
+            const dims = dimMap.get(code);
+            if (!dims) {
+                notFound.push(code);
+            }
+            else {
+                found.push({
+                    indicatorCode: code,
+                    indicatorName: nameMap.get(code) ?? code,
+                    dimensions: dims,
+                });
+            }
+        }
+        if (found.length === 0) {
+            throw ctx.fail('all_not_found', `None of the requested indicator codes returned metadata.`, {
+                codes: input.indicator_codes,
+                ...ctx.recoveryFor('all_not_found'),
+            });
+        }
+        return { indicators: found, notFound };
+    },
+    format: (result) => {
+        const lines = [];
+        for (const ind of result.indicators) {
+            lines.push(`## ${ind.indicatorCode}: ${ind.indicatorName}`);
+            lines.push(`**Dimensions:** ${ind.dimensions.map((d) => `${d.dimension} (${d.dimensionName})`).join(', ')}`);
+            lines.push('');
+        }
+        if (result.notFound.length > 0) {
+            lines.push(`**Not found:** ${result.notFound.join(', ')}`);
+        }
+        return [{ type: 'text', text: lines.join('\n').trimEnd() }];
+    },
+});
+//# sourceMappingURL=who-get-indicator-metadata.tool.js.map

package/dist/mcp-server/tools/definitions/who-get-indicator-metadata.tool.js.map

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

package/dist/mcp-server/tools/definitions/who-list-dimension-values.tool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview List valid values for a WHO GHO dimension type.
+ * @module mcp-server/tools/definitions/who-list-dimension-values
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const whoListDimensionValues: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dimension: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    dimension: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        parentCode: z.ZodOptional<z.ZodString>;
+        parentLabel: z.ZodOptional<z.ZodString>;
+        parentDimension: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "dimension_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The dimension code returned no values — it may not exist in the GHO catalog.";
+    readonly recovery: "Use who_list_dimensions to discover valid dimension type codes and retry with a correct code.";
+}]>;
+//# sourceMappingURL=who-list-dimension-values.tool.d.ts.map

package/dist/mcp-server/tools/definitions/who-list-dimension-values.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-list-dimension-values.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/who-list-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;AAGjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;GAgFjC,CAAC"}

package/dist/mcp-server/tools/definitions/who-list-dimension-values.tool.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview List valid values for a WHO GHO dimension type.
+ * @module mcp-server/tools/definitions/who-list-dimension-values
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getGhoService } from '../../../services/gho/gho-service.js';
+export const whoListDimensionValues = tool('who_list_dimension_values', {
+    title: 'List GHO Dimension Values',
+    description: 'List valid codes and labels for a WHO GHO dimension type such as COUNTRY, REGION, SEX, ' +
+        'WORLDBANKINCOMEGROUP, or AGEGROUP. Use this to discover valid filter values before calling ' +
+        'who_query_indicator_data, or to confirm the correct ISO code for a country. ' +
+        'Use who_list_dimensions to discover all available dimension type codes.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        dimension: z
+            .string()
+            .min(1)
+            .describe('Dimension type code. Use who_list_dimensions to discover all available codes. ' +
+            'Common values: COUNTRY, REGION, SEX, WORLDBANKINCOMEGROUP, AGEGROUP.'),
+    }),
+    output: z.object({
+        dimension: z.string().describe('The requested dimension type code.'),
+        values: z
+            .array(z
+            .object({
+            code: z
+                .string()
+                .describe('Dimension value code used as a filter in who_query_indicator_data.'),
+            label: z.string().describe('Human-readable label for this value.'),
+            parentCode: z
+                .string()
+                .optional()
+                .describe('Parent value code, e.g. the WHO region code for a country entry.'),
+            parentLabel: z
+                .string()
+                .optional()
+                .describe('Human-readable label for the parent value.'),
+            parentDimension: z
+                .string()
+                .optional()
+                .describe('Parent dimension type, e.g. "REGION" for country entries.'),
+        })
+            .describe('A single valid value for this dimension type.'))
+            .describe('Valid values for this dimension type.'),
+    }),
+    errors: [
+        {
+            reason: 'dimension_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The dimension code returned no values — it may not exist in the GHO catalog.',
+            recovery: 'Use who_list_dimensions to discover valid dimension type codes and retry with a correct code.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching dimension values', { dimension: input.dimension });
+        const values = await getGhoService().listDimensionValues(input.dimension, ctx);
+        if (values.length === 0) {
+            throw ctx.fail('dimension_not_found', `Dimension "${input.dimension}" returned no values — it may not exist.`, {
+                ...ctx.recoveryFor('dimension_not_found'),
+            });
+        }
+        return { dimension: input.dimension, values };
+    },
+    format: (result) => {
+        const lines = [`**Dimension: ${result.dimension}** (${result.values.length} values)`, ''];
+        for (const v of result.values) {
+            const parentCode = v.parentCode ? ` parentCode=${v.parentCode}` : '';
+            const parentLabel = v.parentLabel ? ` parentLabel=${v.parentLabel}` : '';
+            const parentDimension = v.parentDimension ? ` parentDimension=${v.parentDimension}` : '';
+            lines.push(`- **${v.code}**: ${v.label}${parentCode}${parentLabel}${parentDimension}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=who-list-dimension-values.tool.js.map

package/dist/mcp-server/tools/definitions/who-list-dimension-values.tool.js.map

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

package/dist/mcp-server/tools/definitions/who-list-dimensions.tool.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview List all dimension type codes available in the WHO GHO API.
+ * @module mcp-server/tools/definitions/who-list-dimensions
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const whoListDimensions: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    dimensions: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=who-list-dimensions.tool.d.ts.map

package/dist/mcp-server/tools/definitions/who-list-dimensions.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-list-dimensions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/who-list-dimensions.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,iBAAiB;;;;;6BAmC5B,CAAC"}

package/dist/mcp-server/tools/definitions/who-list-dimensions.tool.js

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview List all dimension type codes available in the WHO GHO API.
+ * @module mcp-server/tools/definitions/who-list-dimensions
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getGhoService } from '../../../services/gho/gho-service.js';
+export const whoListDimensions = tool('who_list_dimensions', {
+    title: 'List GHO Dimension Types',
+    description: 'List all dimension type codes and human-readable titles available in the WHO Global Health Observatory API. ' +
+        'Use this to discover valid dimension codes before calling who_list_dimension_values. ' +
+        'Common dimensions include COUNTRY, REGION, SEX, WORLDBANKINCOMEGROUP, and AGEGROUP, ' +
+        'but many additional types exist — this endpoint exposes them all.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({}),
+    output: z.object({
+        dimensions: z
+            .array(z
+            .object({
+            code: z.string().describe('Dimension type code, e.g. "COUNTRY", "SEX", "AGEGROUP".'),
+            title: z.string().describe('Human-readable label for the dimension, e.g. "Age Group".'),
+        })
+            .describe('A single dimension type entry.'))
+            .describe('All available dimension types in the GHO catalog.'),
+    }),
+    async handler(_input, ctx) {
+        ctx.log.info('Fetching GHO dimension list');
+        const dimensions = await getGhoService().listDimensions(ctx);
+        return { dimensions };
+    },
+    format: (result) => {
+        const lines = [`**Dimension types (${result.dimensions.length} total):**`, ''];
+        for (const d of result.dimensions) {
+            lines.push(`- **${d.code}**: ${d.title}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=who-list-dimensions.tool.js.map

package/dist/mcp-server/tools/definitions/who-list-dimensions.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-list-dimensions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/who-list-dimensions.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,EAAE;IAC3D,KAAK,EAAE,0BAA0B;IACjC,WAAW,EACT,8GAA8G;QAC9G,uFAAuF;QACvF,sFAAsF;QACtF,mEAAmE;IACrE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC;aACV,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;SACxF,CAAC;aACD,QAAQ,CAAC,gCAAgC,CAAC,CAC9C;aACA,QAAQ,CAAC,mDAAmD,CAAC;KACjE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,UAAU,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,CAAC,sBAAsB,MAAM,CAAC,UAAU,CAAC,MAAM,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,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/who-list-indicators.tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Browse the WHO GHO indicator catalog with pagination.
+ * @module mcp-server/tools/definitions/who-list-indicators
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const whoListIndicators: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    indicators: z.ZodArray<z.ZodObject<{
+        indicatorCode: z.ZodString;
+        indicatorName: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=who-list-indicators.tool.d.ts.map

package/dist/mcp-server/tools/definitions/who-list-indicators.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-list-indicators.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/who-list-indicators.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,iBAAiB;;;;;;;;;;6BAkE5B,CAAC"}