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 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

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 - 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

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.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Wiesiek from gravatar.com Wiesiek

Credits

Author: Matematic Solutions

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache-2.0)

Requires

Python >=3.11

Provides Extra

dev

Tags

akoma-ntoso eli finland finlex law legaltech mcp

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fi_eli_mcp-0.2.0.tar.gz (42.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fi_eli_mcp-0.2.0-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

File details

Details for the file fi_eli_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: fi_eli_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 42.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fi_eli_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 e8dc309e8644128ee4be79805ce4a60d49e02a79274dbe929a709f3147413ea3
MD5 5edf47b3680429464cfcfb3a38d606a9
BLAKE2b-256 98e95d1eb0ad2537968ca6a8aee7f13909c464ec125997136975009b8a04298d

See more details on using hashes here.

Provenance

The following attestation bundles were made for fi_eli_mcp-0.2.0.tar.gz:

Publisher: release.yml on matematicsolutions/fi-eli-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fi_eli_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: fi_eli_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 17.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fi_eli_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9ba38350019e686b6ea8f997ec812103ab938c833eb43388e1425e8fab387b41
MD5 a606a17350a33526ebae4c75d6e91f8e
BLAKE2b-256 8826a2125fcb4b2fbb665bfc6b55f68111afbbc6e03029366c2858194224053d

See more details on using hashes here.

Provenance

The following attestation bundles were made for fi_eli_mcp-0.2.0-py3-none-any.whl:

Publisher: release.yml on matematicsolutions/fi-eli-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page