About ie-eli-mcp
ie-eli-mcp helps people researching Irish law retrieve metadata and enacted text for acts and statutory instruments by year, number, and type. It supplies verifiable ELI identifiers and source citations; revised or consolidated versions and keyword search are outside its scope.
Key features
- 01Get legislation by year, number, and type
- 02Retrieve act or instrument metadata
- 03Get enacted text in HTML or XML
- 04Report coverage and data gaps
- 05Provide verifiable ELI identifiers and citations
Use cases
- 01Find an Irish act from its citation coordinates
- 02Retrieve enacted text of a statutory instrument
- 03Check the source and ELI identifier for legislation
MCP support
As an MCP server, it provides clients with tools for legislation metadata, enacted text, and coverage information. It uses the Irish Statute Book and does not offer keyword search.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
3Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| year | integer | Yes | e.g. ``2018``. |
| number | integer | Yes | e.g. ``7``. |
| doc_type | enum | No | ``"act"`` (default) or ``"si"`` (statutory instrument).act | si |
Details
From the project READMEie-eli-mcp
Install (one command)
Published on PyPI + MCP Registry (io.github.matematicsolutions/ie-eli-mcp). Run without cloning:
uvx ie-eli-mcp
Configure your MCP client (stdio):
{ "mcpServers": { "ie-eli-mcp": { "command": "uvx", "args": ["ie-eli-mcp"] } } }
Windows 11 with Smart App Control
Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe
and the ie-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 ie-eli-mcp
python -m ie_eli_mcp
pip.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 ie_eli_mcp.
{ "mcpServers": { "ie-eli-mcp": { "command": "python", "args": ["-m", "ie_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 Irish Statute Book (irishstatutebook.ie), the official source of
Irish legislation. It grounds Irish acts and statutory instruments (SIs) by year + number,
returning metadata and the full enacted text, with verifiable ELI identifiers and Irish citations.
Part of the MateMatic eu-legal-mcp production line - after PL, DE, AT, ES and FI. Same citation
contract, Irish Statute Book source.
Scope. This MVP grounds the ENACTED text of acts and SIs by coordinates (year + number + type). The Irish Statute Book has no keyword-search API here, so discovery is by citation (Irish citations give the coordinates, e.g. "No. 7 of 2018"). Revised/consolidated versions are separate and not covered. Every response carries a
dataset_note.Licence. Irish Statute Book content is official public information. This connector relays it with attribution and a
source_url.
The tools
| Tool | What it does |
|---|---|
ie_get_act | Metadata for an act or SI by year + number + type. |
ie_get_text | Full enacted text (html or xml). |
ie_coverage | 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 (e.g.
https://www.irishstatutebook.ie/eli/2018/act/7/enacted/en), human_readable_citation
(e.g. DATA PROTECTION ACT 2018 (No. 7 of 2018)), and source_url.
Install
cd ie-eli-mcp
pip install -e .
Configure (Claude Code / any MCP client)
{
"mcpServers": {
"ie-eli-mcp": { "command": "ie-eli-mcp" }
}
}
Environment:
IE_ELI_BASE_URL- defaulthttps://www.irishstatutebook.ieIE_ELI_CACHE_DIR- default~/.matematic/cache/ie-eliIE_ELI_AUDIT_DIR- default~/.matematic/audit
No API key.
Governance
- Public data only - read-only against the Irish Statute Book; no client data leaves the machine.
- Audit log - every tool call appends one JSON line to
~/.matematic/audit/ie-eli-mcp.jsonl. - Vendor-neutral - talks only to
irishstatutebook.ie; 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 Irish Statute Book
Licence
Apache-2.0. © Matematic Solutions / Wieslaw Mazur.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.