Skip to main content

MCP server for the Irish Statute Book (irishstatutebook.ie) — ground Irish acts and SIs by year/number with ELI identifiers and verifiable citations.

Project description

ie-eli-mcp

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

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.

Project details


Download files

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

Source Distribution

ie_eli_mcp-0.1.0.tar.gz (108.2 kB view details)

Uploaded Source

Built Distribution

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

ie_eli_mcp-0.1.0-py3-none-any.whl (15.6 kB view details)

Uploaded Python 3

File details

Details for the file ie_eli_mcp-0.1.0.tar.gz.

File metadata

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

File hashes

Hashes for ie_eli_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f86203442f20a740c2279cd35495813f30d3e3ed98b5a2f6e326b7732a0f6892
MD5 d882eb765c1d30e4732b6fafe5ec4aaa
BLAKE2b-256 9fc715ebafbc4054b21b6039a9fad845679a45e06789661eb17546f7fcbf3d67

See more details on using hashes here.

Provenance

The following attestation bundles were made for ie_eli_mcp-0.1.0.tar.gz:

Publisher: release.yml on matematicsolutions/ie-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 ie_eli_mcp-0.1.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for ie_eli_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 880b93e50341d000a43c77736cb11c18a638483d379bbb453593a1981a3b2175
MD5 ff6aa4acbc4d79280727749f75cbe25a
BLAKE2b-256 499dd97095ec4e37f8dd72d0300cf3f372045ade9037c0b981d82130187fc5e6

See more details on using hashes here.

Provenance

The following attestation bundles were made for ie_eli_mcp-0.1.0-py3-none-any.whl:

Publisher: release.yml on matematicsolutions/ie-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