io.github.cyanheadsPublished by GitHub account cyanheadsv0.4.0Updated Oct 28, 2026
WHO Global Health Observatory — 3,102 indicators across 194 member states.
Queries WHO Global Health Observatory statistics — 3,102 indicators across 194 member states — letting an assistant search indicators and pull data by…
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.cyanheads%2Fwho-gho-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"who-gho": {
"type": "http",
"url": "https://who-gho.caseyjhand.com/mcp"
}
}
}Query WHO Global Health Observatory data — 3,102 indicators across 194 member states with country, region, year, and sex filters via MCP. STDIO or Streamable HTTP.
[Install in Claude Desktop] [Install in Cursor] [Install in VS Code]
Public Hosted Server: https://who-gho.caseyjhand.com/mcp
Global health statistics from the WHO Global Health Observatory: 3,102 indicators across 194 member states. Search indicators and query data by country, region, income group, sex, and year.
Each mirrors data also reachable via who_get_indicator_metadata and who_list_dimension_values — useful for clients that inject resources as context but don't call tools.
who-gho-guide covers dimension-position discovery, complete country comparisons, and countries versus regional aggregates. It ships with plugin installs, npm, Docker, and the MCPB bundle. MCP clients can discover its SKILL.md through resources/list or the io.modelcontextprotocol/skills extension (skills/list, skills/get, and resources/directory/read); the server also exposes the skill://{+path} resource template.
who_search_indicators toolwho_query_indicator_dataoffset, default 0) with limit default 20, max 100; reports totalCount, hasMore, pageInfo, nextOffsettotalCount returns an empty page; a no_results error is raised only when nothing matches at allwho_list_indicators toollimit (default 50, max 500) and offsettotalCount and hasMore for iterationwho_get_indicator_metadata toolunprocessedCodes next. With GHO_CLAMP_LIMITS=false, batches over 10 are rejected.COUNTRY, SEX, REGION, AGEGROUP) for each resolved codedimensions: [] plus a dimensionsNote pointing at a sample data row's dimension type/value pairs. Metadata does not identify dimension positions.notFound; the call fails when no processed code resolves and no unprocessed codes remainwho_list_dimensions toolCOUNTRY, REGION, SEX, WORLDBANKINCOMEGROUP, AGEGROUPwho_list_dimension_valueswho_list_dimension_values toolparentCode, parentLabel, parentDimension)parent_code narrows hierarchical dimensions — dimension: "COUNTRY" with parent_code: "EUR" returns the 58 countries in the WHO European RegionCode; offset-based pagination (offset) with limit default 100, max 500 — GHO (3,103 values) and DHSMICSGEOREGION (4,932) need pagingparent_code that matches nothing returns an empty page for a known dimension; unknown dimensions fail even with a parent filterdimension fails as a typed malformed_identifier validation errorwho_query_indicator_data toolcountry_codes (WHO country codes, including historical entries), region_codes (WHO aggregate rows), or income_group_codes (World Bank aggregate rows) — supplying more than one is a validation erroryear_from / year_to time range; sex (SEX_BTSX, SEX_FMLE, SEX_MLE) applies only when the indicator's first cross-cutting dimension is SEX. dim1_value, dim2_value, and dim3_value select observed positional values; discover positions from returned type/value pairs, not metadata. sex overrides dim1_value with a notice.include_uncertainty (default true) adds low/high bounds; sort (year_desc default or year_asc) with a total row ordering so paging never repeats or drops rowslimit default 200, max 1000; reports totalRows, hasMore, pageInfo, nextOffsetindicator_not_found, no_data, ambiguous_spatial_filter, invalid_year_range, invalid_query, malformed_identifierwho://indicator/{indicatorCode}/metadata resourceapplication/jsonindicatorCode comes from who_search_indicators or who_list_indicatorsdimensions carries a dimensionsNote when the upstream dimension table lists none for the code, rather than reporting a missing indicatorwho://dimension/{dimensionCode}/values resourcedimensionCode from who_list_dimensions), as application/jsonwho://dimension/{dimensionCode}/values{?limit,offset} resourcelimit (1–500) and offset must both be present in the URI — the query variables are required, not optionaltotalCount, hasMore, nextOffset, and an optional noticetotalCount returns an empty page, not an errorwho://dimension/{dimensionCode}/values{?limit,offset,parentCode} resourceparentCode to narrow to one parent value, e.g. parentCode="EUR" for countries in the WHO European Region; limit, offset, and parentCode must all be present in the URIparentCode that matches nothing returns an empty page for a known dimension; unknown dimensions fail even with a parent filterdimension, values, totalCount, hasMore, nextOffset, noticeBuilt on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
WHO GHO-specific:
GHO_BASE_URL, GHO_REQUEST_TIMEOUT_MS) for custom or mirrored deploymentsAgent-friendly output:
hasMore, nextOffset, pageInfo, and truncated on the data-query tool) so agents can decide whether to page furtherrecovery hint on every failure pathA public instance is available at https://who-gho.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP:
Add the following to your MCP client configuration file.
Or with npx (no Bun required):
Or with Docker:
For Streamable HTTP, set the transport and start the server:
See .env.example for the full list of optional overrides.
Build and run the production version:
Run checks and tests:
The Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/who-gho-mcp-server. OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.
See CLAUDE.md for development guidelines and architectural rules. The short version:
try/catch in tool logicctx.log for logging, ctx.state for storagecreateApp() arraysIssues are welcome. Run checks and tests before submitting:
Apache-2.0 — see LICENSE for details.
Source: README.md at commit 20caeb0
List GHO Dimension Types
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.
Takes no parameters.
List GHO 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 WHO code for a country, including historical codes. 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.
limitoffsetdimensionrequiredparent_codeSearch WHO GHO Indicators
Search the WHO Global Health Observatory indicator catalog by words in the indicator name. Every whitespace-separated word must match independently as a case-insensitive substring, in any order; try "tuberculosis incidence", "sanitation basic", or "HIV". When no names match, an exact indicator-code lookup is attempted. Returns canonical indicator codes and names for who_query_indicator_data. Refine the query or page through the same result set with offset.
limitqueryrequiredoffsetList WHO GHO 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.
limitoffsetGet WHO GHO Indicator Metadata
Fetch metadata for WHO GHO indicator codes: the canonical code, full name, and supported dimensions (e.g. COUNTRY, REGION, SEX, YEAR, WORLDBANKINCOMEGROUP, AGEGROUP). Call this before who_query_indicator_data to confirm valid filter dimensions. Processes the first 10 entries and returns unprocessedCodes to submit next, accepting at most 1000 raw entries. With GHO_CLAMP_LIMITS=false, calls above 10 reject. Many valid indicators have no dimension listing upstream — those return an empty dimensions array with dimensionsNote. Processed codes absent from both the catalog and dimension table appear in notFound. No found entries raises all_not_found only when no unprocessed entries remain.
indicator_codesrequiredQuery WHO GHO 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. Discover positional filters from returned dim1Type/dim1, dim2Type/dim2 and dim3Type/dim3 pairs; metadata alone does not identify a slot. 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.
sexsortlimitoffsetyear_toyear_fromdim1_valuedim2_valuedim3_valueregion_codescountry_codesindicator_coderequired+2 more100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
{ "mcpServers": { "who-gho-mcp-server": { "type": "streamable-http", "url": "https://who-gho.caseyjhand.com/mcp" } }}{ "mcpServers": { "who-gho-mcp-server": { "type": "stdio", "command": "bunx", "args": ["@cyanheads/who-gho-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info" } } }}{ "mcpServers": { "who-gho-mcp-server": { "type": "stdio", "command": "npx", "args": ["-y", "@cyanheads/who-gho-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info" } } }}{ "mcpServers": { "who-gho-mcp-server": { "type": "stdio", "command": "docker", "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/who-gho-mcp-server:latest"] } }}MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http# Server listens at http://localhost:3010/mcpgit clone https://github.com/cyanheads/who-gho-mcp-server.gitcd who-gho-mcp-serverbun installcp .env.example .env# edit .env and set optional overrides# One-time buildbun run rebuild
# Run the built serverbun run start:http# orbun run start:stdiobun run devcheck # Lints, formats, type-checks, and morebun run test # Runs the test suitedocker build -t who-gho-mcp-server .docker run --rm -p 3010:3010 who-gho-mcp-serverbun run devcheckbun run test