Eu Sparql MCP server

mcp-eu-sparql

Installation (one command)

Published on npm + the MCP Registry (io.github.matematicsolutions/mcp-eu-sparql). Run without cloning:

npx -y @matematicsolutions/mcp-eu-sparql

MCP client configuration (stdio):

{ "mcpServers": { "mcp-eu-sparql": { "command": "npx", "args": ["-y", "@matematicsolutions/mcp-eu-sparql"] } } }

(Building from source - below.)

MCP server for EU law and CJEU case law via the Publications Office SPARQL endpoint (Cellar / EUR-Lex), plus national data-protection authority decisions via GDPRhub.

CJEU corpus in Cellar (SPARQL COUNT, 2026-07-08): 34,261 judgments (JUDG), 8,362 orders (ORDER), 14,480 Advocate-General opinions (OPINAG)** - 57,103 judgments and opinions in total, each with CELEX + ECLI.

Tools

(e.g. 32016R0679 = GDPR, 62018CJ0311 = Schrems II).

• searchbycelex(celex, lang?) - act or judgment by CELEX number

judgments (JUDG), orders (ORDER) and Advocate-General opinions (OPIN_AG) of the Court of Justice of the EU; optional keyword in the title (parties to the case, case number, keywords of the judgment).

• searchbydaterange(datefrom, dateto, documenttype?, lang?, limit?)
• acts within a date range, optionally narrowed to a type (REG / DIR / DEC / RECO / OPIN).
• searchcjeu(query?, datefrom?, dateto?, documenttype?, lang?, limit?) -

identifier (e.g. ECLI:EU:C:2020:559 = Schrems II).

• searchcjeubyecli(ecli, lang?)** - CJEU judgment by ECLI

GDPRhub (the noyb project wiki): decisions of national data-protection authorities across the EU + commentary on GDPR articles. Content license: CC BY-NC-SA 4.0 - flagged in the license field of every citation.

• searchgdprhub(query, limit?)** - full-text search in

Every response includes structuredContent.citations with the fields title, url, celex?, ecli?, publicationdate?, documenttype?, snippet?, license? - Patron reads this field and renders it in the UI panel as the "EU legal acts (EUR-Lex / CJEU)" section.

Stack

with format=application/sparql-results+json; GET to https://gdprhub.eu/api.php (MediaWiki API)

• Node 18+
• @modelcontextprotocol/sdk
• Stdio transport (like mcp-saos)
• Backend: HTTP POST to https://publications.europa.eu/webapi/rdf/sparql

Build + run

npm install
npm run build
node dist/index.js   # starts the server on stdio

Wiring into Patron

In patron/backend/mcp-servers.json:

[
  {
    "name": "saos",
    "transport": "stdio",
    "command": "node",
    "args": ["C:/Users/<YOUR-USER>/mcp-saos/dist/index.js"]
  },
  {
    "name": "eu-sparql",
    "transport": "stdio",
    "command": "node",
    "args": ["C:/Users/<YOUR-USER>/mcp-eu-sparql/dist/index.js"]
  }
]

Tests

npm run drift          # offline: INSTRUCTIONS consistent with TOOLS and ErrorCode
npm run test:offline   # offline: query builders + parsers on fixtures (no network)
npm run smoke          # live: all 5 tools against Cellar + GDPRhub

License

MIT.

Part of MateMatic

This connector queries its source live. It is one of the Polish and EU source connectors bundled in PATRON and works with any MCP client.

Shortened. The full README is on GitHub.