Skip to main content
Glama
DerechoVirtual

CENDOJ Sentencias MCP Server

Jurisprudenciator — Servidor MCP de jurisprudencia

Busca y lee sentencias de las fuentes oficiales y gratuitas de jurisprudencia española directamente desde Claude (Desktop / Cowork). Encuentra la mejor sentencia para un caso, extrae los párrafos exactos con su ECLI, y trabaja a gran velocidad.

⚡ Rápido de verdad: la mejor sentencia con sus párrafos en ~2-3 s, y 30 sentencias con sus párrafos clave en ~6 s. El control antidescargas de la fuente es por sesión (no por IP): el servidor reparte las descargas entre varias sesiones frescas (multi-sesión) y esquiva las comprobaciones sin pausas ni intervención del usuario. Sin API keys, sin coste.

Qué puede hacer

  • Buscar jurisprudencia con todos los filtros de la fuente: base TS/AN, fechas, tipo de resolución, jurisdicción (CIVIL, PENAL…), provincia/sede (Valladolid, Alicante…) y tipo de órgano (AP, TSJ, Juzgado de 1ª Instancia, Mercantil…). Pagina automáticamente si pides más de 50.

  • Ver ROJ, ECLI, fecha, sala, ponente y un RESUMEN(auto) de cada sentencia (extracto del propio texto) — para elegir la mejor por el resumen, sin descargar nada.

  • Localizar por cita: por ECLI o ROJ exacto (verificar una cita en segundos).

  • Leer el texto íntegro o solo los párrafos exactos que tocan el tema, de una o de decenas de sentencias a la vez. Por defecto no guarda nada en tu disco.

  • Refinar por órganos, años o ponentes disponibles para un tema.

Es gratis y cubre toda España (TS, AN, TSJ, Audiencias Provinciales, Juzgados…). La fuente es pública: no hay login ni usuario.

Related MCP server: MCP-BOE

Requisitos

  • Python 3.10+ (con PyMuPDF para extracción de texto rápida; cae a pypdf).

  • Claude Desktop (o cualquier cliente MCP). En Claude Cowork funciona igual.

Instalación (Windows)

git clone https://github.com/DerechoVirtual/mcp-cendoj-sentencias.git
cd mcp-cendoj-sentencias

uv venv
uv pip install -e .          # en OneDrive/Dropbox: añade --link-mode=copy

Conéctalo con doble clic en instalar_en_claude_desktop.bat (escribe la entrada con la app cerrada y te avisa), o a mano en %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "jurisprudenciator": {
      "command": "C:\ruta\al\.venv\Scripts\python.exe",
      "args": ["C:\ruta\al\server.py"]
    }
  }
}

Reinicia Claude Desktop por completo.

Configuración (.env) — todo opcional

Funciona sin configurar nada (abre y renueva la sesión él solo):

Variable

Para qué

DOWNLOAD_DIR

Dónde guardar PDFs/textos si pides guardarlos. Def.: …\Documents\sentencias.

Cómo se usa (en lenguaje natural)

"Sentencias de la AP de Valladolid sobre usufructo: dame los 5 párrafos clave de cada una con su ECLI."

"Búscame 30 sentencias sobre pensión compensatoria con ingresos similares y sácame de cada una el párrafo donde se razona el desequilibrio."

Claude llamará a las herramientas por ti:

  1. buscar_sentencias → lista con ROJ, ECLI, fecha, ponente y RESUMEN(auto), para elegir las mejores sin descargar nada.

  2. leer_sentencias(parrafos=N) → lee en memoria y devuelve solo los N párrafos exactos que tocan el tema (o el texto íntegro con parrafos=0). No guarda nada salvo que lo pidas. Esquiva las comprobaciones solo.

Las herramientas

Herramienta

Qué hace

buscar_sentencias(consulta, base="TS", maximo=20, fecha_desde, fecha_hasta, tipo_resolucion, jurisdiccion, provincia, tipo_organo)

Busca y lista con metadatos y RESUMEN(auto). Filtros de jurisdicción, provincia, tipo_organo. Pagina si maximo>50.

buscar_por_cita(cita)

Localiza por ECLI o ROJ exacto.

opciones_busqueda(consulta, campo="organos")

Facetas para refinar: organos, anos, ponentes.

leer_sentencias(seleccion="todas", parrafos=0, terminos="", max_chars=0, guardar_pdf=False)

Lee el texto (multi-sesión, rapidísimo). parrafos=N → solo los N pasajes exactos sobre el tema. Por defecto no guarda el PDF.

continuar_lectura(texto)

Fallback histórico — normalmente innecesario (las comprobaciones de seguridad se esquivan solas).

estado()

Diagnóstico: extractor, sesión, última búsqueda, carpeta.

Por qué es tan rápido

  • Multi-sesión: la comprobación antidescargas es por sesión y salta sobre la 6ª-7ª descarga. El motor usa varias sesiones frescas en paralelo (5 descargas cada una) → casi nunca aparece, y si aparece se esquiva abriendo otra sesión. Sin pausas, sin resolver nada a mano.

  • PyMuPDF para extraer el texto ~10× más rápido que pypdf.

  • Modo párrafos: en vez de volcar el texto íntegro de 30 sentencias (~800.000 caracteres), devuelve solo los pasajes que tocan el tema (~100.000) → rápido y sin saturar.

Uso responsable

Pensado para uso profesional e individual (un abogado/estudiante consultando jurisprudencia). El multi-sesión reparte la carga, pero no martillees la fuente con descargas masivas innecesarias: con el RESUMEN(auto) eliges por resumen y solo lees las que de verdad sirven.

Privacidad y seguridad

  • .env y .venv/ están en .gitignore. Este repositorio no contiene credenciales ni datos.

  • Por defecto no guarda nada en tu disco (lee en memoria). Solo lee/consulta la fuente oficial; no envía nada a terceros.

Licencia

MIT (ver LICENSE).

Related MCP Connectors

Related MCP Servers