Economics
Data source: Eurostat
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/eurostat/
claude_desktop_config.json
{
"mcpServers": {
"gnist-eurostat": {
"url": "https://context.gnist.ai/mcp/eurostat/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/eurostat/" \
-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": "get_stat", "arguments": {"dataset_code": "example", "geo": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/eurostat/
6 endpoints available:
GET /rest/eurostat/get_statGET /rest/eurostat/search_datasetsGET /rest/eurostat/list_datasetsGET /rest/eurostat/compare_countriesGET /rest/eurostat/country_profileGET /rest/eurostat/report_feedback
Shell
curl "https://context.gnist.ai/rest/eurostat/get_stat?dataset_code=example&geo=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/eurostat/get_stat",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"dataset_code": "example",
"geo": "example"
},
)
print(resp.json())
Command Line
Command
gc eurostat
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (6)
get_statFetch a time series from a Eurostat dataset filtered by geographic area.
| Parameter | Type | Required | Description |
|---|---|---|---|
dataset_code | string | required | Eurostat dataset identifier (e.g. "nama_10_gdp" for national accounts, "lfsi_emp_a" for employment). Use search_datasets or list_datasets to discover codes. |
geo | string | required | ISO 3166-1 alpha-2 country/region code (e.g. "NO", "DE", "EU27_2020"). Comma-separated for multiple geographies (e.g. "NO,SE,DK"). |
time_from | any | optional | Start year (inclusive), e.g. 2015. |
time_to | any | optional | End year (inclusive), e.g. 2023. |
unit | any | optional | Unit filter code (e.g. "CP_MEUR" for current prices in millions of euros, "PC_GDP" for percentage of GDP). Optional — omit to get all units. |
freq | string | optional | Frequency code: "A" (annual, default), "Q" (quarterly), "M" (monthly). (default: "A") |
search_datasetsSearch Eurostat dataset catalogue by keyword.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search term (e.g. "gdp", "unemployment", "greenhouse gas"). |
limit | integer | optional | Maximum number of results to return (default 20). (default: 20) |
list_datasetsBrowse all available Eurostat datasets, optionally filtered by topic keyword.
| Parameter | Type | Required | Description |
|---|---|---|---|
topic_filter | any | optional | Optional keyword to filter dataset titles (e.g. "trade", "energy", "migration"). Case-insensitive substring match on title and code. If omitted, returns the first 50 datasets from the catalogue. |
compare_countriesCompare one Eurostat dataset across multiple countries for a given year.
| Parameter | Type | Required | Description |
|---|---|---|---|
dataset_code | string | required | Eurostat dataset identifier (e.g. "nama_10_gdp"). Use search_datasets to find the right code. |
geo_codes | list[string] | required | List of ISO 3166-1 alpha-2 or Eurostat geo codes (e.g. ["NO", "SE", "DE", "FR"]). |
year | integer | required | The year to compare (e.g. 2022). |
unit | any | optional | Unit filter code (e.g. "CP_MEUR"). Optional. |
country_profileGet a snapshot of key economic and demographic indicators for a European country.
| Parameter | Type | Required | Description |
|---|---|---|---|
geo_code | string | required | ISO 3166-1 alpha-2 country code (e.g. "NO", "DE", "FR", "SE"). Also accepts EU aggregates like "EU27_2020", "EA20". |
year | any | optional | Specific year to retrieve. Defaults to most recent available. |
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") |