@cyanheads/who-gho-mcp-server 0.1.1

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

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Browse the WHO GHO indicator catalog with pagination.
+ * @module mcp-server/tools/definitions/who-list-indicators
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getGhoService } from '../../../services/gho/gho-service.js';
+export const whoListIndicators = tool('who_list_indicators', {
+    title: 'List WHO GHO Indicators',
+    description: 'Browse the WHO Global Health Observatory indicator catalog with pagination. ' +
+        'Use when you want to explore indicators without a keyword, or to page through the full catalog. ' +
+        'Use who_search_indicators when you have a keyword to narrow the results.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(500)
+            .default(50)
+            .describe('Number of indicators to return per page. Default 50, max 500.'),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .default(0)
+            .describe('Zero-based offset for pagination. Default 0.'),
+    }),
+    output: z.object({
+        indicators: z
+            .array(z
+            .object({
+            indicatorCode: z
+                .string()
+                .describe('Unique indicator code used in who_query_indicator_data, e.g. "WHOSIS_000001".'),
+            indicatorName: z
+                .string()
+                .describe('Full indicator name, e.g. "Life expectancy at birth (years)".'),
+        })
+            .describe('An indicator entry with its code and name.'))
+            .describe('Indicators for the requested page.'),
+        total: z.number().describe('Total number of indicators in the GHO catalog.'),
+        hasMore: z.boolean().describe('True when more indicators exist beyond the current page.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('Listing indicators', { limit: input.limit, offset: input.offset });
+        const { indicators, total } = await getGhoService().listIndicators({ limit: input.limit, offset: input.offset }, ctx);
+        return {
+            indicators,
+            total,
+            hasMore: input.offset + indicators.length < total,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Indicators (${result.indicators.length} shown, ${result.total} total, hasMore: ${result.hasMore}):**`,
+            '',
+        ];
+        for (const ind of result.indicators) {
+            lines.push(`- **${ind.indicatorCode}**: ${ind.indicatorName}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=who-list-indicators.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"who-list-indicators.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/who-list-indicators.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,yBAAyB;IAChC,WAAW,EACT,8EAA8E;QAC9E,kGAAkG;QAClG,0EAA0E;IAC5E,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,+DAA+D,CAAC;QAC5E,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC;aACV,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,CACP,+EAA+E,CAChF;YACH,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,CAAC,+DAA+D,CAAC;SAC7E,CAAC;aACD,QAAQ,CAAC,4CAA4C,CAAC,CAC1D;aACA,QAAQ,CAAC,oCAAoC,CAAC;QACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAC5E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC,cAAc,CAChE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAC5C,GAAG,CACJ,CAAC;QACF,OAAO;YACL,UAAU;YACV,KAAK;YACL,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,KAAK;SAClD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG;YACZ,iBAAiB,MAAM,CAAC,UAAU,CAAC,MAAM,WAAW,MAAM,CAAC,KAAK,oBAAoB,MAAM,CAAC,OAAO,MAAM;YACxG,EAAE;SACH,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,aAAa,OAAO,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;QACjE,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-query-indicator-data.tool.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Query data rows for a WHO GHO indicator with spatial, temporal, and dimension filters.
+ * @module mcp-server/tools/definitions/who-query-indicator-data
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const whoQueryIndicatorData: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    indicator_code: z.ZodString;
+    country_codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    region_codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    income_group_codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    year_from: z.ZodOptional<z.ZodNumber>;
+    year_to: z.ZodOptional<z.ZodNumber>;
+    sex: z.ZodOptional<z.ZodEnum<{
+        SEX_BTSX: "SEX_BTSX";
+        SEX_FMLE: "SEX_FMLE";
+        SEX_MLE: "SEX_MLE";
+    }>>;
+    dim1_value: z.ZodOptional<z.ZodString>;
+    include_uncertainty: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    rows: z.ZodArray<z.ZodObject<{
+        indicatorCode: z.ZodString;
+        spatialDimType: z.ZodOptional<z.ZodString>;
+        spatialDim: z.ZodOptional<z.ZodString>;
+        spatialLabel: z.ZodOptional<z.ZodString>;
+        year: z.ZodNumber;
+        dim1Type: z.ZodOptional<z.ZodString>;
+        dim1: z.ZodOptional<z.ZodString>;
+        dim2Type: z.ZodOptional<z.ZodString>;
+        dim2: z.ZodOptional<z.ZodString>;
+        numericValue: z.ZodOptional<z.ZodNumber>;
+        low: z.ZodOptional<z.ZodNumber>;
+        high: z.ZodOptional<z.ZodNumber>;
+        displayValue: z.ZodOptional<z.ZodString>;
+        comments: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalRows: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    truncatedNote: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "indicator_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The indicator code returned HTTP 404 from the GHO API.";
+    readonly recovery: "Use who_search_indicators to find the correct indicator code and retry.";
+}, {
+    readonly reason: "no_data";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The indicator exists but no data rows matched the applied filters.";
+    readonly recovery: string;
+}, {
+    readonly reason: "ambiguous_spatial_filter";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "More than one of country_codes, region_codes, or income_group_codes were provided.";
+    readonly recovery: "Provide only one spatial filter type per call. To compare countries and regions, make separate calls.";
+}]>;
+//# sourceMappingURL=who-query-indicator-data.tool.d.ts.map

package/dist/mcp-server/tools/definitions/who-query-indicator-data.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/who-query-indicator-data.tool.js

@@ -0,0 +1,215 @@
+/**
+ * @fileoverview Query data rows for a WHO GHO indicator with spatial, temporal, and dimension filters.
+ * @module mcp-server/tools/definitions/who-query-indicator-data
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getGhoService } from '../../../services/gho/gho-service.js';
+const SEX_VALUES = ['SEX_BTSX', 'SEX_FMLE', 'SEX_MLE'];
+export const whoQueryIndicatorData = tool('who_query_indicator_data', {
+    title: 'Query WHO GHO Indicator Data',
+    description: 'Query data rows for a single WHO GHO indicator with optional spatial, temporal, and dimension filters. ' +
+        'Returns rows with numeric values, uncertainty intervals (Low/High), and spatial/time metadata. ' +
+        'This is the primary data-fetching tool in the find-then-query workflow: ' +
+        'use who_search_indicators to find the indicator code, optionally call who_get_indicator_metadata ' +
+        'to confirm which filter dimensions are valid, then call this tool. ' +
+        'Spatial filters are mutually exclusive per call: provide only one of country_codes, region_codes, ' +
+        'or income_group_codes — mixing them triggers an error. ' +
+        'Omitting all spatial filters returns all geographies (may be large; use limit to cap). ' +
+        'The sex filter applies as Dim1Type=SEX — if the indicator does not use SEX as Dim1, the filter ' +
+        'returns empty rows; check who_get_indicator_metadata first if uncertain.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        indicator_code: z
+            .string()
+            .min(1)
+            .describe('Indicator code to query, e.g. "WHOSIS_000001". Use who_search_indicators to find codes.'),
+        country_codes: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('ISO 3166-1 alpha-3 country codes to filter on, e.g. ["JPN","USA","BRA"]. ' +
+            'Mutually exclusive with region_codes and income_group_codes.'),
+        region_codes: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('WHO region codes to filter on, e.g. ["AFR","EUR","AMR","EMR","SEAR","WPR"]. ' +
+            'Use who_list_dimension_values with dimension="REGION" to see all valid codes. ' +
+            'Mutually exclusive with country_codes and income_group_codes.'),
+        income_group_codes: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('World Bank income group codes, e.g. ["WB_HI","WB_LMI","WB_LI","WB_UMI"]. ' +
+            'Use who_list_dimension_values with dimension="WORLDBANKINCOMEGROUP" to see all valid codes. ' +
+            'Mutually exclusive with country_codes and region_codes.'),
+        year_from: z
+            .number()
+            .int()
+            .optional()
+            .describe('Start year (inclusive) for the time range filter, e.g. 2015.'),
+        year_to: z
+            .number()
+            .int()
+            .optional()
+            .describe('End year (inclusive) for the time range filter, e.g. 2023.'),
+        sex: z
+            .enum(SEX_VALUES)
+            .optional()
+            .describe('Filter on sex dimension: SEX_BTSX (both sexes), SEX_FMLE (female), SEX_MLE (male). ' +
+            'Only applies when the indicator uses SEX as its first cross-cutting dimension.'),
+        dim1_value: z
+            .string()
+            .optional()
+            .describe('Arbitrary Dim1 value filter for indicators whose first cross-cutting dimension is not SEX ' +
+            '(e.g. an AGEGROUP code). Ignored when sex is also provided.'),
+        include_uncertainty: z
+            .boolean()
+            .default(true)
+            .describe('Include Low and High uncertainty interval bounds in output. Default true.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(200)
+            .describe('Maximum number of data rows to return. Default 200, max 1000.'),
+    }),
+    output: z.object({
+        rows: z
+            .array(z
+            .object({
+            indicatorCode: z.string().describe('Indicator code for this row.'),
+            spatialDimType: z
+                .string()
+                .optional()
+                .describe('Spatial dimension type: COUNTRY, REGION, WORLDBANKINCOMEGROUP, GLOBAL, etc.'),
+            spatialDim: z
+                .string()
+                .optional()
+                .describe('Spatial dimension value, e.g. "JPN", "AFR", "WB_HI".'),
+            spatialLabel: z
+                .string()
+                .optional()
+                .describe('Human-readable spatial label, e.g. WHO region name for a country row.'),
+            year: z.number().describe('Year of the data point.'),
+            dim1Type: z
+                .string()
+                .optional()
+                .describe('First cross-cutting dimension type, e.g. "SEX".'),
+            dim1: z
+                .string()
+                .optional()
+                .describe('First cross-cutting dimension value, e.g. "SEX_BTSX".'),
+            dim2Type: z
+                .string()
+                .optional()
+                .describe('Second cross-cutting dimension type, e.g. "AGEGROUP".'),
+            dim2: z.string().optional().describe('Second cross-cutting dimension value.'),
+            numericValue: z.number().optional().describe('Machine-readable numeric value.'),
+            low: z
+                .number()
+                .optional()
+                .describe('Lower bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.'),
+            high: z
+                .number()
+                .optional()
+                .describe('Upper bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.'),
+            displayValue: z
+                .string()
+                .optional()
+                .describe('Formatted display string as provided by WHO, e.g. "84.5 [84.5-84.5]".'),
+            comments: z
+                .string()
+                .optional()
+                .describe('Data source notes or comments attached to this row.'),
+        })
+            .describe('A single data row from the GHO indicator dataset.'))
+            .describe('Data rows matching the query.'),
+        totalRows: z
+            .number()
+            .describe('Total row count matching the query on the server (before the limit is applied).'),
+        truncated: z
+            .boolean()
+            .describe('True when totalRows exceeds the limit and not all rows were returned.'),
+        truncatedNote: z
+            .string()
+            .optional()
+            .describe('Present when truncated is true. Explains how to retrieve additional rows, e.g. by narrowing filters or increasing the limit.'),
+    }),
+    errors: [
+        {
+            reason: 'indicator_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The indicator code returned HTTP 404 from the GHO API.',
+            recovery: 'Use who_search_indicators to find the correct indicator code and retry.',
+        },
+        {
+            reason: 'no_data',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The indicator exists but no data rows matched the applied filters.',
+            recovery: 'Broaden the filters: remove year range, try different spatial codes, or remove the sex filter. ' +
+                'Use who_get_indicator_metadata to confirm which dimensions this indicator supports.',
+        },
+        {
+            reason: 'ambiguous_spatial_filter',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'More than one of country_codes, region_codes, or income_group_codes were provided.',
+            recovery: 'Provide only one spatial filter type per call. To compare countries and regions, make separate calls.',
+        },
+    ],
+    async handler(input, ctx) {
+        // Validate mutual exclusion of spatial filters
+        const spatialCount = [input.country_codes, input.region_codes, input.income_group_codes].filter((arr) => arr?.length).length;
+        if (spatialCount > 1) {
+            throw ctx.fail('ambiguous_spatial_filter', 'Provide only one of country_codes, region_codes, or income_group_codes per call.', { ...ctx.recoveryFor('ambiguous_spatial_filter') });
+        }
+        ctx.log.info('Querying indicator data', {
+            indicatorCode: input.indicator_code,
+            spatialCount,
+            yearFrom: input.year_from,
+            yearTo: input.year_to,
+        });
+        const queryParams = {
+            indicatorCode: input.indicator_code,
+            includeUncertainty: input.include_uncertainty,
+            limit: input.limit,
+            ...(input.country_codes?.length && { countryCodes: input.country_codes }),
+            ...(input.region_codes?.length && { regionCodes: input.region_codes }),
+            ...(input.income_group_codes?.length && { incomeGroupCodes: input.income_group_codes }),
+            ...(input.year_from != null && { yearFrom: input.year_from }),
+            ...(input.year_to != null && { yearTo: input.year_to }),
+            ...(input.sex && { sex: input.sex }),
+            ...(input.dim1_value && { dim1Value: input.dim1_value }),
+        };
+        const { rows, totalRows, truncated } = await getGhoService().queryData(queryParams, ctx);
+        if (rows.length === 0) {
+            throw ctx.fail('no_data', `Indicator "${input.indicator_code}" returned no data for the applied filters.`, { indicatorCode: input.indicator_code, ...ctx.recoveryFor('no_data') });
+        }
+        const truncatedNote = truncated
+            ? `Showing ${input.limit} of ${totalRows} rows. Narrow the filters (year range, spatial codes) or increase the limit (max 1000) to retrieve more.`
+            : undefined;
+        return { rows, totalRows, truncated, ...(truncatedNote && { truncatedNote }) };
+    },
+    format: (result) => {
+        const lines = [
+            `**Rows: ${result.rows.length} shown${result.truncated ? ` of ${result.totalRows} total (truncated)` : ` of ${result.totalRows} total`}**`,
+            '',
+        ];
+        if (result.truncatedNote) {
+            lines.push(`> ${result.truncatedNote}`, '');
+        }
+        for (const row of result.rows) {
+            const spatial = [row.spatialDimType, row.spatialDim, row.spatialLabel]
+                .filter(Boolean)
+                .join(' / ');
+            const dim1 = row.dim1Type ? ` | ${row.dim1Type}: ${row.dim1}` : '';
+            const dim2 = row.dim2Type ? ` | ${row.dim2Type}: ${row.dim2}` : '';
+            const displayPart = row.displayValue ? ` display=${row.displayValue}` : '';
+            const numericPart = row.numericValue != null ? ` numeric=${row.numericValue}` : '';
+            const uncertainty = row.low != null && row.high != null ? ` [${row.low}–${row.high}]` : '';
+            const comments = row.comments ? ` — ${row.comments}` : '';
+            lines.push(`- [${row.indicatorCode}] **${row.year}** | ${spatial}${dim1}${dim2}${displayPart}${numericPart}${uncertainty}${comments}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=who-query-indicator-data.tool.js.map

package/dist/mcp-server/tools/definitions/who-query-indicator-data.tool.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Search the WHO GHO indicator catalog by keyword.
+ * @module mcp-server/tools/definitions/who-search-indicators
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const whoSearchIndicators: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    indicators: z.ZodArray<z.ZodObject<{
+        indicatorCode: z.ZodString;
+        indicatorName: z.ZodString;
+    }, z.core.$strip>>;
+    totalMatches: z.ZodNumber;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No indicators matched the query keyword.";
+    readonly recovery: "Try a different keyword or use who_list_indicators to browse the full catalog without a filter.";
+}]>;
+//# sourceMappingURL=who-search-indicators.tool.d.ts.map

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

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

package/dist/mcp-server/tools/definitions/who-search-indicators.tool.js

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Search the WHO GHO indicator catalog by keyword.
+ * @module mcp-server/tools/definitions/who-search-indicators
+ */
+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 whoSearchIndicators = tool('who_search_indicators', {
+    title: 'Search WHO GHO Indicators',
+    description: 'Search the WHO Global Health Observatory indicator catalog by keyword in the indicator name. ' +
+        'Returns indicator codes and names for use with who_query_indicator_data. ' +
+        'The search uses a substring match on indicator names — try terms like "life expectancy", ' +
+        '"immunization", "mortality", "diabetes", or "HIV". ' +
+        'If results are truncated, refine the query or use who_list_indicators to browse by offset.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        query: z
+            .string()
+            .min(1)
+            .describe('Keyword to search in indicator names, e.g. "life expectancy" or "tuberculosis".'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(20)
+            .describe('Maximum number of indicators to return. Default 20, max 100.'),
+    }),
+    output: z.object({
+        indicators: z
+            .array(z
+            .object({
+            indicatorCode: z
+                .string()
+                .describe('Unique indicator code used in who_query_indicator_data, e.g. "WHOSIS_000001".'),
+            indicatorName: z
+                .string()
+                .describe('Full indicator name, e.g. "Life expectancy at birth (years)".'),
+        })
+            .describe('An indicator entry with its code and name.'))
+            .describe('Matching indicators up to the requested limit.'),
+        totalMatches: z
+            .number()
+            .describe('Total count of indicators matching the query, before the limit is applied.'),
+        note: z
+            .string()
+            .optional()
+            .describe('Present when the limit was reached and more results exist. Suggests how to get additional results.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No indicators matched the query keyword.',
+            recovery: 'Try a different keyword or use who_list_indicators to browse the full catalog without a filter.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Searching indicators', { query: input.query, limit: input.limit });
+        const { indicators, total } = await getGhoService().listIndicators({ query: input.query, limit: input.limit, offset: 0 }, ctx);
+        if (indicators.length === 0) {
+            throw ctx.fail('no_results', `No indicators matched "${input.query}".`, {
+                ...ctx.recoveryFor('no_results'),
+            });
+        }
+        const truncated = total > input.limit;
+        return {
+            indicators,
+            totalMatches: total,
+            ...(truncated && {
+                note: `Showing ${input.limit} of ${total} matches. Refine the query or increase the limit (max 100) to get more targeted results.`,
+            }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Found ${result.totalMatches} indicator${result.totalMatches === 1 ? '' : 's'} (showing ${result.indicators.length}):**`,
+            '',
+        ];
+        for (const ind of result.indicators) {
+            lines.push(`- **${ind.indicatorCode}**: ${ind.indicatorName}`);
+        }
+        if (result.note) {
+            lines.push('', `> ${result.note}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=who-search-indicators.tool.js.map

package/dist/mcp-server/tools/definitions/who-search-indicators.tool.js.map

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

package/dist/services/gho/gho-service.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview GHO OData API client for the WHO Global Health Observatory.
+ * @module services/gho/gho-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { DataQueryParams, DataRow, Dimension, DimensionValue, Indicator, IndicatorDimensionEntry } from './types.js';
+export declare class GhoService {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(_config: AppConfig, _storage: StorageService);
+    /** Fetch the indicator catalog with optional keyword search. */
+    listIndicators(params: {
+        query?: string;
+        limit: number;
+        offset: number;
+    }, ctx: Context): Promise<{
+        indicators: Indicator[];
+        total: number;
+    }>;
+    /** Fetch all dimension type codes and titles. */
+    listDimensions(ctx: Context): Promise<Dimension[]>;
+    /** Fetch valid values for a dimension type. Returns empty array if unknown code. */
+    listDimensionValues(dimensionCode: string, ctx: Context): Promise<DimensionValue[]>;
+    /**
+     * Fetch dimension metadata for multiple indicator codes in parallel.
+     * Returns a map of code → dimensions. Codes with empty metadata are absent from the map.
+     */
+    getIndicatorDimensions(indicatorCodes: string[], ctx: Context): Promise<Map<string, IndicatorDimensionEntry[]>>;
+    /** Query data rows for an indicator with optional OData filters. */
+    queryData(params: DataQueryParams, ctx: Context): Promise<{
+        rows: DataRow[];
+        totalRows: number;
+        truncated: boolean;
+    }>;
+    private normalizeRow;
+    /**
+     * Raw fetch with composed timeout + cancellation signal.
+     * Does not throw on non-2xx — callers inspect `response.status` as needed.
+     */
+    private fetchRaw;
+    /** Internal: fetch JSON from a URL and parse the OData envelope. Throws ServiceUnavailable on non-2xx. */
+    private getJson;
+    /** Escape single quotes in OData string values. */
+    private escapeODataString;
+}
+export declare function initGhoService(config: AppConfig, storage: StorageService): void;
+export declare function getGhoService(): GhoService;
+//# sourceMappingURL=gho-service.d.ts.map

package/dist/services/gho/gho-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gho-service.d.ts","sourceRoot":"","sources":["../../../src/services/gho/gho-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,SAAS,EACT,cAAc,EACd,SAAS,EACT,uBAAuB,EAOxB,MAAM,YAAY,CAAC;AAKpB,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc;IAOxD,gEAAgE;IAChE,cAAc,CACZ,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EACzD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAyBtD,iDAAiD;IACjD,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAWlD,oFAAoF;IACpF,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAiBnF;;;OAGG;IACG,sBAAsB,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;IA6BlD,oEAAoE;IACpE,SAAS,CACP,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IA0FtE,OAAO,CAAC,YAAY;IAsBpB;;;OAGG;YACW,QAAQ;IAkBtB,0GAA0G;YAC5F,OAAO;IAkBrB,mDAAmD;IACnD,OAAO,CAAC,iBAAiB;CAG1B;AAMD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAE/E;AAED,wBAAgB,aAAa,IAAI,UAAU,CAK1C"}