ILO Labour Statistics (ILOSTAT): unemployment, wages, informality
Labour market data from the ILO (ILOSTAT) by country, year, sex and age, with provenance.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~9,513Tokens (Tool-Definitionen)
~16.7 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (7.43% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"ilo-mcp-server": {
"command": "npx",
"args": [
"ilo-mcp-server"
]
}
}
}Ausführbare Pakete
npmilo-mcp-server
1.1.0stdioRemote-Endpunkte
https://ilo.sidneybissoli.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (6)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.
Eingabe-Schema
{
"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
}Ausgabe-Schema
{
"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": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "string"
},
"license": {
"type": [
"string",
"null"
]
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.1"
},
"source": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"additionalProperties": false
},
"dataset": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"additionalProperties": false
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"license": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"additionalProperties": false
},
"citation": {
"type": "string"
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"derived": {
"type": "boolean"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"source_url": {
"type": "string"
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
}
},
"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"
],
"additionalProperties": false
}
],
"description": "Provenance block (contract v1.1). 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)"
},
"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).
Eingabe-Schema
{
"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
}Ausgabe-Schema
{
"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": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "string"
},
"license": {
"type": [
"string",
"null"
]
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.1"
},
"source": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"additionalProperties": false
},
"dataset": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"additionalProperties": false
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"license": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"additionalProperties": false
},
"citation": {
"type": "string"
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"derived": {
"type": "boolean"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"source_url": {
"type": "string"
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
}
},
"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"
],
"additionalProperties": false
}
],
"description": "Provenance block (contract v1.1). 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)"
},
"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).
Eingabe-Schema
{
"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
}Ausgabe-Schema
{
"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": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "string"
},
"license": {
"type": [
"string",
"null"
]
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.1"
},
"source": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"additionalProperties": false
},
"dataset": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"additionalProperties": false
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"license": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"additionalProperties": false
},
"citation": {
"type": "string"
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"derived": {
"type": "boolean"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"source_url": {
"type": "string"
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
}
},
"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"
],
"additionalProperties": false
}
],
"description": "Provenance block (contract v1.1). 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)"
},
"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).
Eingabe-Schema
{
"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
}Ausgabe-Schema
{
"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": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "string"
},
"license": {
"type": [
"string",
"null"
]
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.1"
},
"source": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"additionalProperties": false
},
"dataset": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"additionalProperties": false
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"license": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"additionalProperties": false
},
"citation": {
"type": "string"
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"derived": {
"type": "boolean"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"source_url": {
"type": "string"
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
}
},
"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"
],
"additionalProperties": false
}
],
"description": "Provenance block (contract v1.1). 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)"
},
"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.
Eingabe-Schema
{
"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"
}Ausgabe-Schema
{
"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": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "string"
},
"license": {
"type": [
"string",
"null"
]
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.1"
},
"source": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"additionalProperties": false
},
"dataset": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"additionalProperties": false
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"license": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"additionalProperties": false
},
"citation": {
"type": "string"
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"derived": {
"type": "boolean"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"source_url": {
"type": "string"
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
}
},
"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"
],
"additionalProperties": false
}
],
"description": "Provenance block (contract v1.1). 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)"
},
"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.
Eingabe-Schema
{
"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"
}Ausgabe-Schema
{
"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": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"source_url": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"type": "string"
},
"license": {
"type": [
"string",
"null"
]
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.1"
},
"source": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"additionalProperties": false
},
"dataset": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"additionalProperties": false
},
"dimension_key": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"api_version": {
"type": [
"string",
"null"
]
},
"license": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"additionalProperties": false
},
"citation": {
"type": "string"
},
"notices": {
"type": "array",
"items": {
"type": "string"
}
},
"derived": {
"type": "boolean"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"requests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"attempts": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
]
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"count"
],
"additionalProperties": false
}
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"source_url": {
"type": "string"
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
}
},
"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"
],
"additionalProperties": false
}
],
"description": "Provenance block (contract v1.1). 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)"
},
"attribution": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"title",
"text",
"url",
"provenance",
"attribution"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet6 Tools
verifiziertVersion nicht aufgezeichnet6 Tools
verifiziertVersion nicht aufgezeichnet6 Tools