Eur Lex MCP Server

@cyanheads/eur-lex-mcp-server Search EU legislation, CJEU case law, and treaties; traverse the CELLAR relationship graph; resolve EuroVoc concepts via MCP. STDIO or Streamable HTTP. 7 Tools • 2 Resources • 1 Prompt

Public Hosted Server: https://eur-lex.caseyjhand.com/mcp

Overview

EU legislation, CJEU case law, and treaties from EUR-Lex. Search documents and case law, fetch full text, resolve citations, trace how acts amend and cite each other, and browse the EuroVoc subject thesaurus.

Tools

Resources

All resource data is also reachable via tools.

Prompts

Skills

The skill is in skills/. Plugin installs, the .mcpb bundle, the npm package, and the Docker image include it, and the server serves it to MCP clients through the Skills extension (skills/list, skill:// resources).

Capability reference

eurlex_search_documents tool

• At least one filter: keyword (English titles, plus CELEX numbers or fragments such as 2016R0679; a keyword with letters and no digit, such as R(01), scans every CELEX and can take tens of seconds; no body search), document_type (REG, DIR, DEC, TREATY, JUDG, OPIN_AG, PROP, REC), date_from/date_to, eurovoc_concept (from eurlex_browse_subjects), author_institution, or in_force (true/false; false covers repealed, expired, and not-yet-in-force acts)
• Pages of up to 100 via offset/limit (a larger limit is served at 100 and reported in limit_clamp), newest first; each row flags is_consolidated and is_corrigendum, and corrigenda and consolidated texts appear only under include_corrigenda and include_consolidated. Paging stops at row 10,000: the last page carries no next_offset and a notice giving the date_from/date_to window that continues past it
• No match returns an empty page with a notice on how to broaden the filters; for eurovoc_concept with document_type JUDG or OPIN_AG, where CELLAR indexes no Court of Justice or General Court ruling by EuroVoc concept, the notice instead points to eurlex_get_cases subject; typed errors: no_filters, invalid_date_range, invalid_author_institution and invalid_keyword (no letters or digits), offset_past_window (offset 10,000 or more)
• author_institution matches English authority labels and national-court names returned by eurlex_get_document, such as European Parliament or Supremo Tribunal de Justiça, with or without date bounds

eurlex_get_document tool

• Exactly one of celex_number, eli_uri, or work_uri (pasted forms such as a CELEX: prefix or EUR-Lex URL are accepted); body as html (default), markdown, or xml (Formex4) in any of the 24 EUR-Lex languages, falling back to English. Case law also carries ecli, formation, referring_court, subject_matter, and case_reference, plus countries, procedure_types, subjects, and procedure_languages where CELLAR records them, as eurlex_get_cases rows carry them; a consolidated text reports its base act as base_act_celex
• content_mode "paged" (default), "full", or "metadata_only", capped at 100,000 characters per call (a larger limit is reported in limit_clamp) with content_chars_total/has_more to page on; outline: true lists headings with offsets, and select (e.g. { articles: "1,5,17" }) returns just those sections. For judgments and AG opinions the outline lists section headings, and select: { operative_part: true } returns the ruling alone
• is_superseded flags a newer consolidated version (current_consolidated_celex, consolidated_as_of), and resolve: "current_consolidated" serves it; in_force: false comes with repealed_by, end_of_validity, or entry_into_force where CELLAR records one. Typed errors: invalid_identifier_args, not_found, content_challenge (a WAF bot-challenge in place of text)
• Citation facts, each absent when CELLAR records none: eli (a consolidated text keeps its own point-in-time ELI); oj_reference, the Official Journal reference (OJ L 119, 4.5.2016, p. 1–88; no series letter before 1968, a class letter as in OJ L 42I, OJ L, 2024/1689, 12.7.2024 for act-by-act publication), with pages from the English edition or, before 1973, the original-language editions, and the earliest issue for a reprinted act; dates_of_effect, every recorded date as { date, type?, provision? } with type one of entry_into_force, application, partial_application, provisional_application, takes_effect, takes_partial_effect (an act applying in stages lists its general date of application as application and each date covering only some provisions as partial_application) and provision the clause that sets the date, numbered as CELLAR records it (Article 113(a), Article 93.1); and transposition_deadlines for a directive. entry_into_force keeps its meaning of an entry still ahead on a not-in-force act. A consolidated text reports its base act's oj_reference, dates_of_effect, and transposition_deadlines
• procedures lists the interinstitutional procedures an act belongs to, reached from a proposal or from the act a procedure adopted, each as { reference, status?, withdrawal_date?, adopted_acts? }: reference in its cited form (2021/0106(COD), which eurlex_lookup_celex resolves), status one of adopted, withdrawn, pending, not_adopted from the flag CELLAR sets (absent when it sets none or several, so a missing adopted_by edge or status never means pending), withdrawal_date on a procedure flagged withdrawn, and adopted_acts the CELEX numbers it produced. A consolidated text reports its base act's; case law belongs to none
• Available legacy HTML/Markdown bodies may carry content_omissions: { tables }: missing-table markers counted across the full source, including outside the returned window. Paging cannot recover these tables. alternative_representations lists PDF streams advertised for the served work and language when discovery succeeds; XML availability remains independent. Metadata-only calls do not inspect source omissions
• National implementing measures carry sparse national_measure citation fields: journal, number, pages, publication_date, and notification_date, including metadata-only calls. Numbers and pages retain their source spelling; publication, notification, and document dates are distinct, and each is omitted where CELLAR records its 1001-01-01 placeholder for an unknown date. When the body is unavailable, use the gazette citation to retrieve it; no national-portal URL is inferred, and notification does not prove complete transposition

eurlex_lookup_celex tool

• A CELEX number, ELI URI, ECLI, or OJ citation naming its act type and year (Regulation (EU) 2016/679, Directive 95/46/EC, optionally followed by its parenthesized OJ reference, Directive 95/46/EC (OJ L 281, 23.11.1995, p. 31), or by the period ending a sentence); pasted forms (a CELEX: prefix, a EUR-Lex page URL, an ELI with or without scheme or language segment) are normalized and echoed in celex_number. A citation without its act type (95/46/EC) or year (Regulation No 17) is not parsed
• An Official Journal reference resolves to the act starting on the cited page: issue, publication date, and first page (OJ L 281, 23.11.1995, p. 31, also of 23.11.1995, a page range, a class letter as in OJ L 42I, OJ C, and before 1968 the series-less OJ 13, 21.2.1962, p. 204/62); the year-first OJ 1995 L 281, p. 31, OJ 1995 L 281/31, and [1995] OJ L281/31; and act-by-act OJ L, 2024/1689, 12.7.2024 and OJ C, C/2024/2664, 29.4.2024. The spellings EUR-Lex act text