Skip to main content
Glama

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

Related MCP server: sg-eli-mcp

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 - default https://www.irishstatutebook.ie

  • IE_ELI_CACHE_DIR - default ~/.matematic/cache/ie-eli

  • IE_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.

Available Tools

3 tools
ie_coverageA
Read-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.

ie_get_actA
Read-onlyIdempotent

Fetch Irish act / SI metadata by coordinates.

Inputs: year (required), number (required), doc_type. Returns: An Irish act or statutory instrument (enacted).

ie_get_textB
Read-onlyIdempotent

Fetch the full enacted text of an Irish act / SI.

Inputs: year (required), number (required), format, doc_type. Returns: Result of ``ie_get_text``.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: fetching metadata, fetching full text, and declaring coverage/gaps. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tools share the 'ie_' prefix and follow a consistent verb_noun pattern: ie_get_act, ie_get_text, ie_coverage. Naming is predictable and uniform.

    Tool Count5/5

    Three tools is an ideal scope for a focused read-only Irish legal metadata and text retrieval server. Each tool earns its place without bloat or thinness.

    Completeness5/5

    The server covers the full read-only workflow: fetch metadata, fetch full text, and a dedicated coverage tool to handle known gaps. No obvious missing operations for its stated purpose.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server for Singapore Statutes Online (SSO), the official portal for Singapore legislation. It browses, fetches, and cites Acts, with a verifiable citation on every response.
      4
      4
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Australia's Federal Register of Legislation. Enables searching and fetching Commonwealth Acts with verifiable citations.
      3
      Apache 2.0