ILO Labour Statistics (ILOSTAT): unemployment, wages, informality
Server Details
Labour market data from the ILO (ILOSTAT) by country, year, sex and age, with provenance.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- SidneyBissoli/ilo-mcp-server
- GitHub Stars
- 2
- Server Listing
- ILO Statistics (ILOSTAT) MCP Server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 6 tools
The four ilo_* tools have clearly distinct roles: indicator discovery, dataflow structure, dimension-code lookup, and data retrieval. The generic search/fetch pair overlaps somewhat with ilo_search_indicators because both search the ILOSTAT catalogue, but the descriptions explicitly route document retrieval to search/fetch and statistical queries to ilo_*.
The four ilo_* tools follow a consistent snake_case verb_noun pattern. The unprefixed search and fetch tools break that convention, though they are required by the OpenAI Deep Research contract, leaving a readable but mixed naming scheme.
Six tools is well scoped for a read-only statistical data server. Each tool supports a distinct step in the workflow: discovering indicators, inspecting metadata or dimension codes, retrieving observations, and fetching catalogue documents.
The core read-only workflow is covered: search indicators, inspect dimensions and codes, then retrieve data with provenance. Minor gaps remain, such as no browse/list-all indicator operation, no batch query across multiple dataflows, and an unclear suggestion to use document search to resolve country names to dimension codes.
Available Tools
6 toolsfetchDeep Research DocumentARead-onlyIdempotentInspect
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 ILOSTAT labour statistics (≈1,200 SDMX dataflows: employment, unemployment, wages, working time, informality, SDG labour indicators) catalog. Only ids returned by search are valid; an unknown id returns an error.
The ilo_* tools remain the tools for data queries.
Behavior: read-only and idempotent — a live GET against the public source when the document needs it.
Inputs: id (required). Returns: id, url, text, title, +3 more
ilo_get_dataGet ILOSTAT dataARead-onlyIdempotentInspect
Statistical observations from one ILOSTAT dataflow, filtered by dimension codes (filters, e.g. {"REF_AREA": ["BRA","ARG"], "SEX": "SEX_T"}) and period (start_period/end_period, e.g. "2015"/"2024"). REF_AREA is required, maximum 30 areas per call — for broad panels, split areas into batches and/or paginate by period. Unfiltered dimensions return all their categories. Does not aggregate, convert or otherwise transform values (raw ILOSTAT data only): read each value with the unit and multiplier the ILO states in its row attributes (UNIT_MEASURE, UNIT_MULT — e.g. UNIT_MULT 3 = thousands). Read TIME_PERIOD with the FREQ column (annual, quarterly or monthly) and OBS_STATUS when present (break in series, estimated or provisional value). Values are the current release, dated by data_vintage (the dataflow LAST_UPDATE): the ILO revises published figures and re-estimates modelled series (_2 ids) at each release, past years included. Does not search indicators (use ilo_search_indicators).
Inputs: filters (required), dataflow (required), end_period, start_period, +2 more. Returns: rows, columns, dataflow, provenance, +2 more
ilo_get_indicator_metadataGet ILOSTAT indicator metadataARead-onlyIdempotentInspect
Structure of one ILOSTAT dataflow: dimensions (in SDMX key order), their codelists, the time dimension, the source's default selection and the data vintage (last update at the ILO). Use before ilo_get_data to know which filters exist. Does not return statistical values and does not list the codes themselves (use ilo_list_dimension_values).
Inputs: dataflow (required), provenance_mode. Returns: id, name, version, dimensions, +4 more
ilo_list_dimension_valuesList valid codes of a dimensionARead-onlyIdempotentInspect
Valid codes (id + label) of one dimension of an ILOSTAT dataflow — e.g. the country/area codes of REF_AREA (ISO 3166-1 alpha-3 such as BRA, plus X-codes for aggregates such as X01 World) or the categories of SEX (SEX_T/SEX_M/SEX_F) and AGE. Use search to resolve a name to a code (e.g. search "Brazil") instead of paging through hundreds of codes; codelists are shared across dataflows, so a code found here is valid wherever the same codelist is used. Use to build correct ilo_get_data filters. Does not return statistical values, does not say which codes actually have data for a given dataflow, and is not applicable to the time dimension (filter it via start_period/end_period in ilo_get_data).
Inputs: dataflow (required), dimension (required), limit, offset, +2 more. Returns: offset, values, showing, codelist, +7 more
ilo_search_indicatorsSearch ILOSTAT indicatorsARead-onlyIdempotentInspect
Search the ILOSTAT catalogue of ~1,200 indicator dataflows by keywords in the name or id (e.g. "unemployment rate sex age"). All terms must match (AND, case-insensitive), so start with 2–3 English words and drop terms if you get 0 results. Everyday and US wording is resolved to the ILO's own (labor→labour, wages/salary→earnings, informality→informal, gender→sex, productivity→output per worker); when that happens the response says so in vocabulary_notes. Results are ranked by ILO relevance weight, not by match count. Reading the id tells you the shape: suffix _RT = rate/ratio, NB = number (usually thousands); dataflows whose second token starts with 2 (e.g. DF_UNE_2EAP…) are ILO modelled estimates with full country/year coverage, the others are reported national data. Returns dataflow ids to use with ilo_get_data / ilo_get_indicator_metadata. Searches the local catalogue only — it does not return statistical values (use ilo_get_data), does not search dimension codes such as countries (use ilo_list_dimension_values) and does not cover non-ILO sources.
Inputs: query (required), limit, offset, provenance_mode. Returns: hint, offset, showing, has_more, +6 more
searchDeep Research SearchARead-onlyIdempotentInspect
Searches the ILOSTAT labour statistics (≈1,200 SDMX dataflows: employment, unemployment, wages, working time, informality, SDG labour indicators) 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 ilo_* 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.
Inputs: query (required). Returns: results, provenance, attribution
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
ILOSTAT (International Labour Organization statistics) MCP — global labour market data via the…
Labour market statistics for AI agents: unemployment, employment and wages for 150+ countries.
Search ILOSTAT labour indicators, query and compare series, build country profiles, run SQL.
Statistics from 28 agencies: FRED, Eurostat, ECB, World Bank, OECD. Cited values, computed answers.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables access to global labour statistics from ILOSTAT via the Pipeworx gateway.79 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables searching ILOSTAT labour indicators, querying and comparing series, building country profiles, and running read-only SQL over staged dataframes via MCP.360 npm1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides access to worldwide labor market data including unemployment, wages, and employment statistics from BLS (US) and Eurostat (EU). Offers tools for comparing countries and sectors, and retrieving occupation outlooks.MIT
- AlicenseAqualityAmaintenanceEnables querying Swiss labor market statistics (unemployment, job seekers, open positions, youth unemployment) from SECO and AMSTAT via opendata.swiss without requiring an API key.1231 PyPIMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.