Skip to main content
Glama

es-eli-mcp

Install (one command)

As a Claude plugin (Claude Code or the desktop app, needs uv); see plugin/README.md for what it sends and stores:

/plugin marketplace add matematicsolutions/es-eli-mcp
/plugin install es-eli-mcp@es-eli-mcp

Published on PyPI + MCP Registry (io.github.matematicsolutions/es-eli-mcp). Run without cloning:

uvx es-eli-mcp

Configure your MCP client (stdio):

{ "mcpServers": { "es-eli-mcp": { "command": "uvx", "args": ["es-eli-mcp"] } } }

Windows 11 with Smart App Control

Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe and the es-eli-mcp.exe launcher that pip writes at install time. The python.exe and py.exe from the python.org installer are signed by the Python Software Foundation, so running the module through the interpreter works:

python -m pip install es-eli-mcp
python -m es_eli_mcp

pip.exe is blocked for the same reason, so install with python -m pip, not pip install. If python is not on PATH, use the Windows launcher: py -3 -m es_eli_mcp.

{ "mcpServers": { "es-eli-mcp": { "command": "python", "args": ["-m", "es_eli_mcp"] } } }

Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.

Building from source: see Install.

An MCP server for five Spanish open-data sources:

  1. BOE (Boletin Oficial del Estado) open-data API - consolidated legislation. Given a BOE id or a date in the official gazette, returns metadata, structure and full consolidated text, with verifiable ELI identifiers and Spanish citations.

  2. Tribunal Constitucional (Sistema HJ / hj.tribunalconstitucional.es) - Spain's Constitutional Court case law (Sentencias / Autos / Declaraciones). Given an internal resolution id, or a citation number+year (e.g. "STC 31/2010"), returns the full ruling with ECLI and a Spanish doctrinal citation.

  3. DGT (Direccion General de Tributos, petete.tributos.hacienda.gob.es) - binding tax rulings: ~69,500 consultas vinculantes + ~19,700 consultas generales (live-counted 2026-07-08). Full-text/date search plus the full ruling text by NUM-CONSULTA (e.g. "V0001-25").

  4. TEAC (Tribunales Economico-Administrativos, DYCTEA) - ~6,500 doctrine criterios with the full resolution text inline, searched by RG claim-number segments and/or date range.

  5. AEPD (Agencia Espanola de Proteccion de Datos) - ~46,800 data-protection resolutions with Solr full-text search and a verified PDF permalink per expediente (e.g. "PS-00615-2025").

Part of the MateMatic eu-legal-mcp production line - after PL, DE and AT. Same citation contract pattern, five Spanish sources.

Free-text search exists on DGT and AEPD only. The BOE open-data keyword-search endpoint (/legislacion-consolidada) currently returns a server-side error; the Tribunal Constitucional site only supports structured search (citation number+year, ECLI, magistrado, materia); DYCTEA accepts text-looking parameters but silently ignores them (verified live). Discover BOE documents via es_browse_gazette (by date) or a known BOE id / ELI; TC rulings via es_search_constitutional; TEAC criterios via RG segments or dates. Every response carries a dataset_note.

Licence. Both sources are official public information published as Spanish PSI (public-sector information) open data; reuse presumes acceptance of the respective reuse conditions. This connector relays that public content with attribution and a source_url.

Related MCP server: Spanish Public Data MCP

The tools

Tool

What it does

es_browse_gazette

List documents published in the BOE on a date (YYYYMMDD) - discovery.

es_get_act

Metadata for a BOE id (eli_uri, official titulo, source).

es_get_index

The block index (articles, titles) of a consolidated law.

es_get_text

Consolidated text (XML), whole or by block.

es_get_constitutional_ruling

Tribunal Constitucional ruling by internal resolution id.

es_search_constitutional

Resolve a citation (numero+anno, e.g. 31/2010) to the full TC ruling.

es_search_tax_rulings

Full-text/date search over DGT consultas (vinculantes or generales).

es_get_tax_ruling

Full DGT ruling (facts, question, normativa, answer) by NUM-CONSULTA.

es_search_teac_doctrine

TEAC criterios by RG segments and/or resolution-date range.

es_get_teac_criterio

Full TEAC criterio + resolution text by DYCTEA id.

es_search_aepd_resolutions

Full-text/date search over AEPD resolutions.

es_get_aepd_resolution

AEPD resolution + verified full-text PDF permalink by expediente.

es_coverage

Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback.

Every BOE response carries the contract: eli_uri (a full ELI URL, e.g. https://www.boe.es/eli/es/lo/2018/12/05/3), human_readable_citation (the official titulo), and source_url.

Every Tribunal Constitucional response carries: ecli (e.g. ECLI:ES:TC:2010:31 - TC case law has no ELI, ELI covers legislation only), human_readable_citation (Spanish doctrinal convention, e.g. "STC 31/2010, de 28 de junio"), and source_url.

Install

cd es-eli-mcp
pip install -e .

Configure (Claude Code / any MCP client)

{
  "mcpServers": {
    "es-eli-mcp": { "command": "es-eli-mcp" }
  }
}

Environment:

  • ES_ELI_BASE_URL - default https://www.boe.es/datosabiertos/api

  • ES_ELI_TC_BASE_URL - default https://hj.tribunalconstitucional.es

  • ES_ELI_DGT_BASE_URL - default https://petete.tributos.hacienda.gob.es

  • ES_ELI_TEAC_BASE_URL - default https://serviciostelematicosext.hacienda.gob.es/TEAC/DYCTEA

  • ES_ELI_AEPD_BASE_URL - default https://www.aepd.es

  • ES_ELI_CACHE_DIR - default ~/.matematic/cache/es-eli

  • ES_ELI_AUDIT_DIR - default ~/.matematic/audit

No API key. All five sources are keyless.

Governance

  • Public data only - read-only against the five official sources; no client data leaves the machine.

  • Audit log - every tool call appends one JSON line to ~/.matematic/audit/es-eli-mcp.jsonl.

  • Network - the server talks to the official *.boe.es / *.tribunalconstitucional.es / *.hacienda.gob.es / *.aepd.es hosts and the local filesystem. Once, on first use, it also fetches a small configuration file (es-runtime.json.gz, updated source addresses) from this repository's GitHub Releases. That request carries no query content; GitHub's download counter for the file is the only usage signal we see. ES_ELI_RUNTIME_URL="" turns it off; the Claude plugin ships with it off. No LLM provider, no other telemetry.

  • Verifiable citations - every response is independently checkable via source_url.

See CONSTITUTION.md and DISCOVERY.md.

Tests

pip install -e ".[dev]"
pytest tests/ --ignore=tests/test_smoke.py -v   # offline (fixtures)
pytest tests/test_smoke.py -v                   # hits live BOE + TC + DGT + TEAC + AEPD

Licence

Apache-2.0. © Matematic Solutions / Wieslaw Mazur.

Available Tools

13 tools
es_browse_gazetteA
Read-onlyIdempotent

List documents published in the official BOE gazette on a date.

Inputs: date (required). Returns: Result of ``es_browse_gazette``.

es_coverageA
Read-onlyIdempotent

Declare what this connector covers, how it is sourced, and what it does NOT cover.

Call this before telling a user that the law "does not contain" something, and whenever a search comes back empty: the absence may be a gap in this connector rather than in the law. Every gap carries a fallback saying where to look instead.

Returns: Coverage with families, an as-of note, and a non-empty list of known gaps.

Inputs: no named parameters. Returns: What this connector covers, how it is sourced, and what it does not cover.

es_get_actA
Read-onlyIdempotent

Fetch consolidated-law metadata from BOE by id.

Inputs: boe_id (required). Returns: A consolidated BOE law (from /metadatos).

es_get_aepd_resolutionA
Read-onlyIdempotent

Resolve an AEPD expediente number to its resolution and full-text PDF permalink.

Inputs: expediente (required). Returns: One AEPD resolution teaser (search hit or es_get_aepd_resolution result).

es_get_constitutional_rulingA
Read-onlyIdempotent

Fetch a Tribunal Constitucional ruling (Sentencia/Auto/Declaracion) by internal id.

Inputs: resolution_id (required). Returns: A Tribunal Constitucional resolution (Sentencia / Auto / Declaracion).

es_get_indexA
Read-onlyIdempotent

List the block index (articles, titles) of a consolidated law.

Inputs: boe_id (required). Returns: Result of ``es_get_index``.

es_get_tax_rulingA
Read-onlyIdempotent

Fetch a full DGT tax ruling by its official number.

Inputs: numero_consulta (required). Returns: A full DGT consulta (result of ``es_get_tax_ruling``).

es_get_teac_criterioA
Read-onlyIdempotent

Fetch one TEAC criterio (with the full resolution text) by its DYCTEA id.

Inputs: criterio_id (required). Returns: A full DYCTEA criterio (result of ``es_get_teac_criterio``).

es_get_textA
Read-onlyIdempotent

Fetch the consolidated text (XML) of a law, whole or by block.

Inputs: boe_id (required), block_id. Returns: Result of ``es_get_text`` (consolidated text, XML).

es_search_aepd_resolutionsA
Read-onlyIdempotent

Search AEPD (Spanish DPA) resolutions by full text and/or signature date.

Inputs: page, texto, fecha_desde, fecha_hasta. Returns: Result of ``es_search_aepd_resolutions``.

es_search_constitutionalA
Read-onlyIdempotent

Resolve a Tribunal Constitucional citation (number + year) to the full ruling.

Inputs: anno (required), numero (required), tipo. Returns: A Tribunal Constitucional resolution (Sentencia / Auto / Declaracion).

es_search_tax_rulingsA
Read-onlyIdempotent

Search DGT tax rulings (consultas tributarias) by free text and/or date.

Inputs: page, texto, database, fecha_desde, +1 more. Returns: Result of ``es_search_tax_rulings``.

es_search_teac_doctrineA
Read-onlyIdempotent

Search TEAC doctrine (DYCTEA criterios) by RG segments and/or date range.

Inputs: anno, page, sede, numero, +2 more. Returns: Result of ``es_search_teac_doctrine``.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools follow a clear search/get pair per legal source, but es_get_act and es_get_text could be momentarily confused (metadata vs. full text). Overall each tool targets a distinct resource/action, so mis-selection risk is low.

    Naming Consistency5/5

    All tools share the es_ prefix and use a consistent verb_resource structure (es_get_*, es_search_*, es_browse_gazette, es_coverage). The naming pattern is uniform across all 13 tools.

    Tool Count5/5

    13 tools is well-scoped for a multi-source legal connector covering BOE, TC, DGT, TEAC, and AEPD. Each tool earns its place and the count is neither thin nor bloated.

    Completeness4/5

    Each legal domain has both a search/resolution and a fetch tool, and BOE laws have metadata/index/text retrieval. Minor gaps like no free-text law search or direct gazette document fetch exist but are workable via browse and coverage fallbacks.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for accessing Uruguay's IMPO open data API with SQLite caching. Provides tools to retrieve legal norms, search regulations, and access schema documentation from Uruguay's official legal database.
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for querying Spanish government open data APIs including grants, legislation, company registry, statistics, and open data catalog. Enables LLMs to access Spanish public information on-the-fly.
      26
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A community-maintained MCP server that simplifies access to EU legal and legislative data from the CELLAR service, supporting lookups, metadata retrieval, relation checks, and monitoring.
      2
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      MCP server for Spain's official BOE auction portal: search judicial foreclosures, notarial and tax-agency auctions, get consolidated per-auction detail (assets, lots, bids, authority contacts) and computed legal thresholds (art. 671 LEC). Clean JSON, GDPR-safe, no headless browser.
      3
      AGPL 3.0