Server definition
- Hash
- sha256:c112afa16df1e349b12c36cc6d09a8c0fa743c340cea65c6731b09e9a8203414
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "Labour statistics from ILOSTAT (International Labour Organization) via the official SDMX API: unemployment, employment, earnings (wages), working time, informality and related indicators, by country, year and disaggregations such as sex and age. ILOSTAT is worded in British statistical English; ilo_search_indicators resolves everyday and US wording to it (labor→labour, wages/salary→earnings, informality→informal, gender→sex) and reports the translation. Typical flow: ilo_search_indicators to find a dataflow, then ilo_get_data with country and period filters; use ilo_get_indicator_metadata / ilo_list_dimension_values to discover valid filter codes. Resources ilostat://guide (code conventions, limits) and ilostat://reference/key-dataflows (verified dataflow ids by topic) save discovery calls; prompts ilo_country_labour_profile, ilo_compare_countries and ilo_indicator_trend are ready-made workflows. search and fetch implement the ChatGPT Deep Research contract over the dataflow catalogue. Do not use this server for non-labour statistics (education, health, trade) or for data not published by the ILO.",
"tools": [
{
"description": "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.\n\nCompanion 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.\nThe `ilo_*` tools remain the tools for data queries.\n\nBehavior: read-only and idempotent — a live GET against the public source when the document needs it.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of a document returned by `search`",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "fetch",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attribution": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "Unique identifier of the document on this server; what `fetch` takes",
"minLength": 1,
"type": "string"
},
"metadata": {
"additionalProperties": {},
"description": "Additional key/value pairs about the document (kind, source, period…)",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"provenance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"citation": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"source": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"api_version": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"contract_version": {
"const": "1.1",
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"type": "object"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"derived": {
"type": "boolean"
},
"dimension_key": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"fields": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"license": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"type": "object"
},
"notices": {
"items": {
"type": "string"
},
"type": "array"
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"source": {
"additionalProperties": false,
"properties": {
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"type": "object"
},
"source_url": {
"type": "string"
}
},
"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"
],
"type": "object"
}
],
"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)"
},
"text": {
"description": "Full readable content of the document (Markdown)",
"type": "string"
},
"title": {
"description": "Human-readable title of the document",
"type": "string"
},
"url": {
"description": "Canonical public URL of the document — ChatGPT's citation depends on it",
"type": "string"
}
},
"required": [
"id",
"title",
"text",
"url",
"provenance",
"attribution"
],
"type": "object"
}
},
{
"description": "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). Does not search indicators (use ilo_search_indicators).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dataflow": {
"description": "Dataflow id from ilo_search_indicators (e.g. \"DF_UNE_DEAP_SEX_AGE_RT\")",
"minLength": 1,
"type": "string"
},
"end_period": {
"description": "Last period, e.g. \"2024\"",
"minLength": 1,
"type": "string"
},
"filters": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
}
]
},
"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.",
"properties": {
"REF_AREA": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
}
],
"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"
],
"type": "object"
},
"last_n_observations": {
"description": "Alternative to periods: only the latest N observations per series",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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)",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"start_period": {
"description": "First period, e.g. \"2015\"",
"minLength": 1,
"type": "string"
}
},
"required": [
"dataflow",
"filters"
],
"type": "object"
},
"name": "ilo_get_data",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"attribution": {
"items": {
"type": "string"
},
"type": "array"
},
"columns": {
"items": {
"type": "string"
},
"type": "array"
},
"dataflow": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": "string"
}
},
"required": [
"id",
"version",
"name"
],
"type": "object"
},
"provenance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"citation": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"source": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"api_version": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"contract_version": {
"const": "1.1",
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"type": "object"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"derived": {
"type": "boolean"
},
"dimension_key": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"fields": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"license": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"type": "object"
},
"notices": {
"items": {
"type": "string"
},
"type": "array"
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"source": {
"additionalProperties": false,
"properties": {
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"type": "object"
},
"source_url": {
"type": "string"
}
},
"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"
],
"type": "object"
}
],
"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)"
},
"rows": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"rows_count": {
"type": "number"
}
},
"required": [
"dataflow",
"columns",
"rows_count",
"rows",
"provenance",
"attribution"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dataflow": {
"description": "Dataflow id from ilo_search_indicators (e.g. \"DF_UNE_DEAP_SEX_AGE_RT\")",
"minLength": 1,
"type": "string"
},
"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)",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"dataflow"
],
"type": "object"
},
"name": "ilo_get_indicator_metadata",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"attribution": {
"items": {
"type": "string"
},
"type": "array"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dimensions": {
"items": {
"additionalProperties": false,
"properties": {
"codelist": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
}
},
"required": [
"id",
"codelist"
],
"type": "object"
},
"type": "array"
},
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"provenance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"citation": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"source": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"api_version": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"contract_version": {
"const": "1.1",
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"type": "object"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"derived": {
"type": "boolean"
},
"dimension_key": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"fields": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"license": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"type": "object"
},
"notices": {
"items": {
"type": "string"
},
"type": "array"
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"source": {
"additionalProperties": false,
"properties": {
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"type": "object"
},
"source_url": {
"type": "string"
}
},
"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"
],
"type": "object"
}
],
"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)"
},
"time_dimension": {
"type": [
"string",
"null"
]
},
"version": {
"type": "string"
}
},
"required": [
"id",
"version",
"name",
"data_vintage",
"dimensions",
"time_dimension",
"provenance",
"attribution"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dataflow": {
"description": "Dataflow id the dimension belongs to",
"minLength": 1,
"type": "string"
},
"dimension": {
"description": "Dimension id from ilo_get_indicator_metadata (e.g. \"REF_AREA\", \"SEX\")",
"minLength": 1,
"type": "string"
},
"limit": {
"description": "Maximum codes returned (default 200)",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Codes to skip, for pagination (default 0)",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"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)",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"search": {
"description": "Case-insensitive filter on code id or label",
"minLength": 1,
"type": "string"
}
},
"required": [
"dataflow",
"dimension"
],
"type": "object"
},
"name": "ilo_list_dimension_values",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"attribution": {
"items": {
"type": "string"
},
"type": "array"
},
"codelist": {
"type": "string"
},
"dataflow": {
"type": "string"
},
"dimension": {
"type": "string"
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"type": "number"
},
"offset": {
"type": "number"
},
"provenance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"citation": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"source": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"api_version": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"contract_version": {
"const": "1.1",
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"type": "object"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"derived": {
"type": "boolean"
},
"dimension_key": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"fields": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"license": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"type": "object"
},
"notices": {
"items": {
"type": "string"
},
"type": "array"
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"source": {
"additionalProperties": false,
"properties": {
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"type": "object"
},
"source_url": {
"type": "string"
}
},
"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"
],
"type": "object"
}
],
"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)"
},
"showing": {
"type": "number"
},
"total_codes": {
"type": "number"
},
"values": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"dataflow",
"dimension",
"codelist",
"total_codes",
"showing",
"offset",
"values",
"has_more",
"provenance",
"attribution"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Maximum results (default 20)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Results to skip, for pagination (default 0)",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"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)",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"query": {
"description": "Keywords, matched against dataflow name and id (AND between terms)",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ilo_search_indicators",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"attribution": {
"items": {
"type": "string"
},
"type": "array"
},
"has_more": {
"type": "boolean"
},
"hint": {
"type": "string"
},
"indicators": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"id",
"name",
"version"
],
"type": "object"
},
"type": "array"
},
"next_offset": {
"type": "number"
},
"offset": {
"type": "number"
},
"provenance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"citation": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"source": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"api_version": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"contract_version": {
"const": "1.1",
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"type": "object"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"derived": {
"type": "boolean"
},
"dimension_key": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"fields": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"license": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"type": "object"
},
"notices": {
"items": {
"type": "string"
},
"type": "array"
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"source": {
"additionalProperties": false,
"properties": {
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"type": "object"
},
"source_url": {
"type": "string"
}
},
"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"
],
"type": "object"
}
],
"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)"
},
"showing": {
"type": "number"
},
"total_matches": {
"type": "number"
},
"vocabulary_notes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"total_matches",
"showing",
"offset",
"indicators",
"has_more",
"provenance",
"attribution"
],
"type": "object"
}
},
{
"description": "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).\n\nThis 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.\nFor 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.\n\nQuery: natural language or keywords, Portuguese or English; accents and case are ignored.\n\nBehavior: read-only and idempotent — the catalog comes from the public source and is cached in memory.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"query": {
"description": "Search terms, natural language or keywords (accents and case are ignored)",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attribution": {
"items": {
"type": "string"
},
"type": "array"
},
"provenance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"citation": {
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"source": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"api_version": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"contract_version": {
"const": "1.1",
"type": "string"
},
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"version",
"name"
],
"type": "object"
},
"derivation_note": {
"type": [
"string",
"null"
]
},
"derived": {
"type": "boolean"
},
"dimension_key": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"field_sources": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"data_vintage": {
"type": [
"string",
"null"
]
},
"dataset_id": {
"type": [
"string",
"null"
]
},
"fields": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
}
},
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"license": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"url",
"terms_url",
"verified_at"
],
"type": "object"
},
"notices": {
"items": {
"type": "string"
},
"type": "array"
},
"retrieval": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"anomalies": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string"
}
},
"required": [
"kind",
"count"
],
"type": "object"
},
"type": "array"
},
"attempts": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"requests": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"unstable": {
"type": "boolean"
}
},
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string"
},
"served_from_cache": {
"type": [
"boolean",
"null"
]
},
"source": {
"additionalProperties": false,
"properties": {
"agency": {
"type": [
"string",
"null"
]
},
"database": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"agency",
"database",
"endpoint"
],
"type": "object"
},
"source_url": {
"type": "string"
}
},
"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"
],
"type": "object"
}
],
"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)"
},
"results": {
"description": "Matching documents, in relevance order",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Unique identifier of the document on this server; what `fetch` takes",
"minLength": 1,
"type": "string"
},
"title": {
"description": "Human-readable title of the document",
"type": "string"
},
"url": {
"description": "Canonical public URL of the document — ChatGPT's citation depends on it",
"type": "string"
}
},
"required": [
"id",
"title",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results",
"provenance",
"attribution"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c112afa16df1e349b12c36cc6d09a8c0fa743c340cea65c6731b09e9a8203414 | sha256sum