ILO Labour Statistics (ILOSTAT): unemployment, wages, informality
Labour market data from the ILO (ILOSTAT) by country, year, sex and age, with provenance.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ilo-mcp-server": {
"command": "npx",
"args": [
"ilo-mcp-server"
]
}
}
}Paquetes ejecutables
1.1.0stdioPuntos de conexión remotos
https://ilo.sidneybissoli.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (6)
🟢ilo_search_indicators(query, limit, offset, provenance_mode)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Keywords, matched against dataflow name and id (AND between terms)"
},
"limit": {
"description": "Maximum results (default 20)",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Results to skip, for pagination (default 0)",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"provenance_mode": {
"description": "Provenance verbosity: 'concise' (default — source, url, vintage, retrieval date, citation, license) or 'detailed' (full canonical block with dataset, dimension key and notices)",
"type": "string",
"enum": [
"concise",
"detailed"
]
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"total_matches": {
"type": "number"
},
"showing": {
"type": "number"
},
"offset": {
"type": "number"
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"id",
"name",
"version"
],
"additionalProperties": false
}
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"type": "number"
},
"vocabulary_notes": {
"type": "array",
"items": {
"type": "string"
}
},
"hint": {
"type": "string"
},
"provenance": {},
"attribution": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"total_matches",
"showing",
"offset",
"indicators",
"has_more",
"provenance",
"attribution"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢ilo_get_indicator_metadata(dataflow, provenance_mode)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"dataflow": {
"type": "string",
"minLength": 1,
"description": "Dataflow id from ilo_search_indicators (e.g. \"DF_UNE_DEAP_SEX_AGE_RT\")"
},
"provenance_mode": {
"description": "Provenance verbosity: 'concise' (default — source, url, vintage, retrieval date, citation, license) or 'detailed' (full canonical block with dataset, dimension key and notices)",
"type": "string",
"enum": [
"concise",
"detailed"
]
}
},
"required": [
"dataflow"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"version": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dimensions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"codelist": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"codelist"
],
"additionalProperties": false
}
},
"time_dimension": {
"type": [
"string",
"null"
]
},
"provenance": {},
"attribution": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"version",
"name",
"data_vintage",
"dimensions",
"time_dimension",
"provenance",
"attribution"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢ilo_list_dimension_values(dataflow, dimension, search, limit, offset, ...)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"dataflow": {
"type": "string",
"minLength": 1,
"description": "Dataflow id the dimension belongs to"
},
"dimension": {
"type": "string",
"minLength": 1,
"description": "Dimension id from ilo_get_indicator_metadata (e.g. \"REF_AREA\", \"SEX\")"
},
"search": {
"description": "Case-insensitive filter on code id or label",
"type": "string",
"minLength": 1
},
"limit": {
"description": "Maximum codes returned (default 200)",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Codes to skip, for pagination (default 0)",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"provenance_mode": {
"description": "Provenance verbosity: 'concise' (default — source, url, vintage, retrieval date, citation, license) or 'detailed' (full canonical block with dataset, dimension key and notices)",
"type": "string",
"enum": [
"concise",
"detailed"
]
}
},
"required": [
"dataflow",
"dimension"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"dataflow": {
"type": "string"
},
"dimension": {
"type": "string"
},
"codelist": {
"type": "string"
},
"total_codes": {
"type": "number"
},
"showing": {
"type": "number"
},
"offset": {
"type": "number"
},
"values": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"type": "number"
},
"provenance": {},
"attribution": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"dataflow",
"dimension",
"codelist",
"total_codes",
"showing",
"offset",
"values",
"has_more",
"provenance",
"attribution"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢ilo_get_data(dataflow, filters, start_period, end_period, last_n_observations, ...)
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), and does not search indicators (use ilo_search_indicators).
Esquema de entrada
{
"type": "object",
"properties": {
"dataflow": {
"type": "string",
"minLength": 1,
"description": "Dataflow id from ilo_search_indicators (e.g. \"DF_UNE_DEAP_SEX_AGE_RT\")"
},
"filters": {
"type": "object",
"properties": {
"REF_AREA": {
"anyOf": [
{
"type": "string"
},
{
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "Area codes — REQUIRED, at most 30 per call (e.g. [\"BRA\",\"ARG\"]). Without them the ILO gateway times out (HTTP 504). Discover codes with ilo_list_dimension_values (dimension REF_AREA)."
}
},
"required": [
"REF_AREA"
],
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
}
]
},
"description": "Dimension id → code or list of codes (from ilo_list_dimension_values). REF_AREA is required (up to 30 area codes); any other dimension is optional and, left out, returns all of its categories."
},
"start_period": {
"description": "First period, e.g. \"2015\"",
"type": "string",
"minLength": 1
},
"end_period": {
"description": "Last period, e.g. \"2024\"",
"type": "string",
"minLength": 1
},
"last_n_observations": {
"description": "Alternative to periods: only the latest N observations per series",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"provenance_mode": {
"description": "Provenance verbosity: 'concise' (default — source, url, vintage, retrieval date, citation, license) or 'detailed' (full canonical block with dataset, dimension key and notices)",
"type": "string",
"enum": [
"concise",
"detailed"
]
}
},
"required": [
"dataflow",
"filters"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"dataflow": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"version": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"additionalProperties": false
},
"columns": {
"type": "array",
"items": {
"type": "string"
}
},
"rows_count": {
"type": "number"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"provenance": {},
"attribution": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"dataflow",
"columns",
"rows_count",
"rows",
"provenance",
"attribution"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢search(query)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search terms, natural language or keywords (accents and case are ignored)"
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier of the document on this server; what `fetch` takes"
},
"title": {
"type": "string",
"description": "Human-readable title of the document"
},
"url": {
"type": "string",
"description": "Canonical public URL of the document — ChatGPT's citation depends on it"
}
},
"required": [
"id",
"title",
"url"
],
"additionalProperties": false
},
"description": "Matching documents, in relevance order"
},
"provenance": {},
"attribution": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"results",
"provenance",
"attribution"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢fetch(id)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Identifier of a document returned by `search`"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier of the document on this server; what `fetch` takes"
},
"title": {
"type": "string",
"description": "Human-readable title of the document"
},
"text": {
"type": "string",
"description": "Full readable content of the document (Markdown)"
},
"url": {
"type": "string",
"description": "Canonical public URL of the document — ChatGPT's citation depends on it"
},
"metadata": {
"description": "Additional key/value pairs about the document (kind, source, period…)",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"provenance": {},
"attribution": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"title",
"text",
"url",
"provenance",
"attribution"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Comunidad
Evidencia