uis-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| API_KEY | No | Optional bearer token for authenticating requests to the MCP endpoint. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| uis_search_indicatorsA | 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_list_geo_unitsA | 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_get_dataA | 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. |
| searchA | 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 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. |
| fetchA | Returns the full document for an id obtained from Companion of Behavior: read-only and idempotent — a live GET against the public source when the document needs it. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| uis-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-key-indicators | 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-provenance | Meaning of every provenance field returned with the data (source_url, data_vintage, retrieved_at, license, citation, derived) and how to cite the UIS correctly, including what CC BY-SA ShareAlike requires downstream. |
TDQS
Scored across 5 tools
The three uis_* tools are clearly separated by role: indicator catalogue lookup, geo-unit lookup, and statistical data retrieval. However, search and uis_search_indicators both search the UIS catalogue; the descriptions differentiate document search from indicator-code search, but the overlap could still cause a misrouted query.
Three tools follow a clear uis_<verb>_<noun> convention, but search and fetch break that pattern with bare generic names. The naming is still readable and intentional, but the mix of prefixed and unprefixed tools is inconsistent.
Five tools is well-scoped for a statistics server: indicator discovery, geo-unit discovery, data retrieval, and document search/fetch each serve a distinct purpose. No tool feels redundant, and the set is neither too thin nor overly heavy.
The core UIS data workflow is fully covered: find indicator codes, find geo codes, and fetch statistical records with filtering and footnotes. The search/fetch pair also supports document-level retrieval and citation, so agents can complete data queries without dead ends.