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

NameTypeRequiredDescription
indicatorstringyesIndicator NAME (“measles immunization coverage”, “life expectancy at birth”) or a GHO code (“mslv”, “WHOSIS_000001”). Names are resolved — do not invent a code.
countrystringnoCountry NAME (“Kenya”, “United States”) or ISO3 code (“KEN”, “USA”).
yearstringnoYear, 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

FieldTypeDescription
indicatorstringThe requested indicator code
totalnumberTotal number of data values found
returnednumberNumber of data values actually returned (max 100)
dataarrayArray 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.

Regenerated from source · build August 8, 2026