Economics
Data source: ILO (SDMX 2.1)
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/ilostat/
claude_desktop_config.json
{
"mcpServers": {
"gnist-ilostat": {
"url": "https://context.gnist.ai/mcp/ilostat/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/ilostat/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_datasets", "arguments": {"query": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/ilostat/
6 endpoints available:
GET /rest/ilostat/search_datasetsGET /rest/ilostat/list_datasetsGET /rest/ilostat/get_dataset_structureGET /rest/ilostat/get_dataGET /rest/ilostat/compare_countriesGET /rest/ilostat/report_feedback
Shell
curl "https://context.gnist.ai/rest/ilostat/search_datasets?query=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/ilostat/search_datasets",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"query": "example"
},
)
print(resp.json())
Command Line
Command
gc ilostat
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (6)
search_datasetsSearch the ILOSTAT dataset catalog by keyword.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search term for ILOSTAT datasets (e.g. "unemployment", "wages", "child labour", "migration", "working poverty"). |
limit | integer | optional | Number of results to return (1-50, default 20). (default: 20) |
list_datasetsList available ILOSTAT datasets, optionally filtered by topic.
| Parameter | Type | Required | Description |
|---|---|---|---|
topic | any | optional | Optional topic filter (e.g. "employment", "wages", "labour force", "migration"). Omit to list all. |
limit | integer | optional | Maximum datasets to return (1-100, default 50). (default: 50) |
get_dataset_structureGet the dimension structure of an ILOSTAT dataset.
| Parameter | Type | Required | Description |
|---|---|---|---|
dataflow | string | required | ILOSTAT dataflow identifier from search_datasets (e.g. "DF_UNE_2EAP_SEX_AGE_RT", "DF_EMP_TEMP_SEX_AGE_NB"). |
get_dataFetch data from an ILOSTAT dataset.
| Parameter | Type | Required | Description |
|---|---|---|---|
dataflow | string | required | ILOSTAT dataflow identifier (e.g. "DF_UNE_2EAP_SEX_AGE_RT"). Use search_datasets to find IDs. |
countries | any | optional | ISO alpha-2/3 country codes (e.g. ["USA", "DEU", "NOR"]). Omit for all countries. |
start_period | any | optional | Start period (e.g. "2015", "2020-Q1", "2020-01"). |
end_period | any | optional | End period (e.g. "2023", "2023-Q4", "2023-12"). |
dimension_filter | any | optional | Advanced: SDMX dimension key filter (dot-separated, e.g. "USA.A.UNE_DEAP_RT.SEX_T.YGE15"). Overrides countries param. Use get_dataset_structure to find valid dimension values. |
limit | integer | optional | Maximum observations to return (1-1000, default 200). (default: 200) |
compare_countriesCompare data across countries for a given ILOSTAT dataset.
| Parameter | Type | Required | Description |
|---|---|---|---|
dataflow | string | required | ILOSTAT dataflow identifier (e.g. "DF_UNE_2EAP_SEX_AGE_RT"). |
country_codes | list[string] | required | ISO alpha-2/3 country codes to compare (e.g. ["USA", "DEU", "JPN", "NOR"]). Maximum 20. |
start_period | any | optional | Start period (e.g. "2020"). Omit for most recent data. |
end_period | any | optional | End period (e.g. "2023"). Omit for most recent data. |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |