eu.ansvar/spanish-law-mcp

Officialdeprecated

by Ansvar-Systems · TypeScript

Spanish legislation via MCP — full-text search across statutes and provisions

Full-text search across Spanish statutes and legislative provisions.

README.md16 KBView on GitHub

Spanish Law MCP Server

▶ Try this MCP instantly via Ansvar Gateway

50 free queries/day · no card required · OAuth signup at ansvar.eu/gateway

One endpoint, one OAuth signup, access from any MCP-compatible client.

Connect

Claude Code (one line):

bash

claude mcp add ansvar --transport http https://gateway.ansvar.eu/mcp

Claude Desktop / Cursor — add to claude_desktop_config.json (or mcp.json):

json

{
  "mcpServers": {
    "ansvar": {
      "type": "url",
      "url": "https://gateway.ansvar.eu/mcp"
    }
  }
}

Claude.ai — Settings → Connectors → Add custom connector → paste https://gateway.ansvar.eu/mcp

First request opens an OAuth flow at ansvar.eu/gateway. After signup, your client is bound to your account; tier (free / premium / team / company) determines fan-out, quota, and which downstream MCPs are reachable.

Self-host this MCP

You can also clone this repo and build the corpus yourself. The schema, fetcher, and tool implementations all live here. What is not in the repo is the pre-built database — TDM and standards-licensing constraints on the upstream sources mean we host the corpus on Ansvar infrastructure rather than redistribute it as a public artifact.

Build your own: run this repo's ingestion script (entry-point varies per repo — typically scripts/ingest.sh, npm run ingest, or make ingest; check the repo root).

The BOE (Boletín Oficial del Estado) alternative for the AI age.

Query 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.

If you're building legal tech, compliance tools, or doing Spanish legal research, this is your verified reference database.

Built by Ansvar Systems -- Stockholm, Sweden

Why This Exists

Spanish 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:

A lawyer validating citations in a brief or contract
A compliance officer checking LOPDGDD obligations or ENS requirements
A legal tech developer building tools on Spanish law
A researcher tracing legislative provisions across 12,181 national statutes

...you shouldn't need dozens of browser tabs and manual cross-referencing. Ask Claude. Get the exact provision. With context.

This MCP server makes Spanish law searchable, cross-referenceable, and AI-readable.

Example Queries

Once connected, just ask naturally:

"¿Qué dice el artículo 6 de la LOPDGDD sobre el tratamiento de datos personales?"
"Búsqueda 'protección de datos' en el derecho español (LOPDGDD, RGPD)"
"¿Qué artículos del Código Penal regulan los delitos informáticos?"
"Encuentra disposiciones sobre despido improcedente en el Estatuto de los Trabajadores"
"What EU directives does the LOPDGDD implement?"
"Which Spanish laws implement the NIS2 Directive?"
"Valida la cita 'Art. 197 CP' (Código Penal)"
"Busca 'responsabilidad civil' en el Código Civil español"
"Compare incident notification requirements under NIS2 and the Spanish transposition"
"¿Está en vigor el Real Decreto-ley 14/2019 sobre medidas urgentes de administración digital?"

What's Included

Category	Count	Details
Statutes	12,181 statutes	Comprehensive Spanish legislation from BOE
Provisions	297,760 articles	Full-text searchable with FTS5
Preparatory Works	12,193 documents	Premium tier -- exposiciones de motivos, proyectos de ley
Case Law	0 (free tier)	Reserved for future ingestion
Agency Guidance	0 (free tier)	Reserved for future ingestion
Database Size	~849 MB	Optimized SQLite, portable
Daily Updates	Automated	Freshness checks against BOE

Verified data only -- every citation is validated against official sources (BOE, boe.es). Zero LLM-generated content.

See It In Action

Why This Works

Verbatim Source Text (No LLM Processing):

All statute text is ingested from the BOE Datos Abiertos API (boe.es/datosabiertos)
Provisions are returned unchanged from SQLite FTS5 database rows
Zero LLM summarization or paraphrasing -- the database contains regulation text, not AI interpretations

Smart Context Management:

Search returns ranked provisions with BM25 scoring (safe for context)
Provision retrieval gives exact text by statute identifier + article number
Cross-references help navigate without loading everything at once

Technical Architecture:

code

BOE Datos Abiertos API --> Parse --> SQLite --> FTS5 snippet() --> MCP response
                            ^                        ^
                     Provision parser         Verbatim database query

Traditional Research vs. This MCP

Traditional Approach	This MCP Server
Search BOE by statute name	Search by plain Spanish: "protección datos personales"
Navigate multi-title statutes manually	Get the exact article with context
Manual cross-referencing between codes	`build_legal_stance` aggregates across sources
"¿Está este artículo vigente?" -> check manually	`check_currency` tool -> answer in seconds
Find EU basis -> dig through EUR-Lex	`get_eu_basis` -> linked EU directives instantly
Check BOE, EUR-Lex, AEPD separately	Daily automated freshness checks
No API, no integration	MCP protocol -> AI-native

Traditional: Search BOE -> Download PDF -> Ctrl+F -> Cross-reference with RGPD -> Check EUR-Lex -> Repeat

This MCP: "¿Qué normativa europea da base al artículo 22 de la LOPDGDD sobre decisiones automatizadas?" -> Done.

Available Tools (13)

Core Legal Research Tools (8)

Tool	Description
`search_legislation`	FTS5 full-text search across 297,760 provisions with BM25 ranking
`get_provision`	Retrieve specific provision by statute identifier + article number
`validate_citation`	Validate citation against database (zero-hallucination check)
`build_legal_stance`	Aggregate citations from statutes, preparatory works, and case law
`format_citation`	Format citations per Spanish conventions (full/short/pinpoint)
`check_currency`	Check if statute is in force, amended, or repealed
`list_sources`	List all available statutes with metadata and data provenance
`about`	Server info, capabilities, dataset statistics, and coverage summary

EU Law Integration Tools (5)

Tool	Description
`get_eu_basis`	Get EU directives/regulations underlying a Spanish statute
`get_spanish_implementations`	Find Spanish laws implementing a specific EU act
`search_eu_implementations`	Search EU documents with Spanish implementation counts
`get_provision_eu_basis`	Get EU law references for a specific provision
`validate_eu_compliance`	Check implementation status against EU directives

EU Law Integration

Spain is a full EU member state. Spanish law has systematic EU cross-references across data protection, cybersecurity, financial regulation, and consumer rights.

Metric	Value
EU Integration	Full EU member (accession 1986)
GDPR Implementation	LOPDGDD (Ley Orgánica 3/2018, AEPD oversight)
NIS2 Transposition	Real Decreto-ley + Ley de Seguridad de las Redes y Sistemas de Información
AI Act	Direct application (EU regulation, no transposition needed)
ENS	Esquema Nacional de Seguridad (Real Decreto 311/2022)
EUR-Lex Integration	Automated metadata fetching

Key EU Acts with Spanish Implementations

GDPR (2016/679) -- LOPDGDD (Ley Orgánica 3/2018) + AEPD decisions
NIS2 Directive (2022/2555) -- Ley de Ciberseguridad (transposition pending as of 2026)
eIDAS Regulation (910/2014) -- Ley 6/2020 (firma y certificados electrónicos)
AI Act (2024/1689) -- Direct application
DORA (2022/2554) -- Direct application in financial sector

See EU_INTEGRATION_GUIDE.md for detailed documentation.

Data Sources & Freshness

All content is sourced from authoritative Spanish legal databases:

BOE Datos Abiertos -- Boletín Oficial del Estado open data API
EUR-Lex -- Official EU law database (metadata only)

Data Provenance

Field	Value
Authority	Agencia Estatal Boletín Oficial del Estado
Retrieval method	BOE Datos Abiertos REST API
Languages	Spanish (official language of law)
License	`Spanish-TRLPI-Art-13` -- Spanish statutory public domain (TRLPI Art. 13)
Coverage	12,181 consolidated statutes (national + regional)
Last ingested	2026-02-25

Automated Freshness Checks (Daily)

A daily GitHub Actions workflow monitors all data sources:

Source	Check	Method
Statute amendments	BOE API date comparison	All 12,181 statutes checked
New statutes	BOE publications (90-day window)	Diffed against database
Preparatory works	BOE proyecto de ley API (30-day window)	New texts detected
EU reference staleness	Git commit timestamps	Flagged if >90 days old

Security

This project uses multiple layers of automated security scanning:

Scanner	What It Does	Schedule
CodeQL	Static analysis for security vulnerabilities	Weekly + PRs
Semgrep	SAST scanning (OWASP top 10, secrets, TypeScript)	Every push
Gitleaks	Secret detection across git history	Every push
Trivy	CVE scanning on filesystem and npm dependencies	Daily
Docker Security	Container image scanning + SBOM generation	Daily
Socket.dev	Supply chain attack detection	PRs
OSSF Scorecard	OpenSSF best practices scoring	Weekly
Dependabot	Automated dependency updates	Weekly

See SECURITY.md for the full policy and vulnerability reporting.

Important Disclaimers

Legal Advice

THIS TOOL IS NOT LEGAL ADVICE

Statute text is sourced from official BOE publications. However:

This is a research tool, not a substitute for professional legal counsel

Court case coverage is not included in the free tier -- do not rely solely on this for case law research

Verify critical citations against primary sources for court filings

EU cross-references are extracted from Spanish statute text, not EUR-Lex full text

Regional legislation (Comunidades Autónomas) may not be fully covered

Before using professionally, read: DISCLAIMER.md | PRIVACY.md

Client Confidentiality

Queries 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 for compliance guidance.

Documentation

EU Integration Guide -- Detailed EU cross-reference documentation
EU Usage Examples -- Practical EU lookup examples
Security Policy -- Vulnerability reporting and scanning details
Disclaimer -- Legal disclaimers and professional use notices
Privacy -- Client confidentiality and data handling

Development

Setup

bash

git clone https://github.com/Ansvar-Systems/spanish-law-mcp
cd spanish-law-mcp
npm install
npm run build
npm test

Running Locally

bash

npm run dev                                       # Start MCP server
npx @anthropic/mcp-inspector node dist/index.js   # Test with MCP Inspector

Data Management

bash

npm run ingest                    # Ingest statutes from BOE Datos Abiertos
npm run build:db                  # Rebuild SQLite database
npm run drift:detect              # Run drift detection against anchors
npm run check-updates             # Check for amendments and new statutes
npm run census                    # Generate coverage census report

Performance

Search Speed: <100ms for most FTS5 queries
Database Size: ~849 MB (efficient, portable)
Reliability: 100% ingestion success rate across 12,181 statutes

More Ansvar MCPs

Full fleet at ansvar.eu/gateway.

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Priority areas:

Court case law expansion (Tribunal Supremo, Audiencia Nacional)
AEPD decisions and guidance ingestion
Historical statute versions and amendment tracking
Autonomous community legislation coverage

Roadmap

Core statute database with FTS5 search
Full corpus ingestion (12,181 statutes, 297,760 provisions)
EU law integration tools
Vercel Streamable HTTP deployment
Premium preparatory works (12,193 documents)
Tribunal Supremo case law coverage
AEPD guidance documents
Historical statute versions (amendment tracking)
Autonomous community legislation

Citation

If you use this MCP server in academic research:

bibtex

@software{spanish_law_mcp_2026,
  author = {Ansvar Systems AB},
  title = {Spanish Law MCP Server: Production-Grade Legal Research Tool},
  year = {2026},
  url = {https://github.com/Ansvar-Systems/spanish-law-mcp},
  note = {12,181 Spanish statutes with 297,760 provisions and EU law cross-references}
}

License

Apache License 2.0. See LICENSE for details.

Data Licenses

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. Catalog entry: Spanish-TRLPI-Art-13 in infrastructure/attribution-licenses.json.
EU Metadata: EUR-Lex (EU public domain, Decision 2011/833/EU)

About Ansvar Systems

We 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.

So we're open-sourcing it. Navigating 12,181 statutes shouldn't require a law degree.

ansvar.eu -- Stockholm, Sweden

<p align="center"> <sub>Built with care in Stockholm, Sweden</sub> </p>

Install

claude_desktop_config.json

{
  "mcpServers": {
    "spanish-law-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ansvar/spanish-law-mcp@1.0.1"
      ]
    }
  }
}