Skip to main content

eu-reg-mcp

CI License: MIT Python >=3.13

Let your AI assistant answer MiCAR and EU AI Act questions with citations instead of guesses — every finding flagged for human legal review.

Scope today: the ESMA interim MiCAR register (search, summary, change tracking), MiCAR white paper linting, and EU AI Act risk-tier classification. Other EU regulation is not covered.

Screenshot/GIF placeholder — to be added

Who it's for

  • Crypto-asset compliance and legal teams looking up entities on the ESMA interim MiCAR register (white papers, authorised CASPs, non-compliant entities) and tracking what changes on it, including removals.
  • Teams preparing MiCAR white papers who want a deterministic Annex I–III check of a draft that returns cited candidate findings.
  • Teams assessing AI systems under the EU AI Act who want a first-pass risk-tier classification with pinpoint Art. 5 / Annex III / GPAI citations.

It does not replace legal review: its outputs are register facts or candidate flags for a human to assess (see Guardrails).

Try it now

There is no hosted playground. eu-reg-mcp is a Model Context Protocol (MCP) server, so you try it by adding it to your own MCP client — the Quick start has the configuration for Claude Code and Claude Desktop. Then ask your assistant:

  • "Is <entity> on the MiCAR register, and what format is its white paper?"
  • "What changed on the MiCAR register recently — any removals?"
  • "Classify this AI system under the EU AI Act" (paste a system profile; call with an empty string to get the schema).

The first two work without extras; the third needs the classify extra.

Quick start

eu-reg-mcp is on PyPI and requires Python 3.13 or newer. With uv installed, uvx fetches and runs it.

Claude Code

claude mcp add eu-reg -- uvx eu-reg-mcp

The register tools need no API key. For all five tools, add the lint and classify extras instead:

claude mcp add eu-reg -- uvx --from 'eu-reg-mcp[lint,classify]' eu-reg-mcp
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "eu-reg": {
      "command": "uvx",
      "args": ["eu-reg-mcp"]
    }
  }
}

For the extras, use "args": ["--from", "eu-reg-mcp[lint,classify]", "eu-reg-mcp"].

Without uv, run pip install 'eu-reg-mcp[lint,classify]' in a Python 3.13+ virtual environment and register its eu-reg-mcp by full path, e.g. claude mcp add eu-reg -- /path/to/.venv/bin/eu-reg-mcp; the environment need not be active. Install options and network use: docs/tools.md.

Example output

Synthetic data. Produced on 2026-10-14 by running this repo's register code (register.search_entries / register.recent_changes) against the synthetic test fixtures in tests/fixtures/, not the live register. The entity and its LEI are test data. Output shape is what a live call returns; values are not.

search_micar_register(query="skygate"):

{
  "snapshot_date": "2026-07-07",
  "total_matches": 1,
  "results": [
    {
      "register": "other-wp",
      "entity_name": "SKYGATE Network GmbH",
      "lei": "984500BBFE52FE449926",
      "member_state": "AT",
      "authority": "FMA",
      "whitepaper_url": "WWW.SKYGATETOKEN.AT",
      "format_class": "unspecified",
      "register_last_update": "30/12/2024"
    }
  ],
  "truncated": false,
  "notice": "Facts from the public ESMA interim MiCAR register (Art. 109 MiCAR) as mirrored by the MiCAR Register Observatory. No legal assessment of any entity; not legal advice."
}

micar_register_changes(change_type="removed") returns the same kind of cited record (snapshot date, register, entity) and notes that "the register itself does not state why" an entry was removed. With the extras installed, the lint and classify tools cite the provision behind each finding, for example Anhang I Teil A MiCAR (MiCAR Annex I, Part A), Art. 5(1)(f) AIA, Annex III(4)(a) AIA, and Art. 51 AIA for a general-purpose AI model with systemic risk. Sample output from synthetic inputs: docs/tools.md.

Tools and data sources

An MCP server that gives AI agents cited, review-gated grounding in EU regulation.

Five tools:

Tool What it does Needs
search_micar_register Look up an entity by name or LEI in the ESMA interim MiCAR register —
micar_register_summary Register totals and white paper format coverage —
micar_register_changes New filings, changed entries, removals —
lint_micar_whitepaper Deterministic Annex I–III lint of a draft white paper lint extra
classify_eu_ai_act_system AI Act risk tier with pinpoint citations classify extra

Parameters, data sources, caching and network requirements: docs/tools.md.

Why not just ask an LLM?

An ungrounded model can invent register entries or provisions. Here, register answers come from a dated snapshot of the public register, and lint/classification output comes from deterministic rules with citations. Review-gated means the output is a candidate flag pending human legal review — never a legal assessment or legal advice. Details: docs/guardrails.md.

Part of the EU regulation as code suite

By sebastianfoerste:

Caveats

Register results are public-register facts with extraction artifacts possible; lint and classification outputs are candidate flags pending human legal review. Nothing here is legal advice. MIT licensed.

Metadata

Release files for eu-reg-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eu-reg-mcp 0.1.1
File Size Uploaded Provenance
eu_reg_mcp-0.1.1.tar.gz 75.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for eu-reg-mcp 0.1.1
File Interpreter ABI Platform
eu_reg_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 87.5 kB

Release files / eu_reg_mcp-0.1.1.tar.gz

Download URL eu_reg_mcp-0.1.1.tar.gz
Size 75.1 kB
Tags Source
SHA-256 checksum
How to use checksums
cffa0d225edc5b4355bf4f039eed39fb8533eb9c5548ea6a16796f66265267b1
BLAKE2b-256 checksum
How to use checksums
f7a463979ed50d20f329d268669f953f55093ac1627634ba94025329e6755924
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / eu_reg_mcp-0.1.1-py3-none-any.whl

Download URL eu_reg_mcp-0.1.1-py3-none-any.whl
Size 12.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4c2826e1c6e58c8edcb4288468c27c8cdab8abd62ef104b2d8b478f8a5f2ad1f
BLAKE2b-256 checksum
How to use checksums
2cdb6ddcb8d858a77540ea59beca3b501c3ccf8d52a928144f9243da76c2e833
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Security for eu-reg-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page