io.github.cyanheads/ilostat-mcp-server
v0.2.0Search ILOSTAT labour indicators, query and compare series, build country profiles, run SQL.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:06 AM
- Latency
- 279 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Filostat-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/ilostat-mcp-server": {
"url": "https://ilostat.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
8 shown · authentication unknown
Compare areas on an ILOSTAT dataset
ilostat_compare_geographies
Compare reference areas on one ILOSTAT dataset and one slice — a sex code plus breakdown codes, defaulting to the dataset's totals — giving each area's value at a common period or at its latest non-projected period, optional change over N years, and a rank, with each value's period, source, status, and basis (reported, modelled_estimate, or projection). A change carries the earlier value's source, basis, status, and notes, and flags whether the source or basis differs or the series breaks between the two values. Areas without a value are listed separately with the reason, and the response flags mixed periods and mixed bases rather than hiding them. The areas with a value come back limit at a time from offset, in the sort order, and next_offset continues; ranks, missing, and comparability always cover every area. Select areas by code list, by group (X01 for every country, an ILO region or subregion, or a World Bank income group), or both; X-coded aggregates require a dataset with aggregates.
Schema valid · SHA-256 6fcc47073b11…
View input schema
{ "type": "object", "properties": { "dataset_id": { "description": "One dataset ID (UNE_DEAP_SEX_AGE_RT_A), as ilostat_search_indicators returns it; case-insensitive, a DF_ prefix (the SDMX dataflow form) stripped, a bare indicator code resolved when it has one frequency.", "type": "string", "maxLength": 64, "pattern": "^[A-Z0-9_]+$" }, "ref_areas": { "description": "Reference areas (up to 300): ISO3 codes (USA) or X-coded aggregates (X01 World); case-insensitive, ILO_GEO_ forms accepted. At least one of ref_areas or area_group is required.", "maxItems": 300, "type": "array", "items": { "type": "string", "pattern": "^[A-Z0-9]{3}$" } }, "area_group": { "description": "X01 for every country, an ILO region or subregion, or a World Bank income group (X06, X56, X02, …); expands to its member countries. The group's own aggregate is compared only when listed in ref_areas. ilostat_list_reference topic area_groups lists the codes.", "type": "string", "pattern": "^[A-Z0-9]{3}$" }, "sex": { "description": "Sex code SEX_T, SEX_M, SEX_F, or SEX_O; T/M/F/O and total/both/male/female/other are accepted. Defaults to SEX_T on a dataset with a sex breakdown; refused on one without.", "type": "string", "enum": [ "SEX_T", "SEX_M", "SEX_F", "SEX_O" ] }, "classif1": { "description": "First breakdown code, case-insensitive. Defaults to the dataset's total code; required when the breakdown has no total (deciles); refused on a dataset without the breakdown. ilostat_describe_indicator lists the dataset's codes and marks its totals.", "type": "string", "maxLength": 64 }, "classif2": { "description": "Second breakdown code; same defaults and rules as classif1.", "type": "string", "maxLength": 64 }, "period": { "description": "A common period, YYYY, YYYYQn, or YYYYMmm matching the dataset frequency (2024-Q2 and 2025-03 are normalized). Omit to compare each area at its latest period.", "type": "string", "pattern": "^\\d{4}(Q[1-4]|M(0[1-9]|1[0-2]))?$" }, "lookback_years": { "default": 10, "description": "Latest mode: an area's latest value must fall within this many years of the current year.", "type": "integer", "minimum": 1, "maximum": 50 }, "change_years": { "description": "Adds each value's change from the same sub-period this many years earlier, in the dataset unit.", "type": "integer", "minimum": 1, "maximum": 30 }, "include_projections": { "default": false, "description": "Latest mode: let projections (ILO modelled values after the cutoff) be an area's latest value.", "type": "boolean" }, "sort": { "description": "Row order: value_desc (default), value_asc, or ref_area. rank is always by value, highest first.", "default": "value_desc", "type": "string", "enum": [ "value_desc", "value_asc", "ref_area" ] }, "limit": { "default": 50, "description": "Areas per page.", "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "offset": { "default": 0, "description": "Areas to skip, in the sort order: 0 for the first page, else the previous page's next_offset, with the same other arguments.", "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "dataset_id" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://ilostat.caseyjhand.com/mcp