get_data
Pack: ilostat · Endpoint: https://gateway.pipeworx.io/ilostat/mcp
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_RT”, key: “USA.A…”, start_period: “2015”, end_period: “2024” }) selects the USA, annual frequency, and wildcards the remaining dimensions. Omit key (or pass "") to fetch all series — caution, this can be large. Returns decoded series with their dimension labels and per-period values.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
dataflow_id | string | yes | ILOSTAT dataflow id, e.g. “DF_SDG_0852_SEX_AGE_RT”. |
key | string | no | Dot-separated dimension filter (one position per dimension, empty = wildcard), e.g. “USA.A…” . Omit for all series. |
start_period | string | no | Start period, e.g. “2015”, “2015-01”, “2015-Q1”. |
end_period | string | no | End period, e.g. “2024”. |
last_n | number | no | Return only the last N observations per series. |
max_series | number | no | Cap the number of decoded series returned (default 200). |
Example call
Arguments
{
"dataflow_id": "DF_SDG_0852_SEX_AGE_RT",
"key": "USA.A...",
"start_period": "2015",
"end_period": "2024"
}
curl
curl -X POST https://gateway.pipeworx.io/ilostat/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_data","arguments":{"dataflow_id":"DF_SDG_0852_SEX_AGE_RT","key":"USA.A...","start_period":"2015","end_period":"2024"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('get_data', {
"dataflow_id": "DF_SDG_0852_SEX_AGE_RT",
"key": "USA.A...",
"start_period": "2015",
"end_period": "2024"
});
More examples
{
"dataflow_id": "DF_SDG_0852_SEX_AGE_RT",
"key": "FRA.A.M.15-24.",
"start_period": "2020",
"end_period": "2023",
"last_n": 5
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"ilostat": {
"url": "https://gateway.pipeworx.io/ilostat/mcp"
}
}
}
See Getting Started for client-specific install steps.