{
  "markdown": "# Spanish Law MCP Server\n\n<!-- ANSVAR-CTA-BEGIN -->\n> **The Spanish law corpus is now served through the Ansvar Gateway.** Connect your AI assistant (Claude, Copilot, Cursor, custom MCP client) to `https://gateway.ansvar.eu/mcp` — one OAuth connection, free tier available, covering this corpus plus EU regulations, national law across 28 audited jurisdictions, and CVE/security intelligence, every result with a verbatim source citation. Start at https://ansvar.eu/docs/quickstart\n\n### Connect\n\n**Claude Code** (one line):\n\n```bash\nclaude mcp add ansvar --transport http https://gateway.ansvar.eu/mcp\n```\n\n**Claude Desktop / Cursor** — add to `claude_desktop_config.json` (or `mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"ansvar\": {\n      \"type\": \"url\",\n      \"url\": \"https://gateway.ansvar.eu/mcp\"\n    }\n  }\n}\n```\n\n**Claude.ai** — Settings → Connectors → Add custom connector → paste `https://gateway.ansvar.eu/mcp`\n\nFirst request opens an OAuth signup flow (setup details: [ansvar.eu/docs/quickstart](https://ansvar.eu/docs/quickstart)). After signup, your client is bound to your account; tier (free / premium / team / company) determines fan-out, quota, and which downstream MCPs are reachable.\n\n---\n\n## Self-host this MCP\n\nYou can also clone this repo and build the corpus yourself. The schema,\nfetcher, and tool implementations all live here. What is not in the repo is\nthe pre-built database — TDM and standards-licensing constraints on the\nupstream sources mean we host the corpus on Ansvar infrastructure rather\nthan redistribute it as a public artifact.\n\nBuild your own: run this repo's ingestion script (entry-point varies per\nrepo — typically `scripts/ingest.sh`, `npm run ingest`, or `make ingest`;\ncheck the repo root).\n<!-- ANSVAR-CTA-END -->\n\n\n**The BOE (Boletín Oficial del Estado) alternative for the AI age.**\n\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![GitHub stars](https://img.shields.io/github/stars/Ansvar-Systems/spanish-law-mcp?style=social)](https://github.com/Ansvar-Systems/spanish-law-mcp)\n[![CI](https://github.com/Ansvar-Systems/spanish-law-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ansvar-Systems/spanish-law-mcp/actions/workflows/ci.yml)\n[![Daily Data Check](https://github.com/Ansvar-Systems/spanish-law-mcp/actions/workflows/check-updates.yml/badge.svg)](https://github.com/Ansvar-Systems/spanish-law-mcp/actions/workflows/check-updates.yml)\n[![Database](https://img.shields.io/badge/database-pre--built-green)](docs/EU_INTEGRATION_GUIDE.md)\n[![Provisions](https://img.shields.io/badge/provisions-297%2C760-blue)](docs/EU_INTEGRATION_GUIDE.md)\n\nQuery **12,181 Spanish statutes** -- from la LOPDGDD y el RGPD, el Código Penal, and el Estatuto de los Trabajadores to el Código Civil, la Ley de Sociedades de Capital, and more -- directly from Claude, Cursor, or any MCP-compatible client.\n\nIf you're building legal tech, compliance tools, or doing Spanish legal research, this is your verified reference database.\n\nBuilt by [Ansvar Systems](https://ansvar.eu) -- Stockholm, Sweden\n\n---\n\n## Why This Exists\n\nSpanish legal research means navigating the Boletín Oficial del Estado, regional BOCAs, and EUR-Lex, then manually reconciling between national and EU law. Whether you're:\n- A **lawyer** validating citations in a brief or contract\n- A **compliance officer** checking LOPDGDD obligations or ENS requirements\n- A **legal tech developer** building tools on Spanish law\n- A **researcher** tracing legislative provisions across 12,181 national statutes\n\n...you shouldn't need dozens of browser tabs and manual cross-referencing. Ask Claude. Get the exact provision. With context.\n\nThis MCP server makes Spanish law **searchable, cross-referenceable, and AI-readable**.\n\n---\n\n## Example Queries\n\nOnce connected, just ask naturally:\n\n- *\"¿Qué dice el artículo 6 de la LOPDGDD sobre el tratamiento de datos personales?\"*\n- *\"Búsqueda 'protección de datos' en el derecho español (LOPDGDD, RGPD)\"*\n- *\"¿Qué artículos del Código Penal regulan los delitos informáticos?\"*\n- *\"Encuentra disposiciones sobre despido improcedente en el Estatuto de los Trabajadores\"*\n- *\"What EU directives does the LOPDGDD implement?\"*\n- *\"Which Spanish laws implement the NIS2 Directive?\"*\n- *\"Valida la cita 'Art. 197 CP' (Código Penal)\"*\n- *\"Busca 'responsabilidad civil' en el Código Civil español\"*\n- *\"Compare incident notification requirements under NIS2 and the Spanish transposition\"*\n- *\"¿Está en vigor el Real Decreto-ley 14/2019 sobre medidas urgentes de administración digital?\"*\n\n---\n\n## What's Included\n\n| Category | Count | Details |\n|----------|-------|---------|\n| **Statutes** | 12,181 statutes | Comprehensive Spanish legislation from BOE |\n| **Provisions** | 297,760 articles | Full-text searchable with FTS5 |\n| **Preparatory Works** | 12,193 documents | Premium tier -- exposiciones de motivos, proyectos de ley |\n| **Case Law** | 0 (free tier) | Reserved for future ingestion |\n| **Agency Guidance** | 0 (free tier) | Reserved for future ingestion |\n| **Database Size** | ~849 MB | Optimized SQLite, portable |\n| **Daily Updates** | Automated | Freshness checks against BOE |\n\n**Verified data only** -- every citation is validated against official sources (BOE, boe.es). Zero LLM-generated content.\n\n---\n\n## See It In Action\n\n### Why This Works\n\n**Verbatim Source Text (No LLM Processing):**\n- All statute text is ingested from the BOE Datos Abiertos API (boe.es/datosabiertos)\n- Provisions are returned **unchanged** from SQLite FTS5 database rows\n- Zero LLM summarization or paraphrasing -- the database contains regulation text, not AI interpretations\n\n**Smart Context Management:**\n- Search returns ranked provisions with BM25 scoring (safe for context)\n- Provision retrieval gives exact text by statute identifier + article number\n- Cross-references help navigate without loading everything at once\n\n**Technical Architecture:**\n```\nBOE Datos Abiertos API --> Parse --> SQLite --> FTS5 snippet() --> MCP response\n                            ^                        ^\n                     Provision parser         Verbatim database query\n```\n\n### Traditional Research vs. This MCP\n\n| Traditional Approach | This MCP Server |\n|---------------------|-----------------|\n| Search BOE by statute name | Search by plain Spanish: *\"protección datos personales\"* |\n| Navigate multi-title statutes manually | Get the exact article with context |\n| Manual cross-referencing between codes | `build_legal_stance` aggregates across sources |\n| \"¿Está este artículo vigente?\" -> check manually | `check_currency` tool -> answer in seconds |\n| Find EU basis -> dig through EUR-Lex | `get_eu_basis` -> linked EU directives instantly |\n| Check BOE, EUR-Lex, AEPD separately | Daily automated freshness checks |\n| No API, no integration | MCP protocol -> AI-native |\n\n**Traditional:** Search BOE -> Download PDF -> Ctrl+F -> Cross-reference with RGPD -> Check EUR-Lex -> Repeat\n\n**This MCP:** *\"¿Qué normativa europea da base al artículo 22 de la LOPDGDD sobre decisiones automatizadas?\"* -> Done.\n\n---\n\n## Available Tools (13)\n\n### Core Legal Research Tools (8)\n\n| Tool | Description |\n|------|-------------|\n| `search_legislation` | FTS5 full-text search across 297,760 provisions with BM25 ranking |\n| `get_provision` | Retrieve specific provision by statute identifier + article number |\n| `validate_citation` | Validate citation against database (zero-hallucination check) |\n| `build_legal_stance` | Aggregate citations from statutes, preparatory works, and case law |\n| `format_citation` | Format citations per Spanish conventions (full/short/pinpoint) |\n| `check_currency` | Check if statute is in force, amended, or repealed |\n| `list_sources` | List all available statutes with metadata and data provenance |\n| `about` | Server info, capabilities, dataset statistics, and coverage summary |\n\n### EU Law Integration Tools (5)\n\n| Tool | Description |\n|------|-------------|\n| `get_eu_basis` | Get EU directives/regulations underlying a Spanish statute |\n| `get_spanish_implementations` | Find Spanish laws implementing a specific EU act |\n| `search_eu_implementations` | Search EU documents with Spanish implementation counts |\n| `get_provision_eu_basis` | Get EU law references for a specific provision |\n| `validate_eu_compliance` | Check implementation status against EU directives |\n\n---\n\n## EU Law Integration\n\nSpain is a full EU member state. Spanish law has systematic EU cross-references across data protection, cybersecurity, financial regulation, and consumer rights.\n\n| Metric | Value |\n|--------|-------|\n| **EU Integration** | Full EU member (accession 1986) |\n| **GDPR Implementation** | LOPDGDD (Ley Orgánica 3/2018, AEPD oversight) |\n| **NIS2 Transposition** | Real Decreto-ley + Ley de Seguridad de las Redes y Sistemas de Información |\n| **AI Act** | Direct application (EU regulation, no transposition needed) |\n| **ENS** | Esquema Nacional de Seguridad (Real Decreto 311/2022) |\n| **EUR-Lex Integration** | Automated metadata fetching |\n\n### Key EU Acts with Spanish Implementations\n\n1. **GDPR** (2016/679) -- LOPDGDD (Ley Orgánica 3/2018) + AEPD decisions\n2. **NIS2 Directive** (2022/2555) -- Ley de Ciberseguridad (transposition pending as of 2026)\n3. **eIDAS Regulation** (910/2014) -- Ley 6/2020 (firma y certificados electrónicos)\n4. **AI Act** (2024/1689) -- Direct application\n5. **DORA** (2022/2554) -- Direct application in financial sector\n\nSee [EU_INTEGRATION_GUIDE.md](docs/EU_INTEGRATION_GUIDE.md) for detailed documentation.\n\n---\n\n## Data Sources & Freshness\n\nAll content is sourced from authoritative Spanish legal databases:\n\n- **[BOE Datos Abiertos](https://www.boe.es/datosabiertos)** -- Boletín Oficial del Estado open data API\n- **[EUR-Lex](https://eur-lex.europa.eu/)** -- Official EU law database (metadata only)\n\n### Data Provenance\n\n| Field | Value |\n|-------|-------|\n| **Authority** | Agencia Estatal Boletín Oficial del Estado |\n| **Retrieval method** | BOE Datos Abiertos REST API |\n| **Languages** | Spanish (official language of law) |\n| **License** | `Spanish-TRLPI-Art-13` -- Spanish statutory public domain (TRLPI Art. 13) |\n| **Coverage** | 12,181 consolidated statutes (national + regional) |\n| **Last ingested** | 2026-02-25 |\n\n### Automated Freshness Checks (Daily)\n\nA [daily GitHub Actions workflow](.github/workflows/check-updates.yml) monitors all data sources:\n\n| Source | Check | Method |\n|--------|-------|--------|\n| **Statute amendments** | BOE API date comparison | All 12,181 statutes checked |\n| **New statutes** | BOE publications (90-day window) | Diffed against database |\n| **Preparatory works** | BOE proyecto de ley API (30-day window) | New texts detected |\n| **EU reference staleness** | Git commit timestamps | Flagged if >90 days old |\n\n---\n\n## Security\n\nThis project uses multiple layers of automated security scanning:\n\n| Scanner | What It Does | Schedule |\n|---------|-------------|----------|\n| **CodeQL** | Static analysis for security vulnerabilities | Weekly + PRs |\n| **Semgrep** | SAST scanning (OWASP top 10, secrets, TypeScript) | Every push |\n| **Gitleaks** | Secret detection across git history | Every push |\n| **Trivy** | CVE scanning on filesystem and npm dependencies | Daily |\n| **Docker Security** | Container image scanning + SBOM generation | Daily |\n| **Socket.dev** | Supply chain attack detection | PRs |\n| **OSSF Scorecard** | OpenSSF best practices scoring | Weekly |\n| **Dependabot** | Automated dependency updates | Weekly |\n\nSee [SECURITY.md](SECURITY.md) for the full policy and vulnerability reporting.\n\n---\n\n## Important Disclaimers\n\n### Legal Advice\n\n> **THIS TOOL IS NOT LEGAL ADVICE**\n>\n> Statute text is sourced from official BOE publications. However:\n> - This is a **research tool**, not a substitute for professional legal counsel\n> - **Court case coverage is not included** in the free tier -- do not rely solely on this for case law research\n> - **Verify critical citations** against primary sources for court filings\n> - **EU cross-references** are extracted from Spanish statute text, not EUR-Lex full text\n> - **Regional legislation** (Comunidades Autónomas) may not be fully covered\n\n**Before using professionally, read:** [DISCLAIMER.md](DISCLAIMER.md) | [PRIVACY.md](PRIVACY.md)\n\n### Client Confidentiality\n\nQueries go through the Claude API. For privileged or confidential matters, use on-premise deployment. For guidance on professional obligations, consult the Consejo General de la Abogacía Española. See [PRIVACY.md](PRIVACY.md) for compliance guidance.\n\n---\n\n## Documentation\n\n- **[EU Integration Guide](docs/EU_INTEGRATION_GUIDE.md)** -- Detailed EU cross-reference documentation\n- **[EU Usage Examples](docs/EU_USAGE_EXAMPLES.md)** -- Practical EU lookup examples\n- **[Security Policy](SECURITY.md)** -- Vulnerability reporting and scanning details\n- **[Disclaimer](DISCLAIMER.md)** -- Legal disclaimers and professional use notices\n- **[Privacy](PRIVACY.md)** -- Client confidentiality and data handling\n\n---\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/Ansvar-Systems/spanish-law-mcp\ncd spanish-law-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n### Running Locally\n\n```bash\nnpm run dev                                       # Start MCP server\nnpx @anthropic/mcp-inspector node dist/index.js   # Test with MCP Inspector\n```\n\n### Data Management\n\n```bash\nnpm run ingest                    # Ingest statutes from BOE Datos Abiertos\nnpm run build:db                  # Rebuild SQLite database\nnpm run drift:detect              # Run drift detection against anchors\nnpm run check-updates             # Check for amendments and new statutes\nnpm run census                    # Generate coverage census report\n```\n\n### Performance\n\n- **Search Speed:** <100ms for most FTS5 queries\n- **Database Size:** ~849 MB (efficient, portable)\n- **Reliability:** 100% ingestion success rate across 12,181 statutes\n\n---\n\n## More Ansvar MCPs\n\nFull fleet coverage at [ansvar.eu/coverage](https://ansvar.eu/coverage).\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nPriority areas:\n- Court case law expansion (Tribunal Supremo, Audiencia Nacional)\n- AEPD decisions and guidance ingestion\n- Historical statute versions and amendment tracking\n- Autonomous community legislation coverage\n\n---\n\n## Roadmap\n\n- [x] Core statute database with FTS5 search\n- [x] Full corpus ingestion (12,181 statutes, 297,760 provisions)\n- [x] EU law integration tools\n- [x] Vercel Streamable HTTP deployment\n\n- [x] Premium preparatory works (12,193 documents)\n- [ ] Tribunal Supremo case law coverage\n- [ ] AEPD guidance documents\n- [ ] Historical statute versions (amendment tracking)\n- [ ] Autonomous community legislation\n\n---\n\n## Citation\n\nIf you use this MCP server in academic research:\n\n```bibtex\n@software{spanish_law_mcp_2026,\n  author = {Ansvar Systems AB},\n  title = {Spanish Law MCP Server: Production-Grade Legal Research Tool},\n  year = {2026},\n  url = {https://github.com/Ansvar-Systems/spanish-law-mcp},\n  note = {12,181 Spanish statutes with 297,760 provisions and EU law cross-references}\n}\n```\n\n---\n\n## License\n\nApache License 2.0. See [LICENSE](./LICENSE) for details.\n\n### Data Licenses\n\n- **Statutes & Legislation:** `Spanish-TRLPI-Art-13` -- Spanish statutory public domain. TRLPI Art. 13 (Real Decreto Legislativo 1/1996) provides that laws or regulations, draft bills, decisions of judicial bodies and acts of public authorities, as well as official translations of all such texts, are not the subject of intellectual property protection. Verified verbatim 2026-05-17 -- see [`docs/audits/2026-05-17-eu-copyright-statutory-works-batch-1b-DE-IE-IT-NL-ES.md`](https://github.com/Ansvar-Systems/Ansvar-Architecture-Documentation/blob/main/docs/audits/2026-05-17-eu-copyright-statutory-works-batch-1b-DE-IE-IT-NL-ES.md). Catalog entry: `Spanish-TRLPI-Art-13` in `infrastructure/attribution-licenses.json`.\n- **EU Metadata:** EUR-Lex (EU public domain, Decision 2011/833/EU)\n\n---\n\n## About Ansvar Systems\n\nWe build AI-accelerated compliance and legal research tools for the European market. This MCP server started as our internal reference tool for Spanish law -- turns out everyone building for the Spanish and EU markets has the same research frustrations.\n\nSo we're open-sourcing it. Navigating 12,181 statutes shouldn't require a law degree.\n\n**[ansvar.eu](https://ansvar.eu)** -- Stockholm, Sweden\n\n---\n\n<p align=\"center\">\n  <sub>Built with care in Stockholm, Sweden</sub>\n</p>\n",
  "bytes": 16689,
  "sha": "ac3a7feba3e43d03f4c6473353e6137baa5c52dac5b977299c401af2133428c7",
  "repo_slug": "ansvar-systems/spanish-law-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_eu_ansvar_spanish_law_mcp_b005ad0b/readme"
}