ILO Labour Statistics (ILOSTAT) MCP
A provenance-first MCP server for ILOSTAT, the International Labour Organization statistical database. It provides access to 1,200+ indicator dataflows by country, year, sex, and age, including unemployment, wages, and informality metrics. Every response includes a deterministic provenance and attribution block with source, canonical URL, extraction date, and license, ensuring data traceability for AI agents.
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://ilo.sidneybissoli.com/mcpWhat its tools do
6 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
- What is the unemployment rate in Brazil, latest year, by sex?
- Compare youth unemployment across the Mercosur countries.
- Which ILOSTAT dataflows cover informal employment?
Source and maintenance
Community listingRegistry 1.7.0
- Maintenance checked
Protocol and capabilities
- Server
- ilo-mcp-server 1.7.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- 3 advertised
- Resource templates
- 0 advertised
- Prompts
- 3 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"prompts": {
"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
6 advertised
ilo_search_indicators — Search ILOSTAT indicators
Advertised read-only
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.
ilo_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 dataflow name and id (AND between terms)"
},
"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
}ilo_search_indicators output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"total_matches",
"showing",
"offset",
"indicators",
"has_more",
"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": "Dataflows returned in this page"
},
"has_more": {
"type": "boolean",
"description": "True when more matches remain after this page"
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"version"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"version": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching dataflows, highest ILO relevance weight first; use id with ilo_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": "Portfolio provenance block. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license; detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to ILOSTAT, 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 ILOSTAT (catalogue or cached answer). Optional keys (field_sources, notices, derived, derivation_note, revision) appear only when there is something to say"
},
"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": "Dataflows matching all terms, across every page"
},
"vocabulary_notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Translations applied from everyday or US wording to ILO terms (e.g. labor → labour)"
}
},
"additionalProperties": {}
}ilo_search_indicators annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}ilo_get_indicator_metadata — Get ILOSTAT indicator metadata
Advertised read-onlyOpen-world
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).
ilo_get_indicator_metadata input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dataflow"
],
"properties": {
"dataflow": {
"type": "string",
"minLength": 1,
"description": "Dataflow id from ilo_search_indicators (e.g. \"DF_UNE_DEAP_SEX_AGE_RT\")"
},
"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
}ilo_get_indicator_metadata output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"version",
"name",
"data_vintage",
"dimensions",
"time_dimension",
"provenance",
"attribution"
],
"properties": {
"id": {
"type": "string",
"description": "Dataflow id"
},
"name": {
"type": [
"string",
"null"
],
"description": "Dataflow name; null when the ILO gives none"
},
"version": {
"type": "string",
"description": "Dataflow version at the ILO"
},
"dimensions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"codelist"
],
"properties": {
"id": {
"type": "string"
},
"codelist": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"description": "Dimensions in SDMX key order, each with its codelist id; filter ilo_get_data by these ids"
},
"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": "Portfolio provenance block. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license; detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to ILOSTAT, 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 ILOSTAT (catalogue or cached answer). Optional keys (field_sources, notices, derived, derivation_note, revision) appear only when there is something to say"
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs the figures came from (the provenance source_url of each block), for linking the citation"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Last update of the dataflow at the ILO (LAST_UPDATE, yyyy-MM-dd); null when absent"
},
"time_dimension": {
"type": [
"string",
"null"
],
"description": "Id of the time dimension (filtered via start_period/end_period); null when absent"
}
},
"additionalProperties": {}
}ilo_get_indicator_metadata annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ilo_list_dimension_values — List valid codes of a dimension
Advertised read-onlyOpen-world
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).
ilo_list_dimension_values input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dataflow",
"dimension"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum codes returned (default 200)"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Codes to skip, for pagination (default 0)"
},
"search": {
"type": "string",
"minLength": 1,
"description": "Case-insensitive filter on code id or label"
},
"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\")"
},
"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
}ilo_list_dimension_values output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dataflow",
"dimension",
"codelist",
"total_codes",
"showing",
"offset",
"values",
"has_more",
"provenance",
"attribution"
],
"properties": {
"offset": {
"type": "number",
"description": "Codes skipped before this page"
},
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"description": "Valid codes: id is the value for ilo_get_data filters, name is the ILO label"
},
"showing": {
"type": "number",
"description": "Codes returned in this page"
},
"codelist": {
"type": "string",
"description": "Id of the codelist that enumerates the dimension (shared across dataflows)"
},
"dataflow": {
"type": "string",
"description": "Dataflow id the dimension belongs to"
},
"has_more": {
"type": "boolean",
"description": "True when more codes remain after this page"
},
"dimension": {
"type": "string",
"description": "Dimension id"
},
"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": "Portfolio provenance block. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license; detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to ILOSTAT, 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 ILOSTAT (catalogue or cached answer). Optional keys (field_sources, notices, derived, derivation_note, revision) appear only when there is something to say"
},
"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_codes": {
"type": "number",
"description": "Codes matching the search filter (or all codes), across every page"
}
},
"additionalProperties": {}
}ilo_list_dimension_values annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ilo_get_data — Get ILOSTAT data
Advertised read-onlyOpen-world
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).
ilo_get_data input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dataflow",
"filters"
],
"properties": {
"filters": {
"type": "object",
"required": [
"REF_AREA"
],
"properties": {
"REF_AREA": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
],
"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)."
}
},
"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.",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
]
}
},
"dataflow": {
"type": "string",
"minLength": 1,
"description": "Dataflow id from ilo_search_indicators (e.g. \"DF_UNE_DEAP_SEX_AGE_RT\")"
},
"end_period": {
"type": "string",
"minLength": 1,
"description": "Last period, e.g. \"2024\""
},
"start_period": {
"type": "string",
"minLength": 1,
"description": "First period, 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)"
},
"last_n_observations": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Alternative to periods: only the latest N observations per series"
}
},
"additionalProperties": false
}ilo_get_data output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dataflow",
"columns",
"rows_count",
"rows",
"provenance",
"attribution"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Raw ILOSTAT observations: one code per dimension, value (untransformed; read with UNIT_MULT) and, when present, attributes such as OBS_STATUS, UNIT_MEASURE and UNIT_MULT"
},
"columns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Dimension ids of each row, in SDMX order, followed by value"
},
"dataflow": {
"type": "object",
"required": [
"id",
"version",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Dataflow id"
},
"name": {
"type": [
"string",
"null"
],
"description": "Dataflow name; null when the ILO gives none"
},
"version": {
"type": "string",
"description": "Dataflow version at the ILO"
}
},
"description": "The dataflow the observations come from",
"additionalProperties": false
},
"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": "Portfolio provenance block. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license; detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to ILOSTAT, 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 ILOSTAT (catalogue or cached answer). Optional keys (field_sources, notices, derived, derivation_note, revision) appear only when there is something to say"
},
"rows_count": {
"type": "number",
"description": "Number of observations 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": {}
}ilo_get_data annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search — Deep Research Search
Advertised read-onlyOpen-world
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.
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": "Portfolio provenance block. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license; detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to ILOSTAT, 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 ILOSTAT (catalogue or cached answer). Optional keys (field_sources, notices, derived, derivation_note, revision) appear only when there is something to say"
},
"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 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.
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": "Portfolio provenance block. concise (default): source, source_url, data_vintage, retrieved_at, retrieval, citation, license; detailed: the full canonical block (dataset, dimension_key, notices, served_from_cache, ...). retrieval is the origin diagnostic of this call — requests made to ILOSTAT, 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 ILOSTAT (catalogue or cached answer). Optional keys (field_sources, notices, derived, derivation_note, revision) appear only when there is something to say"
},
"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
3 advertised
ilo_country_labour_profile — Country labour-market profile
Step-by-step workflow that assembles a labour-market profile of one country from ILOSTAT (unemployment, participation, employment ratio, informality, NEET, earnings, hours) with ILO citations.
- country
- Country name or ISO3 code, e.g. "Brazil" or "BRA" (required)
- start_period
- First year, e.g. "2015" (optional)
- end_period
- Last year, e.g. "2024" (optional)
ilo_compare_countries — Compare countries on an indicator
Workflow that compares several countries (or regional aggregates) on one ILOSTAT indicator in a single data call, flagging modelled estimates versus reported data.
- countries
- Comma-separated country names or ISO3 codes, e.g. "BRA, ARG, CHL" (required)
- indicator
- Indicator in plain words, e.g. "youth unemployment rate" (required)
- start_period
- First year, e.g. "2015" (optional)
- end_period
- Last year, e.g. "2024" (optional)
ilo_indicator_trend — Indicator trend for a country
Workflow that retrieves the time series of one ILOSTAT indicator for one country and describes the trend (first/last, peak/trough, breaks in series) with citations.
- indicator
- Indicator in plain words, e.g. "labour force participation rate" (required)
- country
- Country name or ISO3 code, e.g. "India" or "IND" (required)
- start_period
- First year, e.g. "2015" (optional)
- end_period
- Last year, e.g. "2024" (optional)
Resources
3 advertised
ilostat-guide — ILOSTAT query guide
How to query ILOSTAT with this server: tool workflow, stable code conventions (REF_AREA ISO3 and X-aggregates, SEX, AGE, FREQ, dataflow id suffixes), limits and reporting rules. Read once per session to save discovery calls.
ilostat-guide URI
ilostat://guideilostat-key-dataflows — Key ILOSTAT dataflows by topic
Verified dataflow ids for the most common indicators (unemployment, employment, participation, wages, working time, informality, NEET, SDG 8, productivity) — usable directly in ilo_get_data without searching.
ilostat-key-dataflows URI
ilostat://reference/key-dataflowsilostat-provenance — Provenance and citation contract
Meaning of every provenance field returned with the data (source_url, data_vintage, retrieved_at, retrieval, notices, license, citation) and how to cite the ILO correctly.
ilostat-provenance URI
ilostat://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-06: 1 of 1 checks answered
- 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
- 445 ms
- 95th percentile latency
- 445 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 445 ms · metadata changed · 6 tool(s), 3 resource(s), 0 resource template(s), 3 prompt(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 ilo-labour-statistics-ilostat-mcp-sidneybissoli https://ilo.sidneybissoli.com/mcpCodex
Codex configuration
codex mcp add ilo-labour-statistics-ilostat-mcp-sidneybissoli --url https://ilo.sidneybissoli.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"ilo-labour-statistics-ilostat-mcp-sidneybissoli": {
"url": "https://ilo.sidneybissoli.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"ilo-labour-statistics-ilostat-mcp-sidneybissoli": {
"type": "streamableHttp",
"url": "https://ilo.sidneybissoli.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"ilo-labour-statistics-ilostat-mcp-sidneybissoli": {
"type": "http",
"url": "https://ilo.sidneybissoli.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http ilo-labour-statistics-ilostat-mcp-sidneybissoli https://ilo.sidneybissoli.com/mcpClaude Desktop
Claude Desktop configuration
https://ilo.sidneybissoli.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"ilo-labour-statistics-ilostat-mcp-sidneybissoli": {
"serverUrl": "https://ilo.sidneybissoli.com/mcp"
}
}
}Let your agent find its tools
Find servers like ILO Labour Statistics (ILOSTAT) MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.