io.github.cyanheads/eur-lex-mcp-server

Official7 toolsLive

by cyanheads · TypeScript

Search EU legislation, CJEU case law, and treaties; traverse CELLAR graph; browse EuroVoc concepts.

@cyanheads/eur-lex-mcp-server

This MCP server provides tools to search EU legislation, CJEU case law, and treaties. It can traverse the CELLAR relationship graph and resolve EuroVoc concepts via MCP. Access is available through STDIO or Streamable HTTP, with content exposed through a set of tools.

🛠️ Key Features

Search EU legislation, CJEU case law, and treaties
Traverse the CELLAR relationship graph
Resolve EuroVoc concepts via MCP
Uses 7 tools
Supports STDIO or Streamable HTTP

🚀 Use Cases

Query legal texts across EU legislation, CJEU case law, and treaties
Follow relationships in the CELLAR graph for related entities
Map or resolve terms using EuroVoc concepts

⚡ Developer Benefits

Model Context Protocol (MCP) server interface
Integrates EU-law sources for automated context retrieval
Available as a TypeScript-based project (topics include “typescript”)

⚠️ Limitations

Scope is limited to EU legislation, CJEU case law, treaties, CELLAR graph traversal, and EuroVoc concept resolution.

Topics

ai-agentsai-toolscyanheadseu-laweur-lexlegislationmcpmcp-servermodel-context-protocolsparqltypescript

Captured live from the server via tools/list.

eurlex_lookup_celex

Resolve an EU legal citation — a CELEX number or ELI URI — to its canonical CELLAR work, confirming it exists before you fetch or traverse it. Returns the work URI, confirmed CELEX number, document type, and date.

Parameters2

identifier	string	required	The EU legal citation to resolve: a CELEX number (e.g. 32016R0679) or a work-level ELI URI (e.g. http://data.europa.eu/eli/reg/2016/679, with or without the /oj suffix).
identifier_type	string	optional	Format of the identifier. "auto" detects it automatically; supply "celex" or "eli" explicitly if detection fails.

Raw schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "The EU legal citation to resolve: a CELEX number (e.g. 32016R0679) or a work-level ELI URI (e.g. http://data.europa.eu/eli/reg/2016/679, with or without the /oj suffix)."
    },
    "identifier_type": {
      "default": "auto",
      "description": "Format of the identifier. \"auto\" detects it automatically; supply \"celex\" or \"eli\" explicitly if detection fails.",
      "type": "string",
      "enum": [
        "celex",
        "eli",
        "auto"
      ]
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

eurlex_browse_subjects

Search the EuroVoc thesaurus, resolving a keyword into concept URIs usable in the eurovoc_concept subject filter of eurlex_search_documents. Matches both preferred and alternative (non-preferred) labels, so a common synonym reaches the concept it stands for. Returns each concept URI, its preferred label in the requested language, code, broader (parent) label, and the alternative label that matched when one did, ordered alphabetically by preferred label.

Parameters4

keyword	string	required	Search term matched against EuroVoc preferred and alternative concept labels (e.g. "privacy", "agriculture", "product liability").
language	string	optional	Language code for concept labels (e.g. "en", "fr", "de"). Case-insensitive — "EN" and "en" behave identically. Defaults to English.
offset	integer	optional	Pagination offset — number of concepts to skip. Defaults to 0.
limit	integer	optional	Maximum number of EuroVoc concepts to return (1–50). Defaults to 20.

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "Search term matched against EuroVoc preferred and alternative concept labels (e.g. \"privacy\", \"agriculture\", \"product liability\")."
    },
    "language": {
      "default": "en",
      "description": "Language code for concept labels (e.g. \"en\", \"fr\", \"de\"). Case-insensitive — \"EN\" and \"en\" behave identically. Defaults to English.",
      "type": "string",
      "pattern": "^[A-Za-z]{2,3}$"
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset — number of concepts to skip. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of EuroVoc concepts to return (1–50). Defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "keyword"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

eurlex_search_documents

Search EU legislation, treaties, and preparatory acts across the CELLAR corpus by document type, date range, EuroVoc subject, author institution, and in-force status. Keyword matches English titles and CELEX strings only — there is no full-text body search. Returns a page of CELEX numbers, work URIs, type labels, dates, and titles, newest first, each flagged with is_consolidated. At least one filter is required.

Parameters10

keyword	string	optional	Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), or against CELEX substrings.
document_type	any	optional	Document category: REG=Regulations, DIR=Directives, DEC=Decisions, TREATY=Treaties, JUDG=Judgments, OPIN_AG=AG Opinions, PROP=Proposals, REC=Recommendations. Each category includes its explicit CELLAR authority variants (for example, delegated and implementing regulations). Omit to search all types. Consolidated texts are excluded unless include_consolidated is true.
include_consolidated	boolean	optional	When true and document_type is set, also match consolidated texts whose basic act belongs to that document category. No effect when document_type is omitted. Consolidated rows are always tagged is_consolidated: true.
date_from	any	optional	Start of date range (YYYY-MM-DD), matched against document date. Omit for no lower bound.
date_to	any	optional	End of date range (YYYY-MM-DD), matched against document date. Omit for no upper bound.
eurovoc_concept	any	optional	EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828), obtained from eurlex_browse_subjects. Omit for no subject filter.
author_institution	string	optional	Author institution name (e.g. "European Parliament", "Council", "European Commission"), matched against the English names of EU corporate bodies.
in_force	boolean	optional	If true, restrict to acts currently in force. Omit to return all regardless of in-force status.
offset	integer	optional	Pagination offset — number of results to skip. Defaults to 0.
limit	integer	optional	Maximum number of results to return (1–100). Defaults to 20.

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), or against CELEX substrings.",
      "type": "string"
    },
    "document_type": {
      "description": "Document category: REG=Regulations, DIR=Directives, DEC=Decisions, TREATY=Treaties, JUDG=Judgments, OPIN_AG=AG Opinions, PROP=Proposals, REC=Recommendations. Each category includes its explicit CELLAR authority variants (for example, delegated and implementing regulations). Omit to search all types. Consolidated texts are excluded unless include_consolidated is true.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "enum": [
            "REG",
            "DIR",
            "DEC",
            "TREATY",
            "JUDG",
            "OPIN_AG",
            "PROP",
            "REC"
          ],
          "description": "Document type: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation."
        }
      ]
    },
    "include_consolidated": {
      "default": false,
      "description": "When true and document_type is set, also match consolidated texts whose basic act belongs to that document category. No effect when document_type is omitted. Consolidated rows are always tagged is_consolidated: true.",
      "type": "boolean"
    },
    "date_from": {
      "description": "Start of date range (YYYY-MM-DD), matched against document date. Omit for no lower bound.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Start date in ISO 8601 format (YYYY-MM-DD)."
        }
      ]
    },
    "date_to": {
      "description": "End of date range (YYYY-MM-DD), matched against document date. Omit for no upper bound.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "End date in ISO 8601 format (YYYY-MM-DD)."
        }
      ]
    },
    "eurovoc_concept": {
      "description": "EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828), obtained from eurlex_browse_subjects. Omit for no subject filter.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "description": "EuroVoc concept URI (e.g. http://eurovoc.europa.eu/2828)."
        }
      ]
    },
    "author_institution": {
      "description": "Author institution name (e.g. \"European Parliament\", \"Council\", \"European Commission\"), matched against the English names of EU corporate bodies.",
      "type": "string"
    },
    "in_force": {
      "description": "If true, restrict to acts currently in force. Omit to return all regardless of in-force status.",
      "type": "boolean"
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset — number of results to skip. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of results to return (1–100). Defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

eurlex_get_cases

Search CJEU and General Court case law — judgments, orders, and Advocate General opinions — by case number, court, case type, keyword, and date range. By default only these primary records are returned; derivative judicial information notices, case abstracts, summaries, and corrigenda are excluded so distinct cases fill the page (set include_derivative to include them). Keyword matches English case titles (which carry party names) and CELEX strings; there is no full-text body search. Returns each case with its court, date, and type, plus — parsed from the title where present — the parties, subject matter, and case reference.

Parameters9

case_number	string	optional	Case number in standard format: C-{num}/{year} for CJEU or T-{num}/{year} for General Court (e.g. C-131/12).
keyword	string	optional	Keyword to match against case titles and CELEX strings.
court	any	optional	Court filter: CJEU = Court of Justice of the EU, GC = General Court. Omit to search both.
case_type	any	optional	Case type: judgment, order (procedural decision), or ag_opinion (Advocate General opinion). Omit to search all.
include_derivative	boolean	optional	Include derivative sector-6 records — judicial information notices, case abstracts, case summaries, and corrigenda — alongside primary judgments, orders, and AG opinions. Default false: these are excluded so distinct primary cases fill the page. Ignored when case_type is set (that path already returns a single primary type).
date_from	any	optional	Start of date range in ISO 8601 format (YYYY-MM-DD). Leave blank or omit for no lower bound.
date_to	any	optional	End of date range in ISO 8601 format (YYYY-MM-DD). Leave blank or omit for no upper bound.
offset	integer	optional	Pagination offset — number of results to skip. Defaults to 0.
limit	integer	optional	Maximum number of results to return (1–100). Defaults to 20.

Raw schema

{
  "type": "object",
  "properties": {
    "case_number": {
      "description": "Case number in standard format: C-{num}/{year} for CJEU or T-{num}/{year} for General Court (e.g. C-131/12).",
      "type": "string"
    },
    "keyword": {
      "description": "Keyword to match against case titles and CELEX strings.",
      "type": "string"
    },
    "court": {
      "description": "Court filter: CJEU = Court of Justice of the EU, GC = General Court. Omit to search both.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "enum": [
            "CJEU",
            "GC"
          ],
          "description": "CJEU = Court of Justice of the EU, GC = General Court."
        }
      ]
    },
    "case_type": {
      "description": "Case type: judgment, order (procedural decision), or ag_opinion (Advocate General opinion). Omit to search all.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "enum": [
            "judgment",
            "order",
            "ag_opinion"
          ],
          "description": "judgment, order (procedural decision), or ag_opinion (Advocate General opinion)."
        }
      ]
    },
    "include_derivative": {
      "default": false,
      "description": "Include derivative sector-6 records — judicial information notices, case abstracts, case summaries, and corrigenda — alongside primary judgments, orders, and AG opinions. Default false: these are excluded so distinct primary cases fill the page. Ignored when case_type is set (that path already returns a single primary type).",
      "type": "boolean"
    },
    "date_from": {
      "description": "Start of date range in ISO 8601 format (YYYY-MM-DD). Leave blank or omit for no lower bound.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Start date in ISO 8601 format (YYYY-MM-DD)."
        }
      ]
    },
    "date_to": {
      "description": "End of date range in ISO 8601 format (YYYY-MM-DD). Leave blank or omit for no upper bound.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "End date in ISO 8601 format (YYYY-MM-DD)."
        }
      ]
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset — number of results to skip. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of results to return (1–100). Defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

eurlex_get_document

Fetch the metadata and full text of an EU act by CELEX number, ELI URI, or work URI. Returns structured metadata (title, date, type, author institution, legal basis, EuroVoc subjects, in-force status) plus the act body as HTML, Markdown, or Formex4 XML, defaulting to English with automatic fallback. Ordinary offset-based paged windows and full-mode windows are capped at 100,000 characters; page with offset/limit to reconstruct larger acts, or use outline: true for a heading map and select to pull specific articles, chapters, recitals, or annexes.

Parameters11

celex_number	any	optional	CELEX number of the act to fetch (e.g. 32016R0679 for GDPR). Provide exactly one of celex_number, eli_uri, or work_uri.
eli_uri	string	optional	Work-level ELI URI of the act to fetch (e.g. http://data.europa.eu/eli/reg/2016/679, with or without the /oj suffix). Provide exactly one of celex_number, eli_uri, or work_uri.
work_uri	string	optional	CELLAR work resource URI to fetch (e.g. http://publications.europa.eu/resource/cellar/3e485e15-11bd-11e6-ba9a-01aa75ed71a1) — the form returned by eurlex_lookup_celex, eurlex_get_relations, and eurlex_search_documents. Provide exactly one of celex_number, eli_uri, or work_uri.
resolve	string	optional	Which version to serve for a base act with newer consolidated versions. "as_requested" (default) returns the exact CELEX requested; "current_consolidated" serves the newest consolidated version instead (echoing the request in requested_celex), a no-op when none exists. Either way, is_superseded / current_consolidated_celex / consolidated_as_of flag a stale base act.
language	string	optional	One of the 24 supported two-letter EUR-Lex language codes (e.g. EN, FR, DE), accepted case-insensitively and normalized to uppercase. Defaults to EN, and falls back to EN if the requested language is unavailable.
format	string	optional	Content format: "html" for the act text as served by EUR-Lex (default), "markdown" for that HTML converted to clean Markdown server-side, or "xml" for Formex4 structured XML.
content_mode	string	optional	How much of the body to return. "paged" (default) returns an offset/limit window; "full" requests from the start and returns at most 100000 characters with continuation metadata when more exists; "metadata_only" skips the content fetch. offset and limit apply only to "paged".
offset	integer	optional	Character offset into the body where the returned window starts ("paged" mode only). Page forward by setting offset = content_offset + content_chars_returned from the previous call. Offsets are format-specific: an offset is only valid against the same format it was measured in — keep format constant when paging.
limit	integer	optional	Maximum characters to return in this window ("paged" mode only). Default 25000, max 100000. Follow has_more and the returned offsets until false to reconstruct the complete body.
outline	boolean	optional	Return a structural outline of the act — chapters, sections, articles, annexes, and recitals as a heading list, each with its character offset — instead of body text. Read a section by paging with its offset, keeping the same format: outline offsets are measured in the requested format's body and land in the wrong place under any other format. Ignores offset/limit and select; no detectable structure returns an empty outline. Not applied in content_mode "metadata_only".
select	object	optional	Return only the text of specific sections by type and number, instead of a raw character window (Roman and Arabic numbers are equivalent). Sections are located in the body of the requested format, so pair select with the same format used for any outline. A section that cannot be located is reported in selection.missed with no wrong text returned. Ignored when outline is true or in content_mode "metadata_only".

Raw schema

{
  "type": "object",
  "properties": {
    "celex_number": {
      "description": "CELEX number of the act to fetch (e.g. 32016R0679 for GDPR). Provide exactly one of celex_number, eli_uri, or work_uri.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "pattern": "^[0-9A-Z][0-9A-Z()/_-]{5,}$",
          "description": "CELEX number of the act (e.g. 32016R0679 for GDPR). Surrounding whitespace is trimmed and the value is uppercased before validation."
        }
      ]
    },
    "eli_uri": {
      "description": "Work-level ELI URI of the act to fetch (e.g. http://data.europa.eu/eli/reg/2016/679, with or without the /oj suffix). Provide exactly one of celex_number, eli_uri, or work_uri.",
      "type": "string"
    },
    "work_uri": {
      "description": "CELLAR work resource URI to fetch (e.g. http://publications.europa.eu/resource/cellar/3e485e15-11bd-11e6-ba9a-01aa75ed71a1) — the form returned by eurlex_lookup_celex, eurlex_get_relations, and eurlex_search_documents. Provide exactly one of celex_number, eli_uri, or work_uri.",
      "type": "string"
    },
    "resolve": {
      "default": "as_requested",
      "description": "Which version to serve for a base act with newer consolidated versions. \"as_requested\" (default) returns the exact CELEX requested; \"current_consolidated\" serves the newest consolidated version instead (echoing the request in requested_celex), a no-op when none exists. Either way, is_superseded / current_consolidated_celex / consolidated_as_of flag a stale base act.",
      "type": "string",
      "enum": [
        "as_requested",
        "current_consolidated"
      ]
    },
    "language": {
      "default": "EN",
      "description": "One of the 24 supported two-letter EUR-Lex language codes (e.g. EN, FR, DE), accepted case-insensitively and normalized to uppercase. Defaults to EN, and falls back to EN if the requested language is unavailable.",
      "type": "string",
      "pattern": "^(?:[Ee][Nn]|[Ff][Rr]|[Dd][Ee]|[Ee][Ss]|[Ii][Tt]|[Pp][Ll]|[Pp][Tt]|[Nn][Ll]|[Cc][Ss]|[Dd][Aa]|[Ee][Ll]|[Ee][Tt]|[Ff][Ii]|[Hh][Uu]|[Ll][Tt]|[Ll][Vv]|[Mm][Tt]|[Rr][Oo]|[Ss][Kk]|[Ss][Ll]|[Ss][Vv]|[Bb][Gg]|[Hh][Rr]|[Gg][Aa])$"
    },
    "format": {
      "default": "html",
      "description": "Content format: \"html\" for the act text as served by EUR-Lex (default), \"markdown\" for that HTML converted to clean Markdown server-side, or \"xml\" for Formex4 structured XML.",
      "type": "string",
      "enum": [
        "html",
        "xml",
        "markdown"
      ]
    },
    "content_mode": {
      "default": "paged",
      "description": "How much of the body to return. \"paged\" (default) returns an offset/limit window; \"full\" requests from the start and returns at most 100000 characters with continuation metadata when more exists; \"metadata_only\" skips the content fetch. offset and limit apply only to \"paged\".",
      "type": "string",
      "enum": [
        "metadata_only",
        "paged",
        "full"
      ]
    },
    "offset": {
      "default": 0,
      "description": "Character offset into the body where the returned window starts (\"paged\" mode only). Page forward by setting offset = content_offset + content_chars_returned from the previous call. Offsets are format-specific: an offset is only valid against the same format it was measured in — keep format constant when paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 25000,
      "description": "Maximum characters to return in this window (\"paged\" mode only). Default 25000, max 100000. Follow has_more and the returned offsets until false to reconstruct the complete body.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "outline": {
      "default": false,
      "description": "Return a structural outline of the act — chapters, sections, articles, annexes, and recitals as a heading list, each with its character offset — instead of body text. Read a section by paging with its offset, keeping the same format: outline offsets are measured in the requested format's body and land in the wrong place under any other format. Ignores offset/limit and select; no detectable structure returns an empty outline. Not applied in content_mode \"metadata_only\".",
      "type": "boolean"
    },
    "select": {
      "description": "Return only the text of specific sections by type and number, instead of a raw character window (Roman and Arabic numbers are equivalent). Sections are located in the body of the requested format, so pair select with the same format used for any outline. A section that cannot be located is reported in selection.missed with no wrong text returned. Ignored when outline is true or in content_mode \"metadata_only\".",
      "type": "object",
      "properties": {
        "articles": {
          "description": "Comma-separated article numbers, e.g. \"1,5,17\".",
          "type": "string"
        },
        "chapters": {
          "description": "Comma-separated chapter numbers, Roman or Arabic, e.g. \"I,IV\" or \"1,4\".",
          "type": "string"
        },
        "recitals": {
          "description": "Comma-separated recital numbers, e.g. \"1,10\".",
          "type": "string"
        },
        "annexes": {
          "description": "Comma-separated annex numbers or letters, e.g. \"I,II\".",
          "type": "string"
        }
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

eurlex_get_relations

Traverse the one-hop CDM relationship graph of an EU act: what it amends or is amended by, what it repeals or is repealed by (explicit and implicit), its consolidated versions, national transposition measures, its legal basis, and works that cite it. Returns direct relations only, paginated per relation type and direction. Requires a CELEX number or CELLAR work URI.

Parameters5

celex_number	any	optional	CELEX number of the work to traverse (e.g. 32016R0679). Provide exactly one of celex_number or work_uri.
work_uri	string	optional	CELLAR work resource URI to traverse (e.g. http://publications.europa.eu/resource/cellar/3e485e15-11bd-11e6-ba9a-01aa75ed71a1). Used directly as the addressed work; its CELEX identity is resolved for relation-specific act matching, and act-matched relation types stand down when the work carries several CELEX numbers — address such a work by celex_number to name the act you mean. Provide exactly one of celex_number or work_uri.
relation_types	array	optional	Subset of relation types to return; omit for all. Types: cites, amends, amended_by, repeals, repealed_by, implicitly_repeals, implicitly_repealed_by, legal_basis (treaty/article this act rests on), consolidated_version (consolidated texts of this act), national_transposition (member-state implementing measures).
offset	integer	optional	Pagination offset applied per relation type and direction — related works to skip (default 0). Page forward by adding limit; incoming edges are newest-first, so higher offsets reach older works.
limit	integer	optional	Maximum related works per relation type and direction (1–100, default 100). Incoming edges are ordered newest-first, so the cap keeps the newest — page with offset for older ones.

Raw schema

{
  "type": "object",
  "properties": {
    "celex_number": {
      "description": "CELEX number of the work to traverse (e.g. 32016R0679). Provide exactly one of celex_number or work_uri.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "pattern": "^[0-9A-Z][0-9A-Z()/_-]{5,}$",
          "description": "CELEX number of the work (e.g. 32016R0679). Surrounding whitespace is trimmed and the value is uppercased before validation."
        }
      ]
    },
    "work_uri": {
      "description": "CELLAR work resource URI to traverse (e.g. http://publications.europa.eu/resource/cellar/3e485e15-11bd-11e6-ba9a-01aa75ed71a1). Used directly as the addressed work; its CELEX identity is resolved for relation-specific act matching, and act-matched relation types stand down when the work carries several CELEX numbers — address such a work by celex_number to name the act you mean. Provide exactly one of celex_number or work_uri.",
      "type": "string"
    },
    "relation_types": {
      "description": "Subset of relation types to return; omit for all. Types: cites, amends, amended_by, repeals, repealed_by, implicitly_repeals, implicitly_repealed_by, legal_basis (treaty/article this act rests on), consolidated_version (consolidated texts of this act), national_transposition (member-state implementing measures).",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "cites",
          "amends",
          "amended_by",
          "repeals",
          "repealed_by",
          "implicitly_repeals",
          "implicitly_repealed_by",
          "legal_basis",
          "consolidated_version",
          "national_transposition"
        ]
      }
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset applied per relation type and direction — related works to skip (default 0). Page forward by adding limit; incoming edges are newest-first, so higher offsets reach older works.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 100,
      "description": "Maximum related works per relation type and direction (1–100, default 100). Incoming edges are ordered newest-first, so the cap keeps the newest — page with offset for older ones.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

eurlex_query_sparql

Run a raw, read-only SPARQL SELECT against the CELLAR Virtuoso endpoint — an escape hatch for CDM ontology traversals the curated tools do not cover. Only SELECT is accepted; update forms and ASK/CONSTRUCT/DESCRIBE are rejected before execution, and results are capped at 100. The cdm:, skos:, and xsd: prefixes are auto-injected.

Parameters2

sparql_query	string	required	A read-only SPARQL SELECT query. Leading comments and PREFIX/BASE declarations are allowed; the cdm:, skos:, and xsd: prefixes are auto-injected. LIMIT is injected at 100 if absent, or capped to 100. Key CDM predicates: cdm:resource_legal_id_celex (CELEX), cdm:work_date_document (date), cdm:work_has_resource-type (type), cdm:work_is_about_concept_eurovoc (EuroVoc subject), cdm:work_cites_work (citation). CELEX is an xsd:string literal — match it with FILTER(STR(?celex) = "…"). For text, use bif:contains with a single-quoted phrase.
timeout_hint	integer	optional	Optional client-side timeout in milliseconds (1000–55000). Defaults apply when omitted; the endpoint hard limit is 60 seconds.

Raw schema

{
  "type": "object",
  "properties": {
    "sparql_query": {
      "type": "string",
      "minLength": 10,
      "description": "A read-only SPARQL SELECT query. Leading comments and PREFIX/BASE declarations are allowed; the cdm:, skos:, and xsd: prefixes are auto-injected. LIMIT is injected at 100 if absent, or capped to 100. Key CDM predicates: cdm:resource_legal_id_celex (CELEX), cdm:work_date_document (date), cdm:work_has_resource-type (type), cdm:work_is_about_concept_eurovoc (EuroVoc subject), cdm:work_cites_work (citation). CELEX is an xsd:string literal — match it with FILTER(STR(?celex) = \"…\"). For text, use bif:contains with a single-quoted phrase."
    },
    "timeout_hint": {
      "description": "Optional client-side timeout in milliseconds (1000–55000). Defaults apply when omitted; the endpoint hard limit is 60 seconds.",
      "type": "integer",
      "minimum": 1000,
      "maximum": 55000
    }
  },
  "required": [
    "sparql_query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

README.md23 KBView on GitHub

@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

MCP Server TypeScript

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

Overview

EU legislation, CJEU case law, and treaties over the EU Publications Office's CELLAR semantic repository and the EUR-Lex content API. Search documents and case law, fetch full text, resolve citations, traverse the amendment and citation graph, and browse the EuroVoc thesaurus from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

Tool	Description
`eurlex_search_documents`	Search EU legislation, treaties, and preparatory acts by type, date, EuroVoc subject, author institution, and in-force status
`eurlex_get_document`	Fetch metadata and full text (HTML, Markdown, or Formex4 XML) for an act or case by CELEX, ELI, or work URI, with a section outline of either
`eurlex_lookup_celex`	Resolve a CELEX number, ELI URI, ECLI, or OJ citation (`Regulation (EU) 2016/679`) to its canonical CELLAR work
`eurlex_get_cases`	Search CJEU and General Court case law by case number, court, case type, and date range
`eurlex_get_relations`	Traverse the CELLAR relationship graph — amendments, repeals, consolidations, legal basis, citations, transpositions
`eurlex_browse_subjects`	Search the EuroVoc thesaurus to resolve terms to concept URIs
`eurlex_query_sparql`	Run a raw, read-only SPARQL SELECT against the CELLAR endpoint

Resources

Resource	Description
`eurlex://document/{celexNumber}`	Metadata snapshot for a CELLAR work
`eurlex://document/{celexNumber}/relations`	One-hop relationship summary for a CELLAR work

All resource data is also reachable via tools.

Prompts

Prompt	Description
`eurlex_comparative_analysis`	Frame a comparative EU/US legal analysis for a policy domain

Capability reference

`eurlex_search_documents` _tool

At least one filter: keyword (English titles, plus CELEX numbers when it holds a digit: a whole CELEX with its (01)–(20) siblings and R(01)–R(20) corrigenda by exact lookup, a partial one such as 2016R0679, R0679, J0131, or the OJ C 2024/01469 through the CELEX full-text index; one opening with letters no digit follows, such as R(01), or with a year, a slash, and a number under four characters, such as 2017/111, by a scan of every CELEX that can take tens of seconds; a bare year or a fragment opening mid-year or mid-number, such as 0679R, matches titles only; no body search), document_type (REG, DIR, DEC, TREATY, JUDG, OPIN_AG, PROP, REC, each its full CELLAR authority family), 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, newest first with the CELEX breaking date ties, so a page is the same on every call; each row flags is_consolidated and is_corrigendum, and corrigenda join only under include_corrigenda, consolidated texts of a document_type only under include_consolidated
No match returns an empty page with a notice naming the filters and how to broaden them; typed errors: no_filters, invalid_date_range, invalid_author_institution and invalid_keyword (no letters or digits)

`eurlex_get_document` _tool

Exactly one of celex_number, eli_uri, or work_uri, served as the work the CELEX resolves to (see eurlex_lookup_celex); a work_uri carrying several CELEX numbers (a national implementing measure) serves its lowest, with a notice giving the count; body as html (default), markdown, or xml (Formex4) in any of the 24 EUR-Lex languages, falling back to English; title is in the language served, or English when CELLAR has none in that language
author_institution(s) name each author by the English label of its CELLAR authority code — an EU institution or body (European Union, Council of the European Union), a member state (Netherlands), an MEP (VAN MIERT), or a national court — the same labels eurlex_search_documents accepts as author_institution; case law lists its advocates_general apart
Case law also carries its ecli (the one eurlex_lookup_celex reports) and its English CELLAR title, in every language, parsed as eurlex_get_cases parses it: title is the parties (the court/AG descriptor when there are none), with formation, referring_court, subject_matter, and case_reference alongside, or the raw #-joined title when the parse misses part of it
content_mode "paged" (default), "full", or "metadata_only", every body capped at 100,000 characters per call with content_chars_total/has_more to page on; outline: true lists chapter/section/article/annex headings with offsets, the preamble's recitals as one Recitals 1–173 entry (include_recitals: true lists each), and select (e.g. { articles: "1,5,17" }) returns just those sections, each source character once, under the same cap with no offset/limit, with selected_sections giving each one's own offset/chars for a paged read. Headings are read in the language served and labelled in English in every format (Article 4, CHAPTER IV); a selector number may carry an English kind word or the served language's (Artikel 4, 4. cikk). Headings of text an amending act inserts into another act are not the act's own and are skipped
For a judgment, order, or AG opinion, outline lists each top-level section heading as served (Legal context, Sur les dépens), numbered by position, and a judgment's or order's ruling as one operative_part entry; select: { headings: "2" } returns a headed section up to the next heading, and select: { operative_part: true } the ruling alone to the end: from "On those grounds, …" in a modern body, from the "Operative part" section in a legacy one. Headings come from the body's heading markup in each CELLAR html generation and in Formex, so html, Markdown, and xml get the same outline; a summary-only body and some AG opinions carry no heading markup and outline empty
is_superseded says whether a newer consolidated version than the text served is in effect (false on the newest one, and on a consolidated version dated after it that does not apply yet), with current_consolidated_celex/consolidated_as_of naming that version; resolve: "current_consolidated" serves it, for a base act or any of its consolidated texts; when no consolidated version is in effect yet, a notice says a future-dated consolidated text does not apply yet, or that resolve served the base act
in_force: false comes with its reason where CELLAR records one: repealed_by (CELEX of the explicitly repealing acts), end_of_validity (omitted when open-ended; a future date on an act not yet in force), or entry_into_force (the earliest date, when still ahead)
A consolidated text keeps its own title, date, and type and reports its base act as base_act_celex, with that act's authors, in_force and its reason, legal basis, and EuroVoc subjects; typed errors: invalid_identifier_args, not_found, content_challenge (a WAF bot-challenge in place of text)

`eurlex_lookup_celex` _tool

A CELEX number, ELI URI, ECLI, or OJ citation naming its act type and year (Regulation (EU) 2016/679, Regulation (EC) No 1049/2001, Directive 95/46/EC, Council Framework Decision 2002/584/JHA), parsed to its CELEX under identifier_type: "auto": No before the numbers means number/year, a two-digit year is 19YY, and the act type sets the CELEX letter (an ECSC Decision is S, a Framework Decision F, a Joint Action or Common Position E); a citation without its act type (95/46/EC) or year (Regulation No 17) is not parsed
identifier_type auto-detects the format or sets it, and ambiguous_identifier fires when auto-detection can't classify the input, its recovery listing the accepted forms
Returns work URI, confirmed CELEX number, resource type, date, and the case's ECLI (recorded on any work holding the CELEX); found: false for a well-formed identifier that matches no work, with a notice naming the CELEX, ELI, or ECLI tried and pointing to eurlex_search_documents
A CELEX held by several works resolves to the one owl:sameAs its http://publications.europa.eu/resource/celex/{CELEX} IRI, which EUR-Lex serves the text from, else the lowest work URI, and every CELEX-taking tool and resource resolves the same way; an ECLI shared by several records resolves to the primary record with the lowest CELEX

`eurlex_get_cases` _tool

Filters: case_number (one case per value — C-131/12, T-22/20, F-12/05, or a pre-1989 26/62 — reaching every judgment, order, and AG opinion filed under it), court (CJEU or GC, by CELEX court letter), case_type (judgment, order, ag_opinion), keyword (English titles, plus CELEX numbers: a whole CELEX with its (01)–(20) siblings and _INF/_RES/_SUM/_EXT records, a partial one such as 2013CJ0131 or J0131 through the CELEX full-text index, one opening with letters no digit follows by a scan of every CELEX), and date_from/date_to; primary records only unless include_derivative adds notices, abstracts, summaries, and corrigenda
Pages of up to 100 via offset/limit, newest first with the CELEX breaking date ties, so a page is the same on every call; each case carries its ECLI where CELLAR records one, plus formation, advocate_general, display_title, parties, referring_court, subject_matter, and case_reference parsed from the CELLAR title; the raw title comes back only when those fields miss part of it (an unrecognized segment, an "(Extracts)" marker, or a title date that differs from the case date)
No match returns an empty page with a notice naming the filters and how to broaden them; typed errors: invalid_case_number, invalid_date_range, invalid_keyword (no letters or digits)

`eurlex_get_relations` _tool

Exactly one of celex_number or work_uri; relation_types narrows to any of cites, amends, amended_by, repeals, repealed_by, implicitly_repeals, implicitly_repealed_by, legal_basis, consolidated_version, national_transposition (omit for all)
One hop, paged per relation type and direction via offset/limit (max 100, default 100), newest first with the work URI breaking ties, so a page is the same on every call; undated works come last
Each relation carries relation_type, direction (outgoing/incoming), related_work_uri, related_celex_number when known, related_date (the date the page is ordered by) and related_title (the English title, whole) when the work has them, and on national_transposition rows related_member_state (ISO 3166-1 alpha-3, GBR for the United Kingdom) — national measures rarely carry an English title, and no other language stands in; empty_relation_types separates "no edges of this type" from "paged out", a work with no edges of the requested types returns an empty page with a notice, and typed errors are invalid_identifier_args and not_found

`eurlex_browse_subjects` _tool

Matches preferred and alternative EuroVoc labels, so a common synonym resolves to its concept, in any EU official language (default English); offset/limit pagination (max 50)
Returns concept URI, preferred label, code, broader (parent) label, and the alternative label that matched when one did; an empty page with a notice when nothing matches
Exact label matches rank first, then label or word-start matches, then other substring matches, so "AI" leads with artificial intelligence

`eurlex_query_sparql` _tool

Read-only SELECT only — update forms and ASK/CONSTRUCT/DESCRIBE are rejected before execution; cdm:, skos:, and xsd: prefixes are auto-injected
Results capped at 100 rows; optional timeout_hint (1000–55000 ms) under the endpoint's 60-second hard limit
A zero-row result whose query has an untyped string literal as a triple object carries a notice to type it (^^xsd:string, ^^xsd:anyURI for an ELI) or language-tag it; the query itself is sent unchanged
Typed errors: not_read_only (a SPARQL Update), unsupported_query_form (ASK, CONSTRUCT, DESCRIBE, or no SELECT), sparql_error, sparql_timeout

`eurlex://document/{celexNumber}` _resource

Metadata snapshot as application/json — resource type, author institution(s) labelled as eurlex_get_document labels them, Advocates General, date, English title, in-force flag, legal basis, EuroVoc subjects; a consolidated text adds base_act_celex and reads authors, in-force flag, legal basis, and subjects from that act
celexNumber comes from eurlex_search_documents, eurlex_get_cases, or eurlex_lookup_celex

`eurlex://document/{celexNumber}/relations` _resource

One-hop relationship summary — amendment chain, consolidations, national transposition (each measure's related_member_state included), legal basis, citations — each related work with its related_date and English related_title where it has them, capped at 25 per relation type and direction, keeping the newest
truncated plus a continuation pointer to eurlex_get_relations when more relations exist

`eurlex_comparative_analysis` _prompt

Arguments: domain required; focus optional, folded into its matching analysis axis or added as its own section
Returns a research plan chaining eurlex_browse_subjects → eurlex_search_documents → eurlex_get_document → eurlex_get_relations for the EU side and courtlistener_search_opinions for the US side, plus a six-axis analysis framework

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

EUR-Lex-specific:

No API key required — CELLAR SPARQL and the EUR-Lex REST content endpoints are both publicly accessible
SPARQL is POSTed with CDM prefix declarations built in; server-side LIMIT enforcement (max 100) guards against Virtuoso timeouts
Act text is fetched via CELLAR content negotiation (/resource/celex/{CELEX}); HTML passes through as served; Formex4 XML passes through for a single-part act and is assembled into one document from the parts of a multi-part act (HTTP 300 streams) or a zipped Formex package; Markdown is converted server-side
Virtuoso errors (HTTP 200 with a Virtuoso 37000 Error body) are classified and re-raised as ServiceUnavailable or ValidationError
Automatic English fallback when a requested translation is unavailable, with requested/effective language reported

Agent-friendly output:

EuroVoc prerequisite guidance in server-level instructions — agents are directed to eurlex_browse_subjects before concept-filtered searches
eurlex_lookup_celex confirms CELEX/ELI/ECLI existence upfront, preventing downstream errors in document or relation fetches
content_status, content_unavailability_reason, and requested/effective language fields distinguish skipped, available, absent, upstream-failed, and incomplete content without string parsing
Typed reason codes on every tool's error contract let agents branch on outcomes programmatically

Getting started

Public Hosted Instance

A public instance is available at https://eur-lex.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP:

json

{
  "mcpServers": {
    "eur-lex-mcp-server": {
      "type": "streamable-http",
      "url": "https://eur-lex.caseyjhand.com/mcp"
    }
  }
}

Self-Hosted / Local

Add the following to your MCP client configuration file. No API key is required.

json

{
  "mcpServers": {
    "eur-lex-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/eur-lex-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Or with npx (no Bun required):

json

{
  "mcpServers": {
    "eur-lex-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/eur-lex-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Or with Docker:

json

{
  "mcpServers": {
    "eur-lex-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_TRANSPORT_TYPE=stdio",
        "ghcr.io/cyanheads/eur-lex-mcp-server:latest"
      ]
    }
  }
}

For Streamable HTTP, set the transport and start the server:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
# Server listens at http://localhost:3010/mcp

Prerequisites

Bun v1.4.0 or higher (or Node.js v24+).
No API key needed — EUR-Lex and CELLAR are publicly accessible.

Installation

Clone the repository:

git clone https://github.com/cyanheads/eur-lex-mcp-server.git

Navigate into the directory:

cd eur-lex-mcp-server

Install dependencies:

bun install

Configure environment (optional):

cp .env.example .env
# All server-specific vars have sensible defaults — no required vars

Configuration

All configuration is validated at startup via Zod schemas in src/config/server-config.ts.

Variable	Description	Default
`CELLAR_SPARQL_ENDPOINT`	CELLAR SPARQL endpoint URL override (e.g., for a local Virtuoso mirror).	`http://publications.europa.eu/webapi/rdf/sparql`
`EURLEX_CONTENT_BASE_URL`	EU Publications Office CELLAR content resolver base URL override.	`http://publications.europa.eu`
`SPARQL_QUERY_TIMEOUT_MS`	Client-side timeout for SPARQL requests in milliseconds.	`55000`
`MAX_SPARQL_RESULTS`	Enforced ceiling on LIMIT in all generated SPARQL queries.	`100`
`MCP_TRANSPORT_TYPE`	Transport: `stdio` or `http`.	`stdio`
`MCP_HTTP_PORT`	Port for HTTP server.	`3010`
`MCP_AUTH_MODE`	Auth mode: `none`, `jwt`, or `oauth`.	`none`
`MCP_SESSION_MODE`	Session handling: `stateful`, `stateless`, or `auto` (`auto` resolves to stateful).	`stateless`
`MCP_LOG_LEVEL`	Log level (RFC 5424).	`info`
`LOGS_DIR`	Directory for log files (Node.js only).	`<project-root>/logs`
`OTEL_ENABLED`	Enable OpenTelemetry instrumentation.	`false`

See .env.example for the full list of optional overrides.

Running the server

Local development

Build and run:

# One-time build
bun run rebuild

# Run the built server
bun run start:stdio
# or
bun run start:http

Run checks and tests:

bun run devcheck   # Lint, format, typecheck, security
bun run test       # Vitest test suite
bun run lint:mcp   # Validate MCP definitions against spec

Docker

docker build -t eur-lex-mcp-server .
docker run --rm -p 3010:3010 eur-lex-mcp-server

The Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/eur-lex-mcp-server. OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.

Project structure

Directory	Purpose
`src/index.ts`	`createApp()` entry point — registers tools, resources, and prompts; initializes services.
`src/config`	Server-specific environment variable parsing and validation with Zod.
`src/services/cellar-sparql`	CELLAR SPARQL service — POST client, binding mapper, LIMIT enforcement, CDM PREFIX declarations.
`src/services/eurlex-content`	CELLAR content service — content-negotiation GET client for `/resource/celex/{CELEX}` (`Accept` / `Accept-Language`) with English language fallback, and an in-process cache of served bodies so paging an act fetches it once.
`src/mcp-server/tools`	Tool definitions (`*.tool.ts`). Seven tools across document search, retrieval, resolution, case law, relations, EuroVoc, and raw SPARQL.
`src/mcp-server/resources`	Resource definitions (`*.resource.ts`). Metadata and relations resources.
`src/mcp-server/prompts`	Prompt definitions (`*.prompt.ts`). Comparative analysis prompt.
`tests/`	Unit and integration tests mirroring `src/`.

Development guide

See CLAUDE.md for development guidelines and architectural rules. The short version:

Handlers throw, framework catches — no try/catch in tool logic
Use ctx.log for request-scoped logging, ctx.state for tenant-scoped storage
Register new tools and resources via the barrels in src/mcp-server/*/definitions/index.ts
Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields

Contributing

Issues are welcome. Run checks and tests before submitting:

bun run devcheck
bun run test

License

Apache-2.0 — see LICENSE for details.

Install

Tools (7)

eurlex_lookup_celexeurlex_browse_subjectseurlex_search_documentseurlex_get_caseseurlex_get_documenteurlex_get_relationseurlex_query_sparql

Configuration

Environment variables

CELLAR_SPARQL_ENDPOINTdefault http://publications.europa.eu/webapi/rdf/sparql

CELLAR SPARQL endpoint URL override (e.g., for a local Virtuoso mirror).

EURLEX_CONTENT_BASE_URLdefault http://publications.europa.eu

Base URL of the EU Publications Office CELLAR content-negotiation resolver that serves act full text; override e.g. for a local mirror.

SPARQL_QUERY_TIMEOUT_MSdefault 55000

Client-side timeout for SPARQL requests in milliseconds.

MAX_SPARQL_RESULTSdefault 100

Enforced ceiling on LIMIT in all generated SPARQL queries.

MCP_LOG_LEVELdefault info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_HTTP_HOSTdefault 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault /mcp

The endpoint path for the MCP server.

MCP_PUBLIC_URL

Public origin for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).

MCP_AUTH_MODEdefault none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "eur-lex-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/eur-lex-mcp-server@0.18.1",
        "run",
        "start:stdio"
      ],
      "env": {
        "CELLAR_SPARQL_ENDPOINT": "http://publications.europa.eu/webapi/rdf/sparql",
        "EURLEX_CONTENT_BASE_URL": "http://publications.europa.eu",
        "SPARQL_QUERY_TIMEOUT_MS": "55000",
        "MAX_SPARQL_RESULTS": "100",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

@cyanheads/eur-lex-mcp-server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

eurlex_lookup_celex

eurlex_browse_subjects

eurlex_search_documents

eurlex_get_cases

eurlex_get_document

eurlex_get_relations

eurlex_query_sparql

@cyanheads/eur-lex-mcp-server

Overview

Tools

Resources

Prompts

Capability reference

eurlex_search_documents tool

eurlex_get_document tool

eurlex_lookup_celex tool

eurlex_get_cases tool

eurlex_get_relations tool

eurlex_browse_subjects tool

eurlex_query_sparql tool

eurlex://document/{celexNumber} resource

eurlex://document/{celexNumber}/relations resource

eurlex_comparative_analysis prompt

Features

Getting started

Public Hosted Instance

Self-Hosted / Local

Prerequisites

Installation

Configuration

Running the server

Local development

Docker

Project structure

Development guide

Contributing

License

Install

Configuration

Related servers

`eurlex_search_documents` _tool

`eurlex_get_document` _tool

`eurlex_lookup_celex` _tool

`eurlex_get_cases` _tool

`eurlex_get_relations` _tool

`eurlex_browse_subjects` _tool

`eurlex_query_sparql` _tool

`eurlex://document/{celexNumber}` _resource

`eurlex://document/{celexNumber}/relations` _resource

`eurlex_comparative_analysis` _prompt