Who Gho Mcp Server

Working · 1.5 s

io.github.cyanheads/who-gho-mcp-serverv0.3.6

WHO Global Health Observatory — 3,059 indicators across 194 member states.

Health & Science

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://who-gho.caseyjhand.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

who_get_indicator_metadata Read-only

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. Many valid indicators have no dimension listing upstream — those return an empty dimensions array with a dimensionsNote, not a not-found. Only codes absent from the catalog are reported in the notFound array, and that is reported rather than raised as an error.

indicator_codesarray, required

One to ten indicator codes, e.g. ["WHOSIS_000001", "MDG_0000000026"].

Tools (6)

who_get_indicator_metadata

read-only

Argument	Type	Description
indicator_codes*	array	One to ten indicator codes, e.g. ["WHOSIS_000001", "MDG_0000000026"].

Input schema (JSON)

{
  "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
}

who_list_dimension_values

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. Results are paged in a deterministic order — narrow hierarchical dimensions with parent_code (e.g. the countries in one WHO region), and page the rest with offset.

read-only

Argument	Type	Description
limit	integer	Number of values to return per page. Default 100, max 500.
offset	integer	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*	string	Dimension type code. Use who_list_dimensions to discover all available codes. Common values: COUNTRY, REGION, SEX, WORLDBANKINCOMEGROUP, AGEGROUP.
parent_code	string	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.

Input schema (JSON)

{
  "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
}

who_list_dimensions

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 tool exposes them all.

read-only

No arguments.

Input schema (JSON)

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

who_list_indicators

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.

read-only

Argument	Type	Description
limit	integer	Number of indicators to return per page. Default 50, max 500.
offset	integer	Zero-based offset for pagination. Default 0.

Input schema (JSON)

{
  "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
}

who_query_indicator_data

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 only applies when the indicator uses SEX as its first cross-cutting dimension — if not, the filter returns empty rows; check who_get_indicator_metadata first if uncertain. Rows are returned in a deterministic order (most recent first by default), so a capped result is the top of a defined slice rather than an arbitrary sample; page through the rest with offset.

read-only

Argument	Type	Description
sex	string	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	string	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	integer	Maximum number of data rows to return. Default 200, max 1000.
offset	integer	Zero-based row offset for pagination. Default 0. Pages are stable because rows are returned in a deterministic order — read hasMore and nextOffset from the response to continue. An offset at or beyond totalRows returns an empty rows array, not an error.

who_search_indicators

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 page further into the same filtered result set with offset.

read-only

Argument	Type	Description
limit	integer	Maximum number of indicators to return. Default 20, max 100.
query*	string	Keyword to search in indicator names, e.g. "life expectancy" or "tuberculosis".
offset	integer	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.

Input schema (JSON)

{
  "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", "$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 — 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 — 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 }