{
  "markdown": "# es-eli-mcp\n\n<!-- mcp-name: io.github.matematicsolutions/es-eli-mcp -->\n\n\n## Install (one command)\n\nPublished on PyPI + MCP Registry (`io.github.matematicsolutions/es-eli-mcp`). Run without cloning:\n\n```bash\nuvx es-eli-mcp\n```\n\nConfigure your MCP client (stdio):\n\n```json\n{ \"mcpServers\": { \"es-eli-mcp\": { \"command\": \"uvx\", \"args\": [\"es-eli-mcp\"] } } }\n```\n\n### Windows 11 with Smart App Control\n\nSmart App Control blocks unsigned executables, which covers `uvx.exe`, `pip.exe`\nand the `es-eli-mcp.exe` launcher that pip writes at install time. The `python.exe` and\n`py.exe` from the python.org installer are signed by the Python Software\nFoundation, so running the module through the interpreter works:\n\n```bash\npython -m pip install es-eli-mcp\npython -m es_eli_mcp\n```\n\n`pip.exe` is blocked for the same reason, so install with `python -m pip`, not\n`pip install`. If `python` is not on PATH, use the Windows launcher: `py -3 -m es_eli_mcp`.\n\n```json\n{ \"mcpServers\": { \"es-eli-mcp\": { \"command\": \"python\", \"args\": [\"-m\", \"es_eli_mcp\"] } } }\n```\n\nDo not turn Smart App Control off to work around this - it cannot be re-enabled\nwithout reinstalling Windows.\n\nBuilding from source: see [Install](#install).\n\nAn MCP server for five Spanish open-data sources:\n\n1. **BOE** (Boletin Oficial del Estado) open-data API - consolidated legislation. Given a BOE id\n   or a date in the official gazette, returns metadata, structure and full consolidated text,\n   with verifiable ELI identifiers and Spanish citations.\n2. **Tribunal Constitucional** (Sistema HJ / `hj.tribunalconstitucional.es`) - Spain's\n   Constitutional Court case law (Sentencias / Autos / Declaraciones). Given an internal\n   resolution id, or a citation number+year (e.g. \"STC 31/2010\"), returns the full ruling with\n   ECLI and a Spanish doctrinal citation.\n3. **DGT** (Direccion General de Tributos, `petete.tributos.hacienda.gob.es`) - binding tax\n   rulings: ~69,500 consultas vinculantes + ~19,700 consultas generales (live-counted\n   2026-07-08). Full-text/date search plus the full ruling text by NUM-CONSULTA (e.g.\n   \"V0001-25\").\n4. **TEAC** (Tribunales Economico-Administrativos, DYCTEA) - ~6,500 doctrine criterios with the\n   full resolution text inline, searched by RG claim-number segments and/or date range.\n5. **AEPD** (Agencia Espanola de Proteccion de Datos) - ~46,800 data-protection resolutions\n   with Solr full-text search and a verified PDF permalink per expediente (e.g.\n   \"PS-00615-2025\").\n\nPart of the MateMatic `eu-legal-mcp` production line - after PL, DE and AT. Same citation\ncontract pattern, five Spanish sources.\n\n> **Free-text search exists on DGT and AEPD only.** The BOE open-data keyword-search endpoint\n> (`/legislacion-consolidada`) currently returns a server-side error; the Tribunal\n> Constitucional site only supports structured search (citation number+year, ECLI, magistrado,\n> materia); DYCTEA accepts text-looking parameters but silently ignores them (verified live).\n> Discover BOE documents via `es_browse_gazette` (by date) or a known BOE id / ELI; TC rulings\n> via `es_search_constitutional`; TEAC criterios via RG segments or dates. Every response\n> carries a `dataset_note`.\n>\n> **Licence.** Both sources are official public information published as Spanish PSI\n> (public-sector information) open data; reuse presumes acceptance of the respective reuse\n> conditions. This connector relays that public content with attribution and a `source_url`.\n\n## The tools\n\n| Tool | What it does |\n|---|---|\n| `es_browse_gazette` | List documents published in the BOE on a date (`YYYYMMDD`) - discovery. |\n| `es_get_act` | Metadata for a BOE id (eli_uri, official `titulo`, source). |\n| `es_get_index` | The block index (articles, titles) of a consolidated law. |\n| `es_get_text` | Consolidated text (XML), whole or by block. |\n| `es_get_constitutional_ruling` | Tribunal Constitucional ruling by internal resolution id. |\n| `es_search_constitutional` | Resolve a citation (numero+anno, e.g. 31/2010) to the full TC ruling. |\n| `es_search_tax_rulings` | Full-text/date search over DGT consultas (vinculantes or generales). |\n| `es_get_tax_ruling` | Full DGT ruling (facts, question, normativa, answer) by NUM-CONSULTA. |\n| `es_search_teac_doctrine` | TEAC criterios by RG segments and/or resolution-date range. |\n| `es_get_teac_criterio` | Full TEAC criterio + resolution text by DYCTEA id. |\n| `es_search_aepd_resolutions` | Full-text/date search over AEPD resolutions. |\n| `es_get_aepd_resolution` | AEPD resolution + verified full-text PDF permalink by expediente. |\n| `es_coverage` | Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |\n\nEvery BOE response carries the contract: `eli_uri` (a full ELI URL, e.g.\n`https://www.boe.es/eli/es/lo/2018/12/05/3`), `human_readable_citation` (the official\n`titulo`), and `source_url`.\n\nEvery Tribunal Constitucional response carries: `ecli` (e.g. `ECLI:ES:TC:2010:31` - TC case law\nhas no ELI, ELI covers legislation only), `human_readable_citation` (Spanish doctrinal\nconvention, e.g. \"STC 31/2010, de 28 de junio\"), and `source_url`.\n\n## Install\n\n```bash\ncd es-eli-mcp\npip install -e .\n```\n\n## Configure (Claude Code / any MCP client)\n\n```json\n{\n  \"mcpServers\": {\n    \"es-eli-mcp\": { \"command\": \"es-eli-mcp\" }\n  }\n}\n```\n\nEnvironment:\n\n- `ES_ELI_BASE_URL` - default `https://www.boe.es/datosabiertos/api`\n- `ES_ELI_TC_BASE_URL` - default `https://hj.tribunalconstitucional.es`\n- `ES_ELI_DGT_BASE_URL` - default `https://petete.tributos.hacienda.gob.es`\n- `ES_ELI_TEAC_BASE_URL` - default `https://serviciostelematicosext.hacienda.gob.es/TEAC/DYCTEA`\n- `ES_ELI_AEPD_BASE_URL` - default `https://www.aepd.es`\n- `ES_ELI_CACHE_DIR` - default `~/.matematic/cache/es-eli`\n- `ES_ELI_AUDIT_DIR` - default `~/.matematic/audit`\n\nNo API key. All five sources are keyless.\n\n## Governance\n\n- **Public data only** - read-only against the five official sources; no client data leaves the machine.\n- **Audit log** - every tool call appends one JSON line to `~/.matematic/audit/es-eli-mcp.jsonl`.\n- **Vendor-neutral** - talks only to the official `*.boe.es` / `*.tribunalconstitucional.es` / `*.hacienda.gob.es` / `*.aepd.es` hosts; no LLM provider, no telemetry.\n- **Verifiable citations** - every response is independently checkable via `source_url`.\n\nSee `CONSTITUTION.md` and `DISCOVERY.md`.\n\n## Tests\n\n```bash\npip install -e \".[dev]\"\npytest tests/ --ignore=tests/test_smoke.py -v   # offline (fixtures)\npytest tests/test_smoke.py -v                   # hits live BOE + TC + DGT + TEAC + AEPD\n```\n\n## Licence\n\nApache-2.0. © Matematic Solutions / Wieslaw Mazur.\n",
  "bytes": 6683,
  "sha": "f1ccbdce1541c0adbe712d21ac8f4251a4b97f0989949454233d2cc76b113a66",
  "repo_slug": "matematicsolutions/es-eli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matematicsolutions_es_eli_mcp_8d98c4ae/readme"
}