ILO Statistics (ILOSTAT) MCP Server

Get ILOSTAT data

ilo_get_data

Read-onlyIdempotent

Fetch raw ILOSTAT observations for a dataflow, filtered by area and period, with required REF_AREA codes (max 30 per call).

Instructions

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).

Input Schema

TableJSON Schema

Name	Required	Description
`filters`	Yes	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.
`dataflow`	Yes	Dataflow id from ilo_search_indicators (e.g. "DF_UNE_DEAP_SEX_AGE_RT")
`end_period`	No	Last period, e.g. "2024"
`start_period`	No	First period, e.g. "2015"
`provenance_mode`	No	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`	No	Alternative to periods: only the latest N observations per series

Output Schema

TableJSON Schema

Name	Required	Description
`rows`	Yes
`columns`	Yes
`dataflow`	Yes
`provenance`	Yes	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_count`	Yes
`attribution`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv1.4.1Oct 7, 2026

changedOutput schema / properties / provenance / anyOf

Previous value: -[
-  {
-    "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"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "citation": {
+        "type": "string"
+      },
+      "data_vintage": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "field_sources": {
+        "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"
+              ]
+            },
+            "served_from_cache": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "source_url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "fields",
+            "source_url",
+            "dataset_id",
+            "data_vintage",
+            "retrieved_at"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "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": {
+        "enum": [
+          "1.1",
+          "1.2"
+        ],
+        "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"
+                  ]
+                },
+                "served_from_cache": {
+                  "type": [
+                    "boolean",
+                    "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"
+  }
+]

Changed2 schema fields changedv1.1.0Sep 27, 2026

addedOutput schema / properties / provenance / anyOf

Added value: +[
+  {
+    "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"
+  }
+]

addedOutput schema / properties / provenance / description

Added value: +"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)"

Changed8 schema fields changedv0.6.0Sep 15, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

changedInput schema / properties / filters / description

Previous value: -"Dimension id → code or list of codes (from ilo_list_dimension_values). REF_AREA is required (up to 30 area codes)."New value: +"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."

addedInput schema / properties / filters / properties

Added value: +{
+  "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)."
+  }
+}

removedInput schema / properties / filters / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / filters / required
```
Added value: +[
+  "REF_AREA"
+]
```

changedInput schema / required

Previous value: -[
-  "dataflow"
-]New value: +[
+  "dataflow",
+  "filters"
+]

removedOutput schema / properties / dataflow / properties / name / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / dataflow / properties / name / type
```
Added value: +[
+  "string",
+  "null"
+]
```

First observedv0.1.0Aug 19, 2026

TDQS

A4.8/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, and the description adds real context beyond them: the 30-area cap, the HTTP 504 timeout if REF_AREA is omitted, and that values are returned raw (no aggregation or conversion) with unit semantics from UNIT_MEASURE/UNIT_MULT.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with scope and required filters, then constraints, then the non-transformation caveat. Dense with parenthetical examples but each sentence carries a distinct constraint; slightly heavy for a single paragraph.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need no explanation. The description covers the pagination workaround, the hard area limit, the required parameter, and unit interpretation — everything needed to call this 6-parameter tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% (baseline 3), and the description still adds value the schema lacks: concrete filter syntax ({"REF_AREA":["BRA","ARG"],"SEX":"SEX_T"}), the rule that unfiltered dimensions return all categories, and how to interpret UNIT_MULT. It does not add meaning for provenance_mode or last_n_observations beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource: statistical observations from one ILOSTAT dataflow, scoped by dimension filters and period. It explicitly distinguishes itself from ilo_search_indicators, so an agent can route without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Names the sibling it is not (ilo_search_indicators) and the condition that selects it, plus operational guidance for broad panels (split areas into batches, paginate by period) and the REF_AREA requirement. When-to-use and when-not are both covered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server