{"id":51576145,"url":"https://github.com/matematicsolutions/fi-eli-mcp","last_synced_at":"2026-07-11T00:31:50.505Z","repository":{"id":367262040,"uuid":"1279024180","full_name":"matematicsolutions/fi-eli-mcp","owner":"matematicsolutions","description":"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.","archived":false,"fork":false,"pushed_at":"2026-06-25T08:45:40.000Z","size":45,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T09:12:51.850Z","etag":null,"topics":["ai-agent","eli","finland","legal","legaltech","legislation","mcp","mcp-server","model-context-protocol"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matematicsolutions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-24T09:53:37.000Z","updated_at":"2026-06-25T07:34:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/matematicsolutions/fi-eli-mcp","commit_stats":null,"previous_names":["matematicsolutions/fi-eli-mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/matematicsolutions/fi-eli-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matematicsolutions%2Ffi-eli-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matematicsolutions%2Ffi-eli-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matematicsolutions%2Ffi-eli-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matematicsolutions%2Ffi-eli-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matematicsolutions","download_url":"https://codeload.github.com/matematicsolutions/fi-eli-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matematicsolutions%2Ffi-eli-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35347554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-10T02:00:06.465Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","eli","finland","legal","legaltech","legislation","mcp","mcp-server","model-context-protocol"],"created_at":"2026-07-11T00:31:49.631Z","updated_at":"2026-07-11T00:31:50.478Z","avatar_url":"https://github.com/matematicsolutions.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fi-eli-mcp\n\n\u003c!-- mcp-name: io.github.matematicsolutions/fi-eli-mcp --\u003e\n\n\n## Instalacja (jedna komenda)\n\nOpublikowany na PyPI + MCP Registry (`io.github.matematicsolutions/fi-eli-mcp`). Uruchomienie bez klonowania:\n\n```bash\nuvx fi-eli-mcp\n```\n\nKonfiguracja klienta MCP (stdio):\n\n```json\n{ \"mcpServers\": { \"fi-eli-mcp\": { \"command\": \"uvx\", \"args\": [\"fi-eli-mcp\"] } } }\n```\n\n(Budowanie ze źródeł — niżej.)\n\nAn MCP server for the Finnish **Finlex** open-data API (`opendata.finlex.fi`). It fetches\nconsolidated Finnish statutes as Akoma Ntoso 3.0 XML, with verifiable ELI identifiers and\nFinnish citations.\n\nPart of the MateMatic `eu-legal-mcp` production line - after PL, DE, AT and ES. Same citation\ncontract, Finlex source.\n\n\u003e **Scope.** This MVP covers Finnish statutes (saadokset). Discovery is by year (`fi_list_acts`)\n\u003e or by year + number; the open-data API is path-based, not keyword search. Finland is bilingual,\n\u003e so titles may be Finnish or Swedish. Every response carries a `dataset_note`.\n\u003e\n\u003e **Licence.** Finnish legislation in Finlex is official public information published as open\n\u003e data (keyless). This connector relays it with attribution and a `source_url`.\n\n## The tools\n\n| Tool | What it does |\n|---|---|\n| `fi_list_acts` | List the statutes of a year (discovery). |\n| `fi_get_act` | Metadata for a statute by year + number. |\n| `fi_get_text` | Full Akoma Ntoso text of a statute by year + number. |\n\nEvery response carries the contract: `eli_uri` (a full ELI URL, e.g.\n`http://data.finlex.fi/eli/sd/2018/1050/alkup`), `human_readable_citation`\n(e.g. `Tietosuojalaki (1050/2018)`), and `source_url`.\n\n## Install\n\n```bash\ncd fi-eli-mcp\npip install -e .\n```\n\n## Configure (Claude Code / any MCP client)\n\n```json\n{\n  \"mcpServers\": {\n    \"fi-eli-mcp\": { \"command\": \"fi-eli-mcp\" }\n  }\n}\n```\n\nEnvironment:\n\n- `FI_ELI_BASE_URL` - default `https://opendata.finlex.fi/finlex/avoindata/v1`\n- `FI_ELI_CACHE_DIR` - default `~/.matematic/cache/fi-eli`\n- `FI_ELI_AUDIT_DIR` - default `~/.matematic/audit`\n\nNo API key. Finlex open data is keyless.\n\n## Governance\n\n- **Public data only** - read-only against Finlex; no client data leaves the machine.\n- **Audit log** - every tool call appends one JSON line to `~/.matematic/audit/fi-eli-mcp.jsonl`.\n- **Vendor-neutral** - talks only to `opendata.finlex.fi`; no LLM provider, no telemetry.\n- **Verifiable citations** - every response is independently checkable via `source_url`.\n\nSee `CONSTITUTION.md` and `DISCOVERY.md`.\n\n## Tests\n\n```bash\npip install -e \".[dev]\"\npytest tests/test_instructions_drift.py -v   # offline\npytest tests/test_smoke.py -v                # hits live Finlex\n```\n\n## Licence\n\nApache-2.0. © Matematic Solutions / Wieslaw Mazur.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatematicsolutions%2Ffi-eli-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatematicsolutions%2Ffi-eli-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatematicsolutions%2Ffi-eli-mcp/lists"}