# Ilostat [Health: Active]

**Category:** 🧮 Data Science Tools  
**Repository:** https://github.com/pipeworx-io/mcp-ilostat  
**GitHub Stars:** 0  
**npm Downloads (last month):** 792  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ilostat

## Description
ILOSTAT (International Labour Organization statistics) MCP — global labour

## Tools
Capabilities this server exposes over MCP:

- **list_dataflows** — Browse or keyword-search ILOSTAT datasets (dataflows) from the International Labour Organization. Each result has an `id` (the dataflowId you pass to get_data / dataflow_structure) and an English name. ILO publishes ~1,200 datasets covering employment, unemployment, labour force participation, wage…
- **dataflow_structure** — Get the structure (Data Structure Definition) of one ILOSTAT dataset: its ordered dimensions and, for each, the valid codes. Use this to learn how to build the dot-separated SDMX key for get_data. The key positions correspond to the dimensions in order; an empty position is a wildcard. Common dimen…
- **get_data** — Pull observations from an ILOSTAT dataset. `key` is a dot-separated SDMX dimension filter, one position per dimension in the order given by dataflow_structure; leave a position empty to wildcard it. ILO keys typically start with REF_AREA then FREQ; e.g. get_data({ dataflow_id: "DF_SDG_0852_SEX_AGE_…

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "ilostat": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-ilostat"]
  }
}
```

## Documentation

## What Ilostat MCP server does

Ilostat MCP server gives MCP-compatible clients access to ILOSTAT, the International Labour Organization’s statistics service. The available datasets cover subjects including employment, unemployment, labour-force participation, wages, working hours, informality, working poverty, child labour, and occupational safety. ILOSTAT publishes approximately 1,200 datasets, so dataset discovery is an important part of the workflow.

The server is suited to agents that need to identify a relevant labour-statistics dataset, understand its schema, and retrieve observations for selected countries, frequencies, measures, demographic groups, or periods.

## How it works

Start with `list_dataflows`, preferably with a keyword such as `unemployment rate` or `minimum wage`. Each result includes a dataflow ID and an English dataset name. Pass the selected ID to `dataflow_structure` before requesting observations.

`dataflow_structure` returns the dataset’s Data Structure Definition, including the ordered dimensions and valid codes for each dimension. Those positions determine how to construct the dot-separated SDMX key used by `get_data`. Common dimensions include `REF_AREA` for an ISO3 country code, `FREQ` for annual, quarterly, or monthly frequency, plus `SEX`, `AGE`, and `MEASURE`. Empty key positions act as wildcards.

`get_data` returns decoded series with dimension labels and values for each period. It accepts optional `start_period` and `end_period` filters. Omitting the key, or sending an empty key, requests all series and may produce a large response.

## Setup and configuration

Ilostat MCP server can be connected through the Pipeworx gateway at `https://gateway.pipeworx.io/ilostat/mcp`. The README provides configuration examples for Claude Desktop, Cursor, and Windsurf. The gateway requires no account for the first calls described in the documentation.

A standalone option is available through the `@pipeworx/mcp-ilostat` npm package. Configure an MCP client to run `npx -y @pipeworx/mcp-ilostat`; the process communicates over stdin and stdout and does not require a Pipeworx account or gateway round trip. The standalone process exposes this pack’s tools only.

The gateway also offers HTTP tool calls, including `POST https://gateway.pipeworx.io/v1/tools/ilostat_list_dataflows`, and a full gateway endpoint at `https://gateway.pipeworx.io/mcp`. Pack connections include shared Pipeworx meta-tools in addition to the ILOSTAT tools; the local package does not.

## Tools and capabilities

- `list_dataflows`: Search or browse ILOSTAT dataflows by keyword.
- `dataflow_structure`: Inspect ordered dimensions and valid dimension codes.
- `get_data`: Retrieve observations using SDMX dimension filters and period bounds.

The recommended sequence is to find a dataflow, inspect its structure, then build the key for the data request. This avoids guessing dimension order or code values.

## Limitations and notes

The server does not document credentials or required environment variables for the standalone package. Broad requests can be large, particularly when `get_data` is called without a key. The exact tool list on the gateway can also include shared Pipeworx tools; its `initialize` response is the authoritative source for the tools exposed by a particular connection.

The Ilostat MCP server focuses on ILOSTAT data access. Questions outside the pack’s tools can be routed through the gateway’s `ask_pipeworx` capability, but that capability is part of the gateway connection rather than the standalone package.

_Full upstream README: https://allmcps.com/mcp/ilostat/readme_