Legal
Data source: Finlex (opendata.finlex.fi)
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/finlex/
claude_desktop_config.json
{
"mcpServers": {
"gnist-finlex": {
"url": "https://context.gnist.ai/mcp/finlex/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/finlex/" \
-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_statute", "arguments": {"year": 1, "number": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/finlex/
7 endpoints available:
GET /rest/finlex/list_statutesGET /rest/finlex/get_statuteGET /rest/finlex/list_government_proposalsGET /rest/finlex/get_government_proposalGET /rest/finlex/list_consolidated_statutesGET /rest/finlex/get_consolidated_statuteGET /rest/finlex/report_feedback
Shell
curl "https://context.gnist.ai/rest/finlex/get_statute?year=1&number=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/finlex/get_statute",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"year": 1,
"number": "example"
},
)
print(resp.json())
Command Line
Command
gc finlex
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (7)
list_statutesList Finnish statutes from the Statute Book of Finland (Suomen Saadoskokoelma).
| Parameter | Type | Required | Description |
|---|---|---|---|
year | any | optional | Filter by year (e.g. 2025) |
language | string | optional | Language: 'fin' (Finnish, default), 'swe' (Swedish) (default: "fin") |
page | integer | optional | Page number (default 1) (default: 1) |
limit | integer | optional | Results per page (default 20, max 50) (default: 20) |
get_statuteRetrieve a specific Finnish statute with full text and article structure.
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | required | Year of the statute (e.g. 2025) |
number | string | required | Statute number within the year (e.g. '1', '118') |
language | string | optional | Language: 'fin' (Finnish, default), 'swe' (Swedish) (default: "fin") |
list_government_proposalsList Finnish government proposals (hallituksen esitykset / HE).
| Parameter | Type | Required | Description |
|---|---|---|---|
year | any | optional | Filter by year (e.g. 2025) |
language | string | optional | Language: 'fin' (Finnish, default), 'swe' (Swedish) (default: "fin") |
page | integer | optional | Page number (default 1) (default: 1) |
limit | integer | optional | Results per page (default 20, max 50) (default: 20) |
get_government_proposalRetrieve a specific Finnish government proposal with metadata and content preview.
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | required | Year of the proposal (e.g. 2025) |
number | string | required | Proposal number within the year (e.g. '8') |
language | string | optional | Language: 'fin' (Finnish, default), 'swe' (Swedish) (default: "fin") |
list_consolidated_statutesList consolidated (updated/amended) Finnish statutes.
| Parameter | Type | Required | Description |
|---|---|---|---|
year | any | optional | Filter by year (e.g. 2025) |
language | string | optional | Language: 'fin' (Finnish, default), 'swe' (Swedish) (default: "fin") |
page | integer | optional | Page number (default 1) (default: 1) |
limit | integer | optional | Results per page (default 20, max 50) (default: 20) |
get_consolidated_statuteRetrieve a specific consolidated Finnish statute with full amended text.
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | required | Year of the statute (e.g. 2024) |
number | string | required | Statute number within the year (e.g. '2') |
language | string | optional | Language: 'fin' (Finnish, default), 'swe' (Swedish) (default: "fin") |
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") |