who-gho-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['indicator_codes'], 'properties': {'indicator_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 10, 'minItems': 1, 'description': 'One to ten indicator codes, e.g. ["WHOSIS_000001", "MDG_0000000026"].'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['indicators', 'notFound']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['all_not_found'], 'description': 'Machine-readable failure mode. Declared by this tool: `all_not_found`: No requested indicator code resolved to a catalog entry. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notFound': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Indicator codes that resolved to neither a catalog name nor any dimension rows â\x80\x94 they do not exist in the GHO catalog.'}, 'indicators': {'type': 'array', 'items': {'type': 'object', 'required': ['indicatorCode', 'indicatorName', 'dimensions'], 'properties': {'dimensions': {'type': 'array', 'items': {'type': 'object', 'required': ['dimension', 'dimensionName'], 'properties': {'dimension': {'type': 'string', 'description': 'Dimension type code, e.g. "COUNTRY", "SEX", "WORLDBANKINCOMEGROUP".'}, 'dimensionName': {'type': 'string', 'description': 'Human-readable dimension name, e.g. "Country", "Sex".'}}, 'description': 'A dimension entry supported by this indicator.', 'additionalProperties': False}, 'description': 'Dimensions this indicator supports for filtering in who_query_indicator_data. Empty when the GHO dimension table lists none for this code â\x80\x94 see dimensionsNote.'}, 'indicatorCode': {'type': 'string', 'description': 'Indicator code.'}, 'indicatorName': {'type': 'string', 'description': 'Full indicator name as returned by the GHO catalog.'}, 'dimensionsNote': {'type': 'string', 'description': 'Present only when dimensions is empty: explains that the listing is missing upstream rather than the indicator being absent, and how to recover the dimensions from a sample data row.'}}, 'description': 'Metadata for one indicator.', 'additionalProperties': False}, 'description': 'Metadata for each code that resolved to a catalog entry.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['dimensions']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'description': 'Machine-readable failure mode.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'dimensions': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'title'], 'properties': {'code': {'type': 'string', 'description': 'Dimension type code, e.g. "COUNTRY", "SEX", "AGEGROUP".'}, 'title': {'type': 'string', 'description': 'Human-readable label for the dimension, e.g. "Age Group".'}}, 'description': 'A single dimension type entry.', 'additionalProperties': False}, 'description': 'All available dimension types in the GHO catalog.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dimension'], 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 500, 'minimum': 1, 'description': 'Number of values to return per page. Default 100, max 500.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based offset into the values for this dimension and filter. Default 0. Read hasMore and nextOffset from the response to continue paging. An offset at or beyond totalCount returns an empty values array, not an error.'}, 'dimension': {'type': 'string', 'minLength': 1, 'description': 'Dimension type code. Use who_list_dimensions to discover all available codes. Common values: COUNTRY, REGION, SEX, WORLDBANKINCOMEGROUP, AGEGROUP.'}, 'parent_code': {'type': 'string', 'minLength': 1, 'description': 'Restrict results to values under one parent, e.g. dimension="COUNTRY" with parent_code="EUR" for the countries in the WHO European Region. Only hierarchical dimensions carry a parent; a filter that matches nothing returns an empty page, not an error.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['dimension', 'values', 'totalCount', 'offset', 'hasMore', 'pageInfo']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['dimension_not_found', 'malformed_identifier'], 'description': 'Machine-readable failure mode. Declared by this tool: `dimension_not_found`: An unfiltered lookup of the dimension code returned no values at all â\x80\x94 it does not exist in the GHO catalog. `malformed_identifier`: dimension carries an unpaired UTF-16 surrogate, so it cannot be encoded into the request URL. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Present when values were withheld, the parent_code filter matched nothing, or the requested offset ran past the end. Explains what to do next.'}, 'offset': {'type': 'number', 'description': 'Zero-based offset this page started at.'}, 'values': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Dimension value code used as a filter in who_query_indicator_data.'}, 'label': {'type': 'string', 'description': 'Human-readable label for this value.'}, 'parentCode': {'type': 'string', 'description': 'Parent value code, e.g. the WHO region code for a country entry.'}, 'parentLabel': {'type': 'string', 'description': 'Human-readable label for the parent value.'}, 'parentDimension': {'type': 'string', 'description': 'Parent dimension type, e.g. "REGION" for country entries.'}}, 'description': 'A single valid value for this dimension type.', 'additionalProperties': False}, 'description': 'Valid values for this dimension type, for the requested page.'}, 'hasMore': {'type': 'boolean', 'description': 'True when more values remain beyond this page. Pair with nextOffset to continue.'}, 'pageInfo': {'type': 'string', 'description': 'Human-readable page position, e.g. "offset 0, showing 100 of 234". Use to construct the next offset.'}, 'dimension': {'type': 'string', 'description': 'The requested dimension type code.'}, 'nextOffset': {'type': 'number', 'description': 'Offset to request for the next page. Absent when this page reached the end of the values.'}, 'totalCount': {'type': 'number', 'description': 'Total values for this dimension and filter, before the limit is applied.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 500, 'minimum': 1, 'description': 'Number of indicators to return per page. Default 50, max 500.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based offset for pagination. Default 0.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['indicators', 'totalCount', 'hasMore', 'pageInfo']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'description': 'Machine-readable failure mode.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'hasMore': {'type': 'boolean', 'description': 'True when more indicators exist beyond the current page.'}, 'pageInfo': {'type': 'string', 'description': 'Human-readable page position, e.g. "offset 0, showing 50 of 3059". Use to construct the next offset.'}, 'indicators': {'type': 'array', 'items': {'type': 'object', 'required': ['indicatorCode', 'indicatorName'], 'properties': {'indicatorCode': {'type': 'string', 'description': 'Unique indicator code used in who_query_indicator_data, e.g. "WHOSIS_000001".'}, 'indicatorName': {'type': 'string', 'description': 'Full indicator name, e.g. "Life expectancy at birth (years)".'}}, 'description': 'An indicator entry with its code and name.', 'additionalProperties': False}, 'description': 'Indicators for the requested page.'}, 'totalCount': {'type': 'number', 'description': 'Total number of indicators in the GHO catalog.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['indicator_code'], 'properties': {'sex': {'enum': ['SEX_BTSX', 'SEX_FMLE', 'SEX_MLE'], 'type': 'string', 'description': '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.'}, 'sort': {'enum': ['year_desc', 'year_asc'], 'type': 'string', 'default': 'year_desc', 'description': 'Row ordering: "year_desc" (default) returns the most recent years first, "year_asc" the earliest first. Ties are broken by spatial code, then dimension, then row id.'}, 'limit': {'type': 'integer', 'default': 200, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of data rows to return. Default 200, max 1000.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based row offset for pagination. Default 0. Pages are stable because rows are returned in a deterministic order â\x80\x94 read hasMore and nextOffset from the response to continue. An offset at or beyond totalRows returns an empty rows array, not an error.'}, 'year_to': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'End year (inclusive) for the time range filter, e.g. 2023.'}, 'year_from': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Start year (inclusive) for the time range filter, e.g. 2015.'}, 'dim1_value': {'type': 'string', 'description': 'Value filter for indicators whose first cross-cutting dimension is not SEX (e.g. an AGEGROUP code like "YEARS05-14"). Ignored when sex is also provided.'}, 'region_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'description': 'WHO region codes to filter on, e.g. ["AFR","EUR","AMR","EMR","SEAR","WPR"]. Returns the aggregate row for each named WHO region â\x80\x94 not per-country rows within it. To get country-level data for a region, use who_list_dimension_values with dimension="COUNTRY" and parent_code set to the region code to retrieve the ISO codes for countries in that region, then pass those to country_codes. Use who_list_dimension_values with dimension="REGION" to see all valid region codes. Mutually exclusive with country_codes and income_group_codes.'}, 'country_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'description': 'ISO 3166-1 alpha-3 country codes to filter on, e.g. ["JPN","USA","BRA"]. Mutually exclusive with region_codes and income_group_codes.'}, 'indicator_code': {'type': 'string', 'minLength': 1, 'description': 'Indicator code to query, e.g. "WHOSIS_000001". Use who_search_indicators to find codes.'}, 'income_group_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'description': '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.'}, 'include_uncertainty': {'type': 'boolean', 'default': True, 'description': 'Include Low and High uncertainty interval bounds in output. Default true.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['rows', 'appliedFilters', 'totalRows', 'totalCount', 'offset', 'hasMore', 'pageInfo']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['indicatorCode'], 'properties': {'low': {'type': 'number', 'description': 'Lower bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.'}, 'dim1': {'type': 'string', 'description': 'First cross-cutting dimension value, e.g. "SEX_BTSX".'}, 'dim2': {'type': 'string', 'description': 'Second cross-cutting dimension value.'}, 'high': {'type': 'number', 'description': 'Upper bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.'}, 'year': {'type': 'number', 'description': 'Year of the data point. Absent when the upstream row has no TimeDim (time-independent entries).'}, 'comments': {'type': 'string', 'description': 'Data source notes or comments attached to this row.'}, 'dim1Type': {'type': 'string', 'description': 'First cross-cutting dimension type, e.g. "SEX".'}, 'dim2Type': {'type': 'string', 'description': 'Second cross-cutting dimension type, e.g. "AGEGROUP".'}, 'spatialDim': {'type': 'string', 'description': 'Spatial dimension value, e.g. "JPN", "AFR", "WB_HI".'}, 'displayValue': {'type': 'string', 'description': 'Formatted display string as provided by WHO, e.g. "84.5 [84.5-84.5]".'}, 'numericValue': {'type': 'number', 'description': 'Machine-readable numeric value.'}, 'indicatorCode': {'type': 'string', 'description': 'Indicator code for this row.'}, 'parentLocation': {'type': 'string', 'description': 'Name of the WHO region this row sits under, e.g. "Western Pacific" for a JPN row. Not a label for spatialDim itself â\x80\x94 the upstream row carries no name for its own spatial entity. Absent when spatialDim is already a region or income group.'}, 'spatialDimType': {'type': 'string', 'description': 'Spatial dimension type: COUNTRY, REGION, WORLDBANKINCOMEGROUP, GLOBAL, etc.'}, 'parentLocationCode': {'type': 'string', 'description': 'Code of the WHO region this row sits under, e.g. "WPR". Pass to region_codes to query that region\'s own aggregate rows. Absent alongside parentLocation.'}}, 'description': 'A single data row from the GHO indicator dataset.', 'additionalProperties': False}, 'description': 'Data rows matching the query.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['indicator_not_found', 'no_data', 'ambiguous_spatial_filter', 'invalid_year_range', 'invalid_query', 'malformed_identifier'], 'description': 'Machine-readable failure mode. Declared by this tool: `indicator_not_found`: The indicator code returned HTTP 404 from the GHO API. `no_data`: The indicator exists but no data rows matched the applied filters. `ambiguous_spatial_filter`: More than one of country_codes, region_codes, or income_group_codes were provided. `invalid_year_range`: year_from is greater than year_to, so the time filter can match no rows. `invalid_query`: The GHO API rejected the generated OData query because a supplied filter value is not a valid literal. `malformed_identifier`: indicator_code carries an unpaired UTF-16 surrogate, so it cannot be encoded into the request URL. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Present when rows were withheld or the requested offset ran past the end of the result set. Explains how to reach the remaining rows.'}, 'offset': {'type': 'number', 'description': 'Zero-based row offset this page started at.'}, 'hasMore': {'type': 'boolean', 'description': 'True when rows remain beyond this page. Pair with nextOffset to continue.'}, 'pageInfo': {'type': 'string', 'description': 'Human-readable page position, e.g. "offset 0, showing 200 of 12936". Use to construct the next offset.'}, 'totalRows': {'type': 'number', 'description': 'Total row count matching the query on the server (before the limit is applied).'}, 'truncated': {'type': 'boolean', 'description': 'True when the result was capped at the requested limit.'}, 'nextOffset': {'type': 'number', 'description': 'Offset to request for the next page. Absent when this page reached the end of the result set.'}, 'totalCount': {'type': 'number', 'description': 'Alias of totalRows for cross-tool consistency â\x80\x94 total rows before the limit.'}, 'appliedFilters': {'type': 'object', 'required': ['indicatorCode', 'ordering'], 'properties': {'sex': {'type': 'string', 'description': 'Sex filter value applied, if any.'}, 'ordering': {'type': 'string', 'description': 'Row ordering applied to the query, e.g. "most recent first (year_desc)".'}, 'dim1Value': {'type': 'string', 'description': 'dim1_value filter applied, if any.'}, 'yearRange': {'type': 'string', 'description': 'Applied year range, e.g. "2015â\x80\x932023". Absent when no year filter was set.'}, 'indicatorCode': {'type': 'string', 'description': 'Indicator code that was queried.'}, 'spatialFilter': {'type': 'string', 'description': 'Active spatial filter summary, e.g. "country_codes: JPN,USA" or "region_codes: EUR".'}}, 'description': 'Filters that were applied to the query.', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of indicators to return. Default 20, max 100.'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Keyword to search in indicator names, e.g. "life expectancy" or "tuberculosis".'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based offset into the matches for this query. Default 0. Read hasMore and nextOffset from the response to continue paging. An offset at or beyond totalCount returns an empty indicators array, not an error.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['indicators', 'effectiveQuery', 'totalCount', 'offset', 'hasMore', 'pageInfo']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['no_results'], 'description': 'Machine-readable failure mode. Declared by this tool: `no_results`: No indicators matched the query keyword. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Present when matches were withheld or the requested offset ran past the end of the result set. Explains how to reach the remaining matches.'}, 'offset': {'type': 'number', 'description': 'Zero-based offset this page started at.'}, 'hasMore': {'type': 'boolean', 'description': 'True when more matches remain beyond this page. Pair with nextOffset to continue.'}, 'pageInfo': {'type': 'string', 'description': 'Human-readable page position, e.g. "offset 0, showing 20 of 3003". Use to construct the next offset.'}, 'indicators': {'type': 'array', 'items': {'type': 'object', 'required': ['indicatorCode', 'indicatorName'], 'properties': {'indicatorCode': {'type': 'string', 'description': 'Unique indicator code used in who_query_indicator_data, e.g. "WHOSIS_000001".'}, 'indicatorName': {'type': 'string', 'description': 'Full indicator name, e.g. "Life expectancy at birth (years)".'}}, 'description': 'An indicator entry with its code and name.', 'additionalProperties': False}, 'description': 'Matching indicators up to the requested limit.'}, 'nextOffset': {'type': 'number', 'description': 'Offset to request for the next page. Absent when this page reached the end of the matches.'}, 'totalCount': {'type': 'number', 'description': 'Total indicators matching the query in the catalog, before the limit is applied.'}, 'effectiveQuery': {'type': 'string', 'description': 'Keyword used for the catalog search, as received by the server.'}}, 'additionalProperties': False}