Economics

Data source: Statistics Finland (Tilastokeskus)

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/statfin/

nobloat — strip report_feedback tool URL-based auth (for clients without header support)

claude_desktop_config.json

{
  "mcpServers": {
    "gnist-statfin": {
      "url": "https://context.gnist.ai/mcp/statfin/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Shell

curl -X POST "https://context.gnist.ai/mcp/statfin/" \
  -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_tables", "arguments": {"query": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/statfin/

6 endpoints available:

GET /rest/statfin/search_tables
GET /rest/statfin/get_table_metadata
GET /rest/statfin/get_data
GET /rest/statfin/list_subjects
GET /rest/statfin/browse_subject
GET /rest/statfin/report_feedback

Shell

curl "https://context.gnist.ai/rest/statfin/search_tables?query=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/statfin/search_tables",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "query": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc statfin

CLI documentation will be available when the GnistAI SDK is published.

Install

pip install gnistai

Available Tools (6)

search_tables

Search Statistics Finland's statistical table catalog by keyword.

Parameter	Type	Required	Description
`query`	`string`	required	Search keywords (e.g. 'population by municipality').
`lang`	`string`	optional	Language — 'en' for English, 'fi' for Finnish (default 'en'). (default: "en")

get_table_metadata

Get the structure of a Statistics Finland table — its dimensions, variables, and valid values.

Parameter	Type	Required	Description
`table_path`	`string`	required	Table path from search results, e.g. 'vaerak/statfin_vaerak_pxt_11rb.px'. Combine search result 'path' and 'table_id'.
`lang`	`string`	optional	Language — 'en' or 'fi'. (default: "en")

get_data

Query data from a Statistics Finland statistical table.

Parameter	Type	Required	Description
`table_path`	`string`	required	Table path, e.g. 'vaerak/statfin_vaerak_pxt_11rb.px'.
`filters`	`any`	optional	List of dimension filters. See get_table_metadata for valid codes.
`top_n`	`integer`	optional	If no filters given, fetch this many latest time periods (default 5). (default: 5)
`lang`	`string`	optional	Language — 'en' or 'fi'. (default: "en")