Server definition
- Hash
- sha256:611dff82f4a5b64852fec5b0b5093589e2fd7133e767d5b62d47929249bcff4e
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "WHO Global Health Observatory MCP server. Primary workflow: (1) who_search_indicators to find indicator codes by keyword, (2) who_get_indicator_metadata to confirm valid filter dimensions, (3) who_query_indicator_data to fetch data with country/region/year/sex filters. Use who_list_dimensions → who_list_dimension_values to discover valid filter codes.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"indicator_codes": {
"description": "One to ten indicator codes, e.g. [\"WHOSIS_000001\", \"MDG_0000000026\"].",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
},
"required": [
"indicator_codes"
],
"type": "object"
},
"name": "who_get_indicator_metadata",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"indicators",
"notFound"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"indicators": {
"description": "Metadata for each code that resolved to a catalog entry.",
"items": {
"additionalProperties": false,
"description": "Metadata for one indicator.",
"properties": {
"dimensions": {
"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.",
"items": {
"additionalProperties": false,
"description": "A dimension entry supported by this indicator.",
"properties": {
"dimension": {
"description": "Dimension type code, e.g. \"COUNTRY\", \"SEX\", \"WORLDBANKINCOMEGROUP\".",
"type": "string"
},
"dimensionName": {
"description": "Human-readable dimension name, e.g. \"Country\", \"Sex\".",
"type": "string"
}
},
"required": [
"dimension",
"dimensionName"
],
"type": "object"
},
"type": "array"
},
"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"
},
"indicatorCode": {
"description": "Indicator code.",
"type": "string"
},
"indicatorName": {
"description": "Full indicator name as returned by the GHO catalog.",
"type": "string"
}
},
"required": [
"indicatorCode",
"indicatorName",
"dimensions"
],
"type": "object"
},
"type": "array"
},
"notFound": {
"description": "Indicator codes that resolved to neither a catalog name nor any dimension rows — they do not exist in the GHO catalog.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dimension": {
"description": "Dimension type code. Use who_list_dimensions to discover all available codes. Common values: COUNTRY, REGION, SEX, WORLDBANKINCOMEGROUP, AGEGROUP.",
"minLength": 1,
"type": "string"
},
"limit": {
"default": 100,
"description": "Number of values to return per page. Default 100, max 500.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"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.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"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.",
"minLength": 1,
"type": "string"
}
},
"required": [
"dimension"
],
"type": "object"
},
"name": "who_list_dimension_values",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"dimension",
"values",
"totalCount",
"offset",
"hasMore",
"pageInfo"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"dimension": {
"description": "The requested dimension type code.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"hasMore": {
"description": "True when more values remain beyond this page. Pair with nextOffset to continue.",
"type": "boolean"
},
"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"
},
"offset": {
"description": "Zero-based offset this page started at.",
"type": "number"
},
"pageInfo": {
"description": "Human-readable page position, e.g. \"offset 0, showing 100 of 234\". Use to construct the next offset.",
"type": "string"
},
"totalCount": {
"description": "Total values for this dimension and filter, before the limit is applied.",
"type": "number"
},
"values": {
"description": "Valid values for this dimension type, for the requested page.",
"items": {
"additionalProperties": false,
"description": "A single valid value for this dimension type.",
"properties": {
"code": {
"description": "Dimension value code used as a filter in who_query_indicator_data.",
"type": "string"
},
"label": {
"description": "Human-readable label for this value.",
"type": "string"
},
"parentCode": {
"description": "Parent value code, e.g. the WHO region code for a country entry.",
"type": "string"
},
"parentDimension": {
"description": "Parent dimension type, e.g. \"REGION\" for country entries.",
"type": "string"
},
"parentLabel": {
"description": "Human-readable label for the parent value.",
"type": "string"
}
},
"required": [
"code",
"label"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "who_list_dimensions",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"dimensions"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"dimensions": {
"description": "All available dimension types in the GHO catalog.",
"items": {
"additionalProperties": false,
"description": "A single dimension type entry.",
"properties": {
"code": {
"description": "Dimension type code, e.g. \"COUNTRY\", \"SEX\", \"AGEGROUP\".",
"type": "string"
},
"title": {
"description": "Human-readable label for the dimension, e.g. \"Age Group\".",
"type": "string"
}
},
"required": [
"code",
"title"
],
"type": "object"
},
"type": "array"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 50,
"description": "Number of indicators to return per page. Default 50, max 500.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based offset for pagination. Default 0.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "who_list_indicators",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"indicators",
"totalCount",
"hasMore",
"pageInfo"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"hasMore": {
"description": "True when more indicators exist beyond the current page.",
"type": "boolean"
},
"indicators": {
"description": "Indicators for the requested page.",
"items": {
"additionalProperties": false,
"description": "An indicator entry with its code and name.",
"properties": {
"indicatorCode": {
"description": "Unique indicator code used in who_query_indicator_data, e.g. \"WHOSIS_000001\".",
"type": "string"
},
"indicatorName": {
"description": "Full indicator name, e.g. \"Life expectancy at birth (years)\".",
"type": "string"
}
},
"required": [
"indicatorCode",
"indicatorName"
],
"type": "object"
},
"type": "array"
},
"pageInfo": {
"description": "Human-readable page position, e.g. \"offset 0, showing 50 of 3059\". Use to construct the next offset.",
"type": "string"
},
"totalCount": {
"description": "Total number of indicators in the GHO catalog.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"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.",
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"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"
},
"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.",
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"indicator_code": {
"description": "Indicator code to query, e.g. \"WHOSIS_000001\". Use who_search_indicators to find codes.",
"minLength": 1,
"type": "string"
},
"limit": {
"default": 200,
"description": "Maximum number of data rows to return. Default 200, max 1000.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"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.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"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.",
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"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.",
"enum": [
"SEX_BTSX",
"SEX_FMLE",
"SEX_MLE"
],
"type": "string"
},
"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.",
"enum": [
"year_desc",
"year_asc"
],
"type": "string"
},
"year_from": {
"description": "Start year (inclusive) for the time range filter, e.g. 2015.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"year_to": {
"description": "End year (inclusive) for the time range filter, e.g. 2023.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"indicator_code"
],
"type": "object"
},
"name": "who_query_indicator_data",
"outputSchema": {
"$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"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Filters that were applied to the query.",
"properties": {
"dim1Value": {
"description": "dim1_value filter applied, if any.",
"type": "string"
},
"indicatorCode": {
"description": "Indicator code that was queried.",
"type": "string"
},
"ordering": {
"description": "Row ordering applied to the query, e.g. \"most recent first (year_desc)\".",
"type": "string"
},
"sex": {
"description": "Sex filter value applied, if any.",
"type": "string"
},
"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"
}
},
"required": [
"indicatorCode",
"ordering"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"hasMore": {
"description": "True when rows remain beyond this page. Pair with nextOffset to continue.",
"type": "boolean"
},
"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"
},
"offset": {
"description": "Zero-based row offset this page started at.",
"type": "number"
},
"pageInfo": {
"description": "Human-readable page position, e.g. \"offset 0, showing 200 of 12936\". Use to construct the next offset.",
"type": "string"
},
"rows": {
"description": "Data rows matching the query.",
"items": {
"additionalProperties": false,
"description": "A single data row from the GHO indicator dataset.",
"properties": {
"comments": {
"description": "Data source notes or comments attached to this row.",
"type": "string"
},
"dim1": {
"description": "First cross-cutting dimension value, e.g. \"SEX_BTSX\".",
"type": "string"
},
"dim1Type": {
"description": "First cross-cutting dimension type, e.g. \"SEX\".",
"type": "string"
},
"dim2": {
"description": "Second cross-cutting dimension value.",
"type": "string"
},
"dim2Type": {
"description": "Second cross-cutting dimension type, e.g. \"AGEGROUP\".",
"type": "string"
},
"displayValue": {
"description": "Formatted display string as provided by WHO, e.g. \"84.5 [84.5-84.5]\".",
"type": "string"
},
"high": {
"description": "Upper bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.",
"type": "number"
},
"indicatorCode": {
"description": "Indicator code for this row.",
"type": "string"
},
"low": {
"description": "Lower bound of the uncertainty interval. Present when include_uncertainty is true and the upstream provides it.",
"type": "number"
},
"numericValue": {
"description": "Machine-readable numeric value.",
"type": "number"
},
"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"
},
"spatialDim": {
"description": "Spatial dimension value, e.g. \"JPN\", \"AFR\", \"WB_HI\".",
"type": "string"
},
"spatialDimType": {
"description": "Spatial dimension type: COUNTRY, REGION, WORLDBANKINCOMEGROUP, GLOBAL, etc.",
"type": "string"
},
"year": {
"description": "Year of the data point. Absent when the upstream row has no TimeDim (time-independent entries).",
"type": "number"
}
},
"required": [
"indicatorCode"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Alias of totalRows for cross-tool consistency — total rows before the limit.",
"type": "number"
},
"totalRows": {
"description": "Total row count matching the query on the server (before the limit is applied).",
"type": "number"
},
"truncated": {
"description": "True when the result was capped at the requested limit.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Maximum number of indicators to return. Default 20, max 100.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Keyword to search in indicator names, e.g. \"life expectancy\" or \"tuberculosis\".",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "who_search_indicators",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"indicators",
"effectiveQuery",
"totalCount",
"offset",
"hasMore",
"pageInfo"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"effectiveQuery": {
"description": "Keyword used for the catalog search, as received by the server.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"hasMore": {
"description": "True when more matches remain beyond this page. Pair with nextOffset to continue.",
"type": "boolean"
},
"indicators": {
"description": "Matching indicators up to the requested limit.",
"items": {
"additionalProperties": false,
"description": "An indicator entry with its code and name.",
"properties": {
"indicatorCode": {
"description": "Unique indicator code used in who_query_indicator_data, e.g. \"WHOSIS_000001\".",
"type": "string"
},
"indicatorName": {
"description": "Full indicator name, e.g. \"Life expectancy at birth (years)\".",
"type": "string"
}
},
"required": [
"indicatorCode",
"indicatorName"
],
"type": "object"
},
"type": "array"
},
"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"
},
"offset": {
"description": "Zero-based offset this page started at.",
"type": "number"
},
"pageInfo": {
"description": "Human-readable page position, e.g. \"offset 0, showing 20 of 3003\". Use to construct the next offset.",
"type": "string"
},
"totalCount": {
"description": "Total indicators matching the query in the catalog, before the limit is applied.",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:611dff82f4a5b64852fec5b0b5093589e2fd7133e767d5b62d47929249bcff4e | sha256sum