who-gho-mcp-server
WHO Global Health Observatory — 3,059 indicators across 194 member states.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~6,099トークン数（ツール定義）
~11.4 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 4.76%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"who-gho-mcp-server": {
"command": "bun",
"args": [
"@cyanheads/who-gho-mcp-server"
]
}
}
}実行可能なパッケージ
npm@cyanheads/who-gho-mcp-server
0.3.5streamable-httpリモートエンドポイント
https://who-gho.caseyjhand.com/mcpstreamable-httpできること
ツール一覧
ツール（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.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"dimensions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Dimension type code, e.g. \"COUNTRY\", \"SEX\", \"AGEGROUP\"."
},
"title": {
"type": "string",
"description": "Human-readable label for the dimension, e.g. \"Age Group\"."
}
},
"required": [
"code",
"title"
],
"additionalProperties": false,
"description": "A single dimension type entry."
},
"description": "All available dimension types in the GHO catalog."
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode."
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"dimensions"
]
},
{
"required": [
"error"
]
}
]
}🟢who_list_dimension_values(dimension, parent_code, limit, offset)
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.
入力スキーマ
{
"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"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"dimension": {
"type": "string",
"description": "The requested dimension type code."
},
"values": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Dimension value code used as a filter in who_query_indicator_data."
},
"label": {
"type": "string",
"description": "Human-readable label for this value."
},
"parentCode": {
"description": "Parent value code, e.g. the WHO region code for a country entry.",
"type": "string"
},
"parentLabel": {
"description": "Human-readable label for the parent value.",
"type": "string"
},
"parentDimension": {
"description": "Parent dimension type, e.g. \"REGION\" for country entries.",
"type": "string"
}
},
"required": [
"code",
"label"
],
"additionalProperties": false,
"description": "A single valid value for this dimension type."
},
"description": "Valid values for this dimension type, for the requested page."
},
"totalCount": {
"type": "number",
"description": "Total values for this dimension and filter, before the limit is applied."
},
"offset": {
"type": "number",
"description": "Zero-based offset this page started at."
},
"hasMore": {
"type": "boolean",
"description": "True when more values remain beyond this page. Pair with nextOffset to continue."
},
"pageInfo": {
"type": "string",
"description": "Human-readable page position, e.g. \"offset 0, showing 100 of 234\". Use to construct the next offset."
},
"nextOffset": {
"description": "Offset to request for the next page. Absent when this page reached the end of the values.",
"type": "number"
},
"notice": {
"description": "Present when values were withheld, the parent_code filter matched nothing, or the requested offset ran past the end. Explains what to do next.",
"type": "string"
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode. Declared by this tool: `dimension_not_found`: An unfiltered lookup of the dimension code returned no values at all — it does not exist in the GHO catalog. `malformed_identifier`: dimension carries an unpaired UTF-16 surrogate, so it cannot be encoded into the request URL. Other values are possible when a failure originates below the handler.",
"examples": [
"dimension_not_found",
"malformed_identifier"
]
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"dimension",
"values",
"totalCount",
"offset",
"hasMore",
"pageInfo"
]
},
{
"required": [
"error"
]
}
]
}🟢who_search_indicators(query, limit, offset)
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.
入力スキーマ
{
"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"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"indicatorCode": {
"type": "string",
"description": "Unique indicator code used in who_query_indicator_data, e.g. \"WHOSIS_000001\"."
},
"indicatorName": {
"type": "string",
"description": "Full indicator name, e.g. \"Life expectancy at birth (years)\"."
}
},
"required": [
"indicatorCode",
"indicatorName"
],
"additionalProperties": false,
"description": "An indicator entry with its code and name."
},
"description": "Matching indicators up to the requested limit."
},
"effectiveQuery": {
"type": "string",
"description": "Keyword used for the catalog search, as received by the server."
},
"totalCount": {
"type": "number",
"description": "Total indicators matching the query in the catalog, before the limit is applied."
},
"offset": {
"type": "number",
"description": "Zero-based offset this page started at."
},
"hasMore": {
"type": "boolean",
"description": "True when more matches remain beyond this page. Pair with nextOffset to continue."
},
"pageInfo": {
"type": "string",
"description": "Human-readable page position, e.g. \"offset 0, showing 20 of 3003\". Use to construct the next offset."
},
"nextOffset": {
"description": "Offset to request for the next page. Absent when this page reached the end of the matches.",
"type": "number"
},
"notice": {
"description": "Present when matches were withheld or the requested offset ran past the end of the result set. Explains how to reach the remaining matches.",
"type": "string"
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode. Declared by this tool: `no_results`: No indicators matched the query keyword. Other values are possible when a failure originates below the handler.",
"examples": [
"no_results"
]
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"indicators",
"effectiveQuery",
"totalCount",
"offset",
"hasMore",
"pageInfo"
]
},
{
"required": [
"error"
]
}
]
}🟢who_list_indicators(limit, offset)
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.
入力スキーマ
{
"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
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"indicatorCode": {
"type": "string",
"description": "Unique indicator code used in who_query_indicator_data, e.g. \"WHOSIS_000001\"."
},
"indicatorName": {
"type": "string",
"description": "Full indicator name, e.g. \"Life expectancy at birth (years)\"."
}
},
"required": [
"indicatorCode",
"indicatorName"
],
"additionalProperties": false,
"description": "An indicator entry with its code and name."
},
"description": "Indicators for the requested page."
},
"totalCount": {
"type": "number",
"description": "Total number of indicators in the GHO catalog."
},
"hasMore": {
"type": "boolean",
"description": "True when more indicators exist beyond the current page."
},
"pageInfo": {
"type": "string",
"description": "Human-readable page position, e.g. \"offset 0, showing 50 of 3059\". Use to construct the next offset."
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode."
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"indicators",
"totalCount",
"hasMore",
"pageInfo"
]
},
{
"required": [
"error"
]
}
]
}🟢who_get_indicator_metadata(indicator_codes)
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.
入力スキーマ
{
"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"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"indicatorCode": {
"type": "string",
"description": "Indicator code."
},
"indicatorName": {
"type": "string",
"description": "Full indicator name as returned by the GHO catalog."
},
"dimensions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dimension": {
"type": "string",
"description": "Dimension type code, e.g. \"COUNTRY\", \"SEX\", \"WORLDBANKINCOMEGROUP\"."
},
"dimensionName": {
"type": "string",
"description": "Human-readable dimension name, e.g. \"Country\", \"Sex\"."
}
},
"required": [
"dimension",
"dimensionName"
],
"additionalProperties": false,
"description": "A dimension entry supported by this indicator."
},
"description": "Dimensions this indicator supports for filtering in who_query_indicator_data. Empty when the GHO dimension table lists none for this code — see dimensionsNote."
},
"dimensionsNote": {
"description": "Present only when dimensions is empty: explains that the listing is missing upstream rather than the indicator being absent, and how to recover the dimensions from a sample data row.",
"type": "string"
}
},
"required": [
"indicatorCode",
"indicatorName",
"dimensions"
],
"additionalProperties": false,
"description": "Metadata for one indicator."
},
"description": "Metadata for each code that resolved to a catalog entry."
},
"notFound": {
"type": "array",
"items": {
"type": "string"
},
"description": "Indicator codes that resolved to neither a catalog name nor any dimension rows — they do not exist in the GHO catalog."
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode. Declared by this tool: `all_not_found`: No requested indicator code resolved to a catalog entry. Other values are possible when a failure originates below the handler.",
"examples": [
"all_not_found"
]
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"indicators",
"notFound"
]
},
{
"required": [
"error"
]
}
]
}🟢who_query_indicator_data(indicator_code, country_codes, region_codes, income_group_codes, year_from, ...)
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.
入力スキーマ
{
"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"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"indicatorCode": {
"type": "string",
"description": "Indicator code for this row."
},
"spatialDimType": {
"description": "Spatial dimension type: COUNTRY, REGION, WORLDBANKINCOMEGROUP, GLOBAL, etc.",
"type": "string"
},
"spatialDim": {
"description": "Spatial dimension value, e.g. \"JPN\", \"AFR\", \"WB_HI\".",
"type": "string"
},
"parentLocation": {
"description": "Name of the WHO region this row sits under, e.g. \"Western Pacific\" for a JPN row. Not a label for spatialDim itself — the upstream row carries no name for its own spatial entity. Absent when spatialDim is already a region or income group.",
"type": "string"
},
"parentLocationCode": {
"description": "Code of the WHO region this row sits under, e.g. \"WPR\". Pass to region_codes to query that region's own aggregate rows. Absent alongside parentLocation.",
"type": "string"
},
"year": {
"description": "Year of the data point. Absent when the upstream row has no TimeDim (time-independent entries).",
"type": "number"
},
"dim1Type": {
"description": "First cross-cutting dimension type, e.g. \"SEX\".",
"type": "string"
},
"dim1": {
"description": "First cross-cutting dimension value, e.g. \"SEX_BTSX\".",
"type": "string"
},
"dim2Type": {
"description": "Second cross-cutting dimension type, e.g. \"AGEGROUP\".",
"type": "string"
},
"dim2": {
"description": "Second cross-cutting dimension value.",
"type": "string"
},
"numericValue": {
"description": "Machine-readable numeric value.",
"type": "number"
},
"low": {
"description": "Lower bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.",
"type": "number"
},
"high": {
"description": "Upper bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.",
"type": "number"
},
"displayValue": {
"description": "Formatted display string as provided by WHO, e.g. \"84.5 [84.5-84.5]\".",
"type": "string"
},
"comments": {
"description": "Data source notes or comments attached to this row.",
"type": "string"
}
},
"required": [
"indicatorCode"
],
"additionalProperties": false,
"description": "A single data row from the GHO indicator dataset."
},
"description": "Data rows matching the query."
},
"appliedFilters": {
"type": "object",
"properties": {
"indicatorCode": {
"type": "string",
"description": "Indicator code that was queried."
},
"spatialFilter": {
"description": "Active spatial filter summary, e.g. \"country_codes: JPN,USA\" or \"region_codes: EUR\".",
"type": "string"
},
"yearRange": {
"description": "Applied year range, e.g. \"2015–2023\". Absent when no year filter was set.",
"type": "string"
},
"sex": {
"description": "Sex filter value applied, if any.",
"type": "string"
},
"dim1Value": {
"description": "dim1_value filter applied, if any.",
"type": "string"
},
"ordering": {
"type": "string",
"description": "Row ordering applied to the query, e.g. \"most recent first (year_desc)\"."
}
},
"required": [
"indicatorCode",
"ordering"
],
"additionalProperties": false,
"description": "Filters that were applied to the query."
},
"totalRows": {
"type": "number",
"description": "Total row count matching the query on the server (before the limit is applied)."
},
"totalCount": {
"type": "number",
"description": "Alias of totalRows for cross-tool consistency — total rows before the limit."
},
"truncated": {
"description": "True when the result was capped at the requested limit.",
"type": "boolean"
},
"offset": {
"type": "number",
"description": "Zero-based row offset this page started at."
},
"hasMore": {
"type": "boolean",
"description": "True when rows remain beyond this page. Pair with nextOffset to continue."
},
"pageInfo": {
"type": "string",
"description": "Human-readable page position, e.g. \"offset 0, showing 200 of 12936\". Use to construct the next offset."
},
"nextOffset": {
"description": "Offset to request for the next page. Absent when this page reached the end of the result set.",
"type": "number"
},
"notice": {
"description": "Present when rows were withheld or the requested offset ran past the end of the result set. Explains how to reach the remaining rows.",
"type": "string"
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode. Declared by this tool: `indicator_not_found`: The indicator code returned HTTP 404 from the GHO API. `no_data`: The indicator exists but no data rows matched the applied filters. `ambiguous_spatial_filter`: More than one of country_codes, region_codes, or income_group_codes were provided. `invalid_year_range`: year_from is greater than year_to, so the time filter can match no rows. `invalid_query`: The GHO API rejected the generated OData query because a supplied filter value is not a valid literal. `malformed_identifier`: indicator_code carries an unpaired UTF-16 surrogate, so it cannot be encoded into the request URL. Other values are possible when a failure originates below the handler.",
"examples": [
"indicator_not_found",
"no_data",
"ambiguous_spatial_filter",
"invalid_year_range",
"invalid_query",
"malformed_identifier"
]
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"rows",
"appliedFilters",
"totalRows",
"totalCount",
"offset",
"hasMore",
"pageInfo"
]
},
{
"required": [
"error"
]
}
]
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 6 件
検証済みバージョンは記録されていませんツール 6 件
検証済みバージョンは記録されていませんツール 6 件