fi-eli-mcp
This server provides read-only access to Finnish statutes from the Finlex open-data API, returning structured metadata and full legal text in Akoma Ntoso 3.0 XML format. No API key is required.
Tools available:
fi_list_acts— List all Finnish statutes published in a given year, returning titles, ELI URIs, statute numbers, subtypes, dates, and human-readable citations (e.g.,Tietosuojalaki (1050/2018)).fi_get_act— Fetch metadata for a specific statute by year and number, including ELI URI, FRBR URI, title (Finnish/Swedish), subtype, and source URL.fi_get_text— Download the complete Akoma Ntoso 3.0 XML text of a statute by year and number, along with its byte size, ELI URI, and citation.
Key notes:
Every response includes verifiable ELI URIs and source URLs for independent verification.
Covers Finnish statutes (saadokset) only — case law is not supported.
Statute titles may appear in Finnish or Swedish (bilingual country).
An audit log of every tool call is maintained locally.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fi-eli-mcp list all Finnish statutes from 2023"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fi-eli-mcp
Install (one command)
As a Claude plugin (Claude Code or the desktop app, needs uv); see plugin/README.md for what it sends and stores:
/plugin marketplace add matematicsolutions/fi-eli-mcp
/plugin install fi-eli-mcp@fi-eli-mcpPublished on PyPI + MCP Registry (io.github.matematicsolutions/fi-eli-mcp). Run without cloning:
uvx fi-eli-mcpConfigure your MCP client (stdio):
{ "mcpServers": { "fi-eli-mcp": { "command": "uvx", "args": ["fi-eli-mcp"] } } }Windows 11 with Smart App Control
Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe
and the fi-eli-mcp.exe launcher that pip writes at install time. The python.exe and
py.exe from the python.org installer are signed by the Python Software
Foundation, so running the module through the interpreter works:
python -m pip install fi-eli-mcp
python -m fi_eli_mcppip.exe is blocked for the same reason, so install with python -m pip, not
pip install. If python is not on PATH, use the Windows launcher: py -3 -m fi_eli_mcp.
{ "mcpServers": { "fi-eli-mcp": { "command": "python", "args": ["-m", "fi_eli_mcp"] } } }Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.
Building from source: see Install.
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 adataset_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.
Related MCP server: dk-eli-mcp
The tools
Tool | What it does |
| List the statutes of a year (discovery). |
| Metadata for a statute by year + number. |
| Full Akoma Ntoso text of a statute by year + number. |
| Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |
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.Network - the server talks to the official source(s) named above and the local filesystem. Once, on first use, it also fetches a small configuration file (
fi-runtime.json.gz, updated source addresses) from this repository's GitHub Releases. That request carries no query content; GitHub's download counter for the file is the only usage signal we see.FI_ELI_RUNTIME_URL=""turns it off; the Claude plugin ships with it off. No LLM provider, no other 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 FinlexLicence
Apache-2.0. © Matematic Solutions / Wieslaw Mazur.
Available Tools
4 toolsfi_coverageARead-onlyIdempotent
Declare what this connector covers, how it is sourced, and what it does NOT cover.
Call this before telling a user that the law "does not contain" something, and whenever a search comes back empty: the absence may be a gap in this connector rather than in the law. Every gap carries a fallback saying where to look instead.
Returns:
Coverage with families, an as-of note, and a non-empty list of known gaps.
Inputs: no named parameters. Returns: What this connector covers, how it is sourced, and what it does not cover.
fi_get_actARead-onlyIdempotent
Fetch statute metadata by year and number.
Inputs: year (required), number (required). Returns: A Finnish statute (parsed from Akoma Ntoso metadata).
fi_get_textBRead-onlyIdempotent
Fetch the full Akoma Ntoso text of a statute by year and number.
Inputs: year (required), number (required). Returns: Result of ``fi_get_text`` (full Akoma Ntoso XML).
fi_list_actsARead-onlyIdempotent
List Finnish statutes published in a given year.
Inputs: year (required). Returns: Result of ``fi_list_acts``.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: listing statutes by year, fetching metadata, fetching full text, and declaring coverage gaps. There is no overlap or ambiguity between them.
Three tools follow a consistent verb_noun pattern (fi_list_acts, fi_get_act, fi_get_text), but fi_coverage is a noun-only name that breaks the pattern. The inconsistency is minor and doesn't cause confusion.
With 4 tools, the server is small but well-scoped for a focused legal data connector. The count is slightly below the typical range but each tool serves a necessary function in retrieval and transparent coverage reporting.
The tool surface covers core read operations (list, get metadata, get text) plus explicit coverage handling, which is a thoughtful safeguard. A keyword search or version history would be a natural addition but its absence is not a critical gap for the apparent purpose.
Maintenance
Related MCP Connectors
Resolve, search and verify legal citations against the official sources, with provenance.
Search and read UK legislation at any date, resolve citations, list amendments, track changes.
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables querying Luxembourg legislation metadata and full Akoma Ntoso text via ELI identifiers from Legilux open data.3159 PyPI1Apache 2.0
- AlicenseAqualityBmaintenanceProvides access to Danish legislation from Retsinformation.dk, enabling retrieval of act metadata, full text, and recent changes with verifiable citations.4127 PyPIApache 2.0
- AlicenseAqualityCmaintenanceEnables access to Slovak legislation from the Collection of Laws via static.slov-lex.sk. Supports listing consolidated versions, retrieving act metadata, and fetching full text with verifiable citations.4138 PyPI1Apache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables searching the HelMet library catalogue, retrieving full metadata for records, and locating which branches own a title with format and availability-of-collection information via the open Finna API.-