fi-eli-mcp
Instalacja (jedna komenda)
Opublikowany na PyPI + MCP Registry (io.github.matematicsolutions/fi-eli-mcp). Uruchomienie bez klonowania:
uvx fi-eli-mcp
Konfiguracja klienta MCP (stdio):
{ "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 fetchesconsolidated Finnish statutes as Akoma Ntoso 3.0 XML, with verifiable ELI identifiers andFinnish citations.
Part of the MateMatic eu-legal-mcp production line - after PL, DE, AT and ES. Same citationcontract, 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 adataset_note.Licence. Finnish legislation in Finlex is official public information published as opendata (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
cd fi-eli-mcp
pip install -e .
Configure (Claude Code / any MCP client)
{
"mcpServers": {
"fi-eli-mcp": { "command": "fi-eli-mcp" }
}
}
Environment:
FI_ELI_BASE_URL- defaulthttps://opendata.finlex.fi/finlex/avoindata/v1FI_ELI_CACHE_DIR- default~/.matematic/cache/fi-eliFI_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
pip install -e ".[dev]"
pytest tests/test_instructions_drift.py -v # offline
pytest tests/test_smoke.py -v # hits live Finlex
Licence
Apache-2.0. © Matematic Solutions / Wieslaw Mazur.
