get_data
Pack: who-gho · Endpoint: https://gateway.pipeworx.io/who-gho/mcp
Get World Health Organization health statistics for a country and year — life expectancy, immunization coverage, mortality, disease burden, risk factors and health system measures from the Global Health Observatory. Accepts a plain indicator name such as “measles immunization coverage” and a plain country name such as “Kenya”; both are resolved to WHO codes and the response says what it resolved to. If the requested year has no data it returns the latest year that does, and says which.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
indicator | string | yes | Indicator NAME (“measles immunization coverage”, “life expectancy at birth”) or a GHO code (“mslv”, “WHOSIS_000001”). Names are resolved — do not invent a code. |
country | string | no | Country NAME (“Kenya”, “United States”) or ISO3 code (“KEN”, “USA”). |
year | string | no | Year, e.g. “2020”. If that year has no data the latest available year is returned instead, flagged as year_fallback. |
Example call
Arguments
{
"indicator": "measles immunization coverage",
"country": "Kenya",
"year": "2022"
}
curl
curl -X POST https://gateway.pipeworx.io/who-gho/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_data","arguments":{"indicator":"measles immunization coverage","country":"Kenya","year":"2022"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('get_data', {
"indicator": "measles immunization coverage",
"country": "Kenya",
"year": "2022"
});
More examples
{
"indicator": "life expectancy at birth",
"country": "Japan"
}
Response shape
Always returns: indicator, total, returned, data
| Field | Type | Description |
|---|---|---|
indicator | string | The requested indicator code |
total | number | Total number of data values found |
returned | number | Number of data values actually returned (max 100) |
data | array | Array of data values (max 100 returned) |
Full JSON Schema
{
"type": "object",
"properties": {
"indicator": {
"type": "string",
"description": "The requested indicator code"
},
"total": {
"type": "number",
"description": "Total number of data values found"
},
"returned": {
"type": "number",
"description": "Number of data values actually returned (max 100)"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": [
"string",
"null"
],
"description": "ISO country code"
},
"year": {
"type": [
"string",
"null"
],
"description": "Year of the data point"
},
"value": {
"type": [
"number",
"string",
"null"
],
"description": "Numeric or string value"
},
"low": {
"type": [
"string",
"null"
],
"description": "Lower bound estimate"
},
"high": {
"type": [
"string",
"null"
],
"description": "Upper bound estimate"
},
"dimension": {
"type": [
"string",
"null"
],
"description": "First dimension value (Dim1)"
},
"dimension_type": {
"type": [
"string",
"null"
],
"description": "Type of first dimension"
},
"comments": {
"type": [
"string",
"null"
],
"description": "Comments or notes on the value"
}
}
},
"description": "Array of data values (max 100 returned)"
}
},
"required": [
"indicator",
"total",
"returned",
"data"
]
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"who-gho": {
"url": "https://gateway.pipeworx.io/who-gho/mcp"
}
}
}
See Getting Started for client-specific install steps.