io.github.matematicsolutions/fi-eli-mcp

Official

by matematicsolutions · Python

MCP server for Finnish Finlex consolidated statutes: ELI identifiers and verifiable citations.

Access Finnish consolidated legislation with ELI identifiers and verifiable citations.

Topics

ai-agentelifinlandlegallegaltechlegislationmcpmcp-servermodel-context-protocol

README.md3 KBView on GitHub

fi-eli-mcp

Instalacja (jedna komenda)

Opublikowany na PyPI + MCP Registry (io.github.matematicsolutions/fi-eli-mcp). Uruchomienie bez klonowania:

bash

uvx fi-eli-mcp

Konfiguracja klienta MCP (stdio):

json

{ "mcpServers": { "fi-eli-mcp": { "command": "uvx", "args": ["fi-eli-mcp"] } } }

(Budowanie ze źródeł — niżej.)

An MCP server for the Finnish Finlex open-data API (opendata.finlex.fi). It fetches consolidated Finnish statutes as Akoma Ntoso 3.0 XML, with verifiable ELI identifiers and Finnish citations.

Part of the MateMatic eu-legal-mcp production line - after PL, DE, AT and ES. Same citation contract, Finlex source.

Scope. This MVP covers Finnish statutes (saadokset). Discovery is by year (fi_list_acts) or by year + number; the open-data API is path-based, not keyword search. Finland is bilingual, so titles may be Finnish or Swedish. Every response carries a dataset_note.

Licence. Finnish legislation in Finlex is official public information published as open data (keyless). This connector relays it with attribution and a source_url.

The tools

Tool	What it does
`fi_list_acts`	List the statutes of a year (discovery).
`fi_get_act`	Metadata for a statute by year + number.
`fi_get_text`	Full Akoma Ntoso text of a statute by year + number.

Every response carries the contract: eli_uri (a full ELI URL, e.g. http://data.finlex.fi/eli/sd/2018/1050/alkup), human_readable_citation (e.g. Tietosuojalaki (1050/2018)), and source_url.

Install

bash

cd fi-eli-mcp
pip install -e .

Configure (Claude Code / any MCP client)

json

{
  "mcpServers": {
    "fi-eli-mcp": { "command": "fi-eli-mcp" }
  }
}

Environment:

FI_ELI_BASE_URL - default https://opendata.finlex.fi/finlex/avoindata/v1
FI_ELI_CACHE_DIR - default ~/.matematic/cache/fi-eli
FI_ELI_AUDIT_DIR - default ~/.matematic/audit

No API key. Finlex open data is keyless.

Governance

Public data only - read-only against Finlex; no client data leaves the machine.
Audit log - every tool call appends one JSON line to ~/.matematic/audit/fi-eli-mcp.jsonl.
Vendor-neutral - talks only to opendata.finlex.fi; no LLM provider, no telemetry.
Verifiable citations - every response is independently checkable via source_url.

See CONSTITUTION.md and DISCOVERY.md.

Tests

bash

pip install -e ".[dev]"
pytest tests/test_instructions_drift.py -v   # offline
pytest tests/test_smoke.py -v                # hits live Finlex

Licence

Install

claude_desktop_config.json

{
  "mcpServers": {
    "fi-eli-mcp": {
      "command": "uvx",
      "args": [
        "fi-eli-mcp"
      ]
    }
  }
}