who-gho-mcp-server

v0.3.4 pre-1.0

Query WHO Global Health Observatory data — 3,059 indicators across 194 member states with country, region, year, and sex filters via MCP. STDIO or Streamable HTTP.

who-gho.caseyjhand.com/mcp
claude mcp add --transport http who-gho-mcp-server https://who-gho.caseyjhand.com/mcp
codex mcp add who-gho-mcp-server --url https://who-gho.caseyjhand.com/mcp
{
  "mcpServers": {
    "who-gho-mcp-server": {
      "url": "https://who-gho.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http who-gho-mcp-server https://who-gho.caseyjhand.com/mcp
{
  "mcpServers": {
    "who-gho-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://who-gho.caseyjhand.com/mcp"
      ]
    }
  }
}
{
  "mcpServers": {
    "who-gho-mcp-server": {
      "type": "http",
      "url": "https://who-gho.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://who-gho.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2026-07-28","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

6

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
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "who_list_dimensions",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
view source ↗

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
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "who_list_dimension_values",
    "arguments": {
      "dimension": "<dimension>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "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": {
      "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.",
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "default": 100,
      "description": "Number of values to return per page. Default 100, max 500.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "default": 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.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "dimension",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

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
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "who_search_indicators",
    "arguments": {
      "query": "<query>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Keyword to search in indicator names, e.g. \"life expectancy\" or \"tuberculosis\"."
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of indicators to return. Default 20, max 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 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.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "query",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

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
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "who_list_indicators",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "limit": {
      "default": 50,
      "description": "Number of indicators to return per page. Default 50, max 500.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset for pagination. Default 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

who_get_indicator_metadata

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "who_get_indicator_metadata",
    "arguments": {
      "indicator_codes": "<indicator_codes>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "indicator_codes": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "One to ten indicator codes, e.g. [\"WHOSIS_000001\", \"MDG_0000000026\"]."
    }
  },
  "required": [
    "indicator_codes"
  ],
  "additionalProperties": false
}
view source ↗

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
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "who_query_indicator_data",
    "arguments": {
      "indicator_code": "<indicator_code>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "indicator_code": {
      "type": "string",
      "minLength": 1,
      "description": "Indicator code to query, e.g. \"WHOSIS_000001\". Use who_search_indicators to find codes."
    },
    "country_codes": {
      "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.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "region_codes": {
      "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.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "income_group_codes": {
      "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.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "year_from": {
      "description": "Start year (inclusive) for the time range filter, e.g. 2015.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "year_to": {
      "description": "End year (inclusive) for the time range filter, e.g. 2023.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "sex": {
      "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.",
      "type": "string",
      "enum": [
        "SEX_BTSX",
        "SEX_FMLE",
        "SEX_MLE"
      ]
    },
    "dim1_value": {
      "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.",
      "type": "string"
    },
    "include_uncertainty": {
      "default": true,
      "description": "Include Low and High uncertainty interval bounds in output. Default true.",
      "type": "boolean"
    },
    "limit": {
      "default": 200,
      "description": "Maximum number of data rows to return. Default 200, max 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "default": 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.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "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.",
      "type": "string",
      "enum": [
        "year_desc",
        "year_asc"
      ]
    }
  },
  "required": [
    "indicator_code",
    "include_uncertainty",
    "limit",
    "offset",
    "sort"
  ],
  "additionalProperties": false
}
view source ↗

Resources

4

Metadata for a single WHO GHO indicator: full name and the dimension types it supports for filtering. Dimensions come back empty with a dimensionsNote when the GHO dimension table lists none for the code — that is a gap upstream, not a missing indicator. Stable and suitable as injectable context before calling who_query_indicator_data.

uri who://indicator/{indicatorCode}/metadata mime application/json

One page of valid values for a WHO GHO dimension type, in a deterministic order. Useful as injectable context when building queries with who_query_indicator_data. Use who_list_dimensions to discover valid dimension type codes. Returns the first 100 values; read totalCount and nextOffset to reach the rest.

uri who://dimension/{dimensionCode}/values mime application/json

One page of valid values for a WHO GHO dimension type, in a deterministic order. Useful as injectable context when building queries with who_query_indicator_data. Use who_list_dimensions to discover valid dimension type codes. Both limit and offset must be present in the URI.

uri who://dimension/{dimensionCode}/values{?limit,offset} mime application/json

One page of valid values for a WHO GHO dimension type, in a deterministic order. Useful as injectable context when building queries with who_query_indicator_data. Use who_list_dimensions to discover valid dimension type codes. Narrowed to one parent code; limit, offset, and parentCode must all be present in the URI. A filter that matches nothing returns an empty page, not an error.

uri who://dimension/{dimensionCode}/values{?limit,offset,parentCode} mime application/json