https://github.com/matematicsolutions/fi-eli-mcp
MCP server for the Finnish Finlex open-data API (opendata.finlex.fi) - consolidated statutes (Akoma Ntoso) with ELI identifiers and verifiable citations. Fifth connector in the eu-legal-mcp line.
https://github.com/matematicsolutions/fi-eli-mcp
ai-agent eli finland legal legaltech legislation mcp mcp-server model-context-protocol
Last synced: 17 days ago
JSON representation
MCP server for the Finnish Finlex open-data API (opendata.finlex.fi) - consolidated statutes (Akoma Ntoso) with ELI identifiers and verifiable citations. Fifth connector in the eu-legal-mcp line.
- Host: GitHub
- URL: https://github.com/matematicsolutions/fi-eli-mcp
- Owner: matematicsolutions
- License: apache-2.0
- Created: 2026-06-24T09:53:37.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-25T08:45:40.000Z (about 1 month ago)
- Last Synced: 2026-06-25T09:12:51.850Z (about 1 month ago)
- Topics: ai-agent, eli, finland, legal, legaltech, legislation, mcp, mcp-server, model-context-protocol
- Language: Python
- Size: 43.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
Apache-2.0. © Matematic Solutions / Wieslaw Mazur.