UNESCO UIS Education Statistics MCP
A remote MCP server providing access to UNESCO Institute for Statistics data on education, science, culture, and communication. It offers approximately 5,000 indicators with fixed data releases and full provenance blocks in every response, allowing agents to query specific statistics without installing local software.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://uis.sidneybissoli.com/mcpWhat its tools do
5 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Query education statistics like out-of-school rates by country
- Compare R&D spending as a share of GDP across regions
- Find UIS indicators covering adult literacy
- Retrieve provenance-tracked data samples for research
Source and maintenance
Community listingRegistry 1.9.0
- Maintenance checked
Protocol and capabilities
- Server
- uis-mcp-server 1.9.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 5 advertised
- Resources
- 3 advertised
- Resource templates
- 0 advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
5 advertised
uis_search_indicators — Search UNESCO UIS indicators
Advertised read-only
Search the UNESCO Institute for Statistics catalogue of ~5,000 indicators — education, science/R&D, culture and communication — by keywords in the name or code, optionally filtered by theme. All terms must match (AND, case-insensitive), so start with 2–3 words and drop terms if you get 0 results. Everyday and US wording is resolved to the UIS's own (enrollment→enrolment, spending→expenditure, preschool→pre-primary, university→tertiary, graduation→completion, girls/boys→female/male); when that happens the response says so in vocabulary_notes. Returns indicator codes to use with uis_get_data, plus each indicator's data availability (years, record count). Searches the catalogue only — it does not return statistical values (use uis_get_data); ILO labour statistics live in the sibling ILOSTAT MCP server.
uis_search_indicators input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum results (default 20)"
},
"query": {
"type": "string",
"minLength": 1,
"description": "Keywords, matched against indicator name and code, AND between terms (e.g. \"literacy rate youth\")"
},
"theme": {
"enum": [
"EDUCATION",
"SCIENCE_TECHNOLOGY_INNOVATION",
"CULTURE",
"DEMOGRAPHIC_SOCIOECONOMIC"
],
"type": "string",
"description": "Restrict to one UIS theme"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Results to skip, for pagination (default 0)"
},
"provenance_mode": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"description": "Provenance verbosity: 'concise' (default — source, url, vintage, retrieval date, citation, license) or 'detailed' (full canonical block with dataset, dimension key and notices)"
}
},
"additionalProperties": false
}uis_search_indicators output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"total_matches",
"showing",
"offset",
"has_more",
"indicators",
"provenance",
"attribution"
],
"properties": {
"hint": {
"type": "string",
"description": "What to do next: how to narrow or page, or why nothing matched"
},
"offset": {
"type": "number",
"description": "Results skipped before this page"
},
"showing": {
"type": "number",
"description": "Indicators returned in this page"
},
"has_more": {
"type": "boolean",
"description": "True when more matches remain after this page"
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"theme",
"last_data_update",
"records",
"years",
"geo_types"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"theme": {
"type": "string"
},
"years": {
"type": [
"string",
"null"
]
},
"records": {
"type": [
"number",
"null"
]
},
"geo_types": {
"type": [
"string",
"null"
]
},
"last_data_update": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"description": "Matching indicators, largest record count first; use code with uis_get_data"
},
"provenance": {
"anyOf": [
{
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string"
},
"derived": {
"type": "boolean"
},
"license": {
"type": [
"string",
"null"
]
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"citation": {
"type": "string"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"minItems": 1
},
"derivation_note": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contract_version",
"source",
"dataset",
"dimension_key",
"data_vintage",
"retrieved_at",
"source_url",
"api_version",
"license",
"citation",
"notices",
"derived",
"derivation_note",
"served_from_cache",
"retrieval",
"field_sources"
],
"properties": {
"source": {
"type": "object",
"required": [
"name",
"agency",
"database",
"endpoint"
],
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"dataset": {
"type": "object",
"required": [
"id",
"version",
"name"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"derived": {
"type": "boolean"
},
"license": {
"type": "object",
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"citation": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"contract_version": {
"enum": [
"1.1",
"1.2",
"1.3"
],
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
],
"description": "Provenance block of the portfolio. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license, plus optional keys only when there is something to say (field_sources, notices, derived/derivation_note, revision); detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to the UIS Data API, attempts including retries, anomalies overcome (timeout, network, rate_limited, http_5xx, http_4xx, malformed_body) and unstable (true when anything had to be retried: treat the figures as obtained with difficulty); null when nothing was fetched from the UIS (catalogue or cached answer)"
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs the figures came from (the provenance source_url of each block), for linking the citation"
},
"next_offset": {
"type": "number",
"description": "Offset for the next page; present only when has_more is true"
},
"total_matches": {
"type": "number",
"description": "Indicators matching all terms, across every page"
},
"vocabulary_notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Translations applied from everyday or US wording to UIS terms (e.g. enrollment → enrolment)"
}
},
"additionalProperties": {}
}uis_search_indicators annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}uis_list_geo_units — List UNESCO UIS geo units
Advertised read-only
Valid geographic codes for uis_get_data: 462 geo units — countries (NATIONAL, ISO alpha-3 codes like BRA) and regional aggregates (REGIONAL). Filter by name/code and type. Does not return statistical values; these codes apply only to uis_get_data, not to other statistical servers.
uis_list_geo_units input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"NATIONAL",
"REGIONAL"
],
"type": "string",
"description": "Only countries (NATIONAL) or only regional aggregates"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum results (default 100)"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Results to skip, for pagination (default 0)"
},
"search": {
"type": "string",
"minLength": 1,
"description": "Case-insensitive filter on name, or exact code (e.g. \"BRA\")"
},
"provenance_mode": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"description": "Provenance verbosity: 'concise' (default — source, url, vintage, retrieval date, citation, license) or 'detailed' (full canonical block with dataset, dimension key and notices)"
}
},
"additionalProperties": false
}uis_list_geo_units output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"total_matches",
"showing",
"offset",
"has_more",
"geo_units",
"provenance",
"attribution"
],
"properties": {
"offset": {
"type": "number",
"description": "Results skipped before this page"
},
"showing": {
"type": "number",
"description": "Geo units returned in this page"
},
"has_more": {
"type": "boolean",
"description": "True when more matches remain after this page"
},
"geo_units": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"type"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Geo units: id is the code for uis_get_data, type is NATIONAL or REGIONAL"
},
"provenance": {
"anyOf": [
{
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string"
},
"derived": {
"type": "boolean"
},
"license": {
"type": [
"string",
"null"
]
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"citation": {
"type": "string"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"minItems": 1
},
"derivation_note": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contract_version",
"source",
"dataset",
"dimension_key",
"data_vintage",
"retrieved_at",
"source_url",
"api_version",
"license",
"citation",
"notices",
"derived",
"derivation_note",
"served_from_cache",
"retrieval",
"field_sources"
],
"properties": {
"source": {
"type": "object",
"required": [
"name",
"agency",
"database",
"endpoint"
],
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"dataset": {
"type": "object",
"required": [
"id",
"version",
"name"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"derived": {
"type": "boolean"
},
"license": {
"type": "object",
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"citation": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"contract_version": {
"enum": [
"1.1",
"1.2",
"1.3"
],
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
],
"description": "Provenance block of the portfolio. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license, plus optional keys only when there is something to say (field_sources, notices, derived/derivation_note, revision); detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to the UIS Data API, attempts including retries, anomalies overcome (timeout, network, rate_limited, http_5xx, http_4xx, malformed_body) and unstable (true when anything had to be retried: treat the figures as obtained with difficulty); null when nothing was fetched from the UIS (catalogue or cached answer)"
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs the figures came from (the provenance source_url of each block), for linking the citation"
},
"next_offset": {
"type": "number",
"description": "Offset for the next page; present only when has_more is true"
},
"total_matches": {
"type": "number",
"description": "Geo units matching the filters, across every page"
}
},
"additionalProperties": {}
}uis_list_geo_units annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}uis_get_data — Get UNESCO UIS data
Advertised read-onlyOpen-world
Statistical records from the UNESCO Institute for Statistics Data API, filtered by indicator codes (from uis_search_indicators, up to 25), geo unit codes (from uis_list_geo_units) and year range. Set include_footnotes for per-record source notes. Returns raw UIS records only — it does not aggregate, convert or otherwise transform values; ILO labour statistics live in the sibling ILOSTAT MCP server. Broad queries are rejected with the record count — narrow by geo unit or years. A code that does not exist is an error carrying the UIS API's own wording, never an empty result: zero rows means the codes are real and the selection has no data, and the hint then relays what the UIS reported (including the indicator's available year range). When only SOME of the requested codes exist, the matching rows are returned with `warnings` naming the rest. Values are those of the release named in data_vintage: a new UIS release can revise past years. On a record, `magnitude` says what the value shown means (e.g. NA = not applicable, shown as 0; SUPP = withheld, blank) and `qualifier` says how it was obtained (national or UIS estimate); the provenance notices count them in plain words; both are null when the UIS publishes no flag. The UIS publishes no unit field: the unit usually closes the indicator name in parentheses ("(%)", "(number)", "(years)"), but not always — a parenthesis can also name a parity index (GPIA), an estimate type or an education level, and some names have none.
uis_get_data input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"indicators"
],
"properties": {
"end_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Last year, e.g. 2024"
},
"geo_units": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Geo unit codes from uis_list_geo_units (e.g. [\"BRA\",\"ARG\"]); omit for all"
},
"indicators": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 25,
"minItems": 1,
"description": "Indicator codes from uis_search_indicators (e.g. [\"CR.1\"])"
},
"start_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "First year, e.g. 2015"
},
"provenance_mode": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"description": "Provenance verbosity: 'concise' (default — source, url, vintage, retrieval date, citation, license) or 'detailed' (full canonical block with dataset, dimension key and notices)"
},
"include_footnotes": {
"type": "boolean",
"description": "Include per-record footnotes (source notes); default false"
}
},
"additionalProperties": false
}uis_get_data output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"columns",
"rows_count",
"rows",
"provenance",
"attribution"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"indicator",
"geo_unit",
"year",
"value",
"magnitude",
"qualifier"
],
"properties": {
"year": {
"type": "number"
},
"value": {
"type": [
"number",
"null"
]
},
"geo_unit": {
"type": "string"
},
"indicator": {
"type": "string"
},
"magnitude": {
"type": [
"string",
"null"
]
},
"qualifier": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"description": "Raw UIS records, one per indicator, geo unit and year; value is untransformed"
},
"columns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Core fields of each row, in reading order"
},
"provenance": {
"anyOf": [
{
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string"
},
"derived": {
"type": "boolean"
},
"license": {
"type": [
"string",
"null"
]
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"citation": {
"type": "string"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"minItems": 1
},
"derivation_note": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contract_version",
"source",
"dataset",
"dimension_key",
"data_vintage",
"retrieved_at",
"source_url",
"api_version",
"license",
"citation",
"notices",
"derived",
"derivation_note",
"served_from_cache",
"retrieval",
"field_sources"
],
"properties": {
"source": {
"type": "object",
"required": [
"name",
"agency",
"database",
"endpoint"
],
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"dataset": {
"type": "object",
"required": [
"id",
"version",
"name"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"derived": {
"type": "boolean"
},
"license": {
"type": "object",
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"citation": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"contract_version": {
"enum": [
"1.1",
"1.2",
"1.3"
],
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
],
"description": "Provenance block of the portfolio. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license, plus optional keys only when there is something to say (field_sources, notices, derived/derivation_note, revision); detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to the UIS Data API, attempts including retries, anomalies overcome (timeout, network, rate_limited, http_5xx, http_4xx, malformed_body) and unstable (true when anything had to be retried: treat the figures as obtained with difficulty); null when nothing was fetched from the UIS (catalogue or cached answer)"
},
"rows_count": {
"type": "number",
"description": "Number of records returned"
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs the figures came from (the provenance source_url of each block), for linking the citation"
}
},
"additionalProperties": {}
}uis_get_data annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search — Deep Research Search
Advertised read-onlyOpen-world
Searches the UNESCO UIS statistics (≈5,000 indicators: education — enrolment, completion, literacy, teachers, spending, SDG 4 —, science/R&D (SDG 9.5), culture (SDG 11.4) and demographic context) catalog and returns up to 10 matching documents as { id, title, url }, ordered by relevance (an empty list means nothing matched). This tool exists for the OpenAI Deep Research contract: ChatGPT deep research, company knowledge and research workflows over the Responses API require exactly the tools `search` and `fetch`. Pass one of the returned ids to `fetch` to read the document. For direct questions and for data (values, series, rankings) prefer the `uis_*` tools, which return the actual data with provenance — this is a catalog index, not a data query. Query: natural language or keywords, Portuguese or English; accents and case are ignored. Behavior: read-only and idempotent — the catalog comes from the public source and is cached in memory.
search input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search terms, natural language or keywords (accents and case are ignored)"
}
},
"additionalProperties": false
}search output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"results",
"provenance",
"attribution"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"url"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier of the document on this server; what `fetch` takes"
},
"url": {
"type": "string",
"description": "Canonical public URL of the document — ChatGPT's citation depends on it"
},
"title": {
"type": "string",
"description": "Human-readable title of the document"
}
},
"additionalProperties": false
},
"description": "Matching documents, in relevance order"
},
"provenance": {
"anyOf": [
{
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string"
},
"derived": {
"type": "boolean"
},
"license": {
"type": [
"string",
"null"
]
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"citation": {
"type": "string"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"minItems": 1
},
"derivation_note": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contract_version",
"source",
"dataset",
"dimension_key",
"data_vintage",
"retrieved_at",
"source_url",
"api_version",
"license",
"citation",
"notices",
"derived",
"derivation_note",
"served_from_cache",
"retrieval",
"field_sources"
],
"properties": {
"source": {
"type": "object",
"required": [
"name",
"agency",
"database",
"endpoint"
],
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"dataset": {
"type": "object",
"required": [
"id",
"version",
"name"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"derived": {
"type": "boolean"
},
"license": {
"type": "object",
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"citation": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"contract_version": {
"enum": [
"1.1",
"1.2",
"1.3"
],
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
],
"description": "Provenance block of the portfolio. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license, plus optional keys only when there is something to say (field_sources, notices, derived/derivation_note, revision); detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to the UIS Data API, attempts including retries, anomalies overcome (timeout, network, rate_limited, http_5xx, http_4xx, malformed_body) and unstable (true when anything had to be retried: treat the figures as obtained with difficulty); null when nothing was fetched from the UIS (catalogue or cached answer)"
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs the figures came from (the provenance source_url of each block), for linking the citation"
}
},
"additionalProperties": false
}search annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}fetch — Deep Research Document
Advertised read-onlyOpen-world
Returns the full document for an id obtained from `search`, as { id, title, text, url, metadata }: `text` is the readable content (Markdown) and `url` the canonical public page to cite. Companion of `search` in the OpenAI Deep Research contract, over the UNESCO UIS statistics (≈5,000 indicators: education — enrolment, completion, literacy, teachers, spending, SDG 4 —, science/R&D (SDG 9.5), culture (SDG 11.4) and demographic context) catalog. Only ids returned by `search` are valid; an unknown id returns an error. The `uis_*` tools remain the tools for data queries. Behavior: read-only and idempotent — a live GET against the public source when the document needs it.
fetch input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of a document returned by `search`"
}
},
"additionalProperties": false
}fetch output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"title",
"text",
"url",
"provenance",
"attribution"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier of the document on this server; what `fetch` takes"
},
"url": {
"type": "string",
"description": "Canonical public URL of the document — ChatGPT's citation depends on it"
},
"text": {
"type": "string",
"description": "Full readable content of the document (Markdown)"
},
"title": {
"type": "string",
"description": "Human-readable title of the document"
},
"metadata": {
"type": "object",
"description": "Additional key/value pairs about the document (kind, source, period…)",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"provenance": {
"anyOf": [
{
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string"
},
"derived": {
"type": "boolean"
},
"license": {
"type": [
"string",
"null"
]
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"citation": {
"type": "string"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"minItems": 1
},
"derivation_note": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contract_version",
"source",
"dataset",
"dimension_key",
"data_vintage",
"retrieved_at",
"source_url",
"api_version",
"license",
"citation",
"notices",
"derived",
"derivation_note",
"served_from_cache",
"retrieval",
"field_sources"
],
"properties": {
"source": {
"type": "object",
"required": [
"name",
"agency",
"database",
"endpoint"
],
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"dataset": {
"type": "object",
"required": [
"id",
"version",
"name"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"derived": {
"type": "boolean"
},
"license": {
"type": "object",
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"citation": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"unstable": {
"type": "boolean"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"contract_version": {
"enum": [
"1.1",
"1.2",
"1.3"
],
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
],
"description": "Provenance block of the portfolio. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license, plus optional keys only when there is something to say (field_sources, notices, derived/derivation_note, revision); detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to the UIS Data API, attempts including retries, anomalies overcome (timeout, network, rate_limited, http_5xx, http_4xx, malformed_body) and unstable (true when anything had to be retried: treat the figures as obtained with difficulty); null when nothing was fetched from the UIS (catalogue or cached answer)"
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs the figures came from (the provenance source_url of each block), for linking the citation"
}
},
"additionalProperties": false
}fetch annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
3 advertised
uis-guide — UIS query guide
How to query the UNESCO UIS with this server: tool workflow, code conventions (indicator code families and suffixes, ISO alpha-3 geo units, themes), limits and reporting rules. Read once per session to save discovery calls.
uis-guide URI
uis://guideuis-key-indicators — Key UIS indicators by topic
Verified indicator codes for the most common questions — completion, out-of-school, enrolment, literacy, learning proficiency, education spending, R&D (SDG 9.5), heritage spending (SDG 11.4) and population — usable directly in uis_get_data.
uis-key-indicators URI
uis://reference/key-indicatorsuis-provenance — Provenance and citation contract
Meaning of every provenance field returned with the data (source_url, data_vintage, retrieved_at, retrieval, license, citation, derived) and how to cite the UIS correctly, including what CC BY-SA ShareAlike requires downstream.
uis-provenance URI
uis://reference/provenance90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 858 ms
- 95th percentile latency
- 858 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 858 ms · metadata changed · 5 tool(s), 3 resource(s), 0 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http unesco-uis-education-statistics-mcp-sidneybissoli https://uis.sidneybissoli.com/mcpCodex
Codex configuration
codex mcp add unesco-uis-education-statistics-mcp-sidneybissoli --url https://uis.sidneybissoli.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"unesco-uis-education-statistics-mcp-sidneybissoli": {
"url": "https://uis.sidneybissoli.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"unesco-uis-education-statistics-mcp-sidneybissoli": {
"type": "streamableHttp",
"url": "https://uis.sidneybissoli.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"unesco-uis-education-statistics-mcp-sidneybissoli": {
"type": "http",
"url": "https://uis.sidneybissoli.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http unesco-uis-education-statistics-mcp-sidneybissoli https://uis.sidneybissoli.com/mcpClaude Desktop
Claude Desktop configuration
https://uis.sidneybissoli.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"unesco-uis-education-statistics-mcp-sidneybissoli": {
"serverUrl": "https://uis.sidneybissoli.com/mcp"
}
}
}Let your agent find its tools
Find servers like UNESCO UIS Education Statistics MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.