spij-mcp
This MCP server lets you search and read Peruvian legal norms and jurisprudence from the SPIJ through MCP tools.
List exact SPIJ filter values: dispositivos, agrupaciones, tomos, materias, and sectores.
Search legal norms full-text with filters for sumilla, dispositivo, sector, agrupación, número, and publication dates.
Search jurisprudence (TC, courts, precedents, sentencias), including local filtering by organismo emisor.
Map a norm’s structure with header/article offsets.
Search inside a specific norm for words or phrases and get occurrences with context and offsets.
Read metadata and plain text of a norm by ID, using offsets or tail reading for long documents.
Retrieve guaranteed full text, including subscriber-only jurisprudence, with progressive range reading.
Paginate and navigate results via IDs, URLs, offsets, suggestions, and next-page indicators.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@spij-mcp busca normas sobre protección de datos personales en Perú"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Sistema Peruano de Información jurídica - SPIJ (Conector MCP No oficial)

Servidor MCP local para buscar y leer el SPIJ — Sistema Peruano de Información Jurídica (normas legales, resoluciones, jurisprudencia del Tribunal Constitucional y más) — desde tu harness MCP.
Herramienta no oficial: sin afiliación con MINJUS ni con el SPIJ.
Aspecto | Detalle |
Fuente de datos | spij.minjus.gob.pe (público) |
Autenticación | Implícita: usa la misma sesión pública del sitio web y se renueva sola (JWT de 24 h) |
Almacenamiento | Ninguno — el servidor nunca guarda archivos; devuelve contenido limpio |
Transporte | stdio (Claude Desktop, Claude Code, agentes compatibles con MCP) |
Instalación
Opción A — Un click (sin terminal)
Descarga
spij-mcp-0.6.2.mcpbdesde Releases.Abre Claude Desktop → Ajustes → Extensiones → Instalar desde archivo.
Selecciona el
.mcpby listo.
No requiere Python instalado: el instalador resuelve el runtime y las dependencias automáticamente (runtime UV de MCPB).
Opción B — Manual (CLI y otros agentes)
Primero instala uv si no lo tienes:
# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh(o pip install uv si prefieres).
Luego, en la carpeta del proyecto:
uv syncY añade a la configuración de servidores MCP de tu agente:
{
"mcpServers": {
"spij": {
"command": "uv",
"args": ["--directory", "RUTA/spij-mcp-OSS", "run", "spij-mcp", "serve"]
}
}
}El servidor envía sus instrucciones de uso por el handshake MCP: el agente sabe cómo buscar y leer sin prompts adicionales.
Related MCP server: mcp-abogadoenquilmes
Actualizaciones
El servidor se auto-chequea en cada arranque: si publicamos una versión más nueva que la tuya, tu agente verá el aviso
UPDATE DISPONIBLEy te pedirá descargarspij-mcp.mcpbde Releases e instalarlo de nuevo (arrástralo como la primera vez). Se desactiva conSPIJ_UPDATE_CHECK=0.Cada versión reemplaza el mismo archivo (
spij-mcp.mcpb): la página de Releases siempre muestra una sola tarjeta con la última.
Tools
Tool | Qué hace |
| Búsqueda full-text con filtros (dispositivo, sector, agrupación, número, fechas) y paginación |
| Igual, para jurisprudencia; |
| Índice de encabezados de una norma (TÍTULO, CAPÍTULO, Artículo N.) con offsets navegables |
| Salta a las ocurrencias de una palabra o frase dentro de una norma |
| Metadatos + texto plano de una norma por |
| Texto completo garantizado, incluido el acervo de suscriptores |
| Valores exactos para los filtros (dispositivos, sectores, tomos, materias, agrupaciones) |
Cómo se lee (4 niveles)
Descubrir —
buscar_normas/buscar_jurisprudencia: cada resultado traeid,url_webysumilla.Mapear —
estructura_norma(id): índice de encabezados con offsets.Saltar —
buscar_en_norma(id, texto): ocurrencias con offsets.Leer —
texto_completo(id, offset, max_chars): lectura por rangos;desde_final=Truelee la decisión de una sentencia directo.
Los offsets son consistentes entre tools: se puede empezar a leer justo donde interesa sin traer textos completos de más.
Notas de uso
El buscador del SPIJ hace AND implícito con todas las palabras y no acepta comillas ni operadores OR/NOT. Acepta comodines de Lucene (
presupuest*).Si una búsqueda da 0 resultados, la respuesta incluye
sugerenciascon conteos de consultas más cortas; si un número de norma no está indexado, la respuesta trae los documentos que lo mencionan.Los textos legales pueden ser extensos: la lectura progresiva (offsets) evita llenar el contexto con lo que no se necesita.
Pruebas de concepto del servicio
El SPIJ es un servicio público de MINJUS. Este cliente lo consulta como lo hace su propia interfaz web, sin abuso: cache local, concurrencia limitada y re-autenticación automática.
Aviso legal
Proyecto independiente, no oficial, sin relación con MINJUS, el SPIJ ni ninguna entidad del Estado peruano.
Sin garantía de disponibilidad del servicio upstream ni de exactitud de los textos; para uso jurídico serio, verifica siempre en la fuente oficial.
La autoría normativa pertenece al Estado Peruano.
Licencia
Available Tools
7 toolsbuscar_en_normaBuscando dentro de la normaA
Busca una palabra o frase DENTRO del texto completo de una norma del SPIJ, y devuelve cada ocurrencia con su offset (para leer alrededor con texto_completo(id, offset=X, max_chars=N)). Ideal para saltar a secciones concretas (ej 'RATIFICAN', 'Artículo 8', 'DISPOSICIONES FINALES') sin leer todo el texto. La busqueda ignora acentos y mayusculas.
Args: id: identificador del SPIJ, ej 'H1385488'. texto: palabra o frase a buscar dentro de la norma (1-8 palabras). contexto: caracteres de contexto alrededor de cada ocurrencia (50-500, default 200). max_matches: maximo de ocurrencias a devolver (1-25, default 10).
Devuelve: ok, id, url_web, total_caracteres, matches: lista de {offset, extracto}, hay_mas (si quedan ocurrencias).
Inputs: id (required), texto (required), contexto, max_matches.
buscar_jurisprudenciaBuscando jurisprudenciaA
Busca jurisprudencia en el SPIJ (TC, cortes, precedentes, sentencias).
Args: consulta: texto libre (AND implicito, sin comillas ni OR; comodin * ok). Empieza con 1-2 palabras. tomo: tomo de jurisprudencia, ej 'TRIBUNAL CONSTITUCIONAL'. OJO: se envia al SPIJ pero el indice NO lo aplica (verificado: los totales son identicos con y sin tomo) - filtra con la consulta y/o fechas. materia: especialidad dentro del tomo, ej 'JURISPRUDENCIA ADMINISTRATIVA' del tomo del TC. Ver listar_filtros(categoria='materias'). organismo: filtra LOCALMENTE por organismo emisor, ej 'TC', 'CORTE SUPREMA', 'OSIPTEL', 'CGD' (coincide contra codigo/sector/dispositivo, sin acentos). El servidor escanea hasta 5 paginas del SPIJ y devuelve solo los coincidentes (con 'filtrados' y 'escaneadas'). Es la via correcta: el indice no filtra por tomo. numero: numero de expediente o codigo, ej '03209-2024-PA/TC' (expediente completo del TC funciona). fecha_ini / fecha_fin: rango de publicacion AAAA-MM-DD. orden: '1' = fecha (default), '2'/'3'/'4' = relevancia. start / paginas: igual que buscar_normas (por cada pagina devuelta el servidor puede escanear varias internamente). sumilla_chars: maximo de caracteres de la sumilla por documento (0 = sin limite).
Devuelve: ok, total (del indice), organismo, escaneadas (paginas escaneadas), filtrados (coincidencias encontradas), normas, siguiente_start (si quedan paginas por escanear). Si la consulta base arroja 0 resultados incluye 'sugerencias'; si el indice arroja resultados pero ninguno del organismo pedido, incluye 'organismos_disponibles' (los organismos presentes en lo escaneado). El texto se obtiene con detalle_norma(id) o texto_completo(id).
Inputs: tomo, orden, start, numero, +7 more.
buscar_normasBuscando normasA
Busca normas legales en el SPIJ (normas generales, administrativas, etc).
Args: consulta: texto libre en el contenido. El buscador hace AND implicito con TODAS las palabras (ej 'transferencia partidas'). OJO: NO acepta comillas ni OR. Si acepta comodin al final de una raiz, ej 'presupuest*'. Empieza con 1-2 palabras. sumilla: texto a buscar solo en la sumilla (resumen) de la norma. dispositivo: tipo de dispositivo legal, ej 'DECRETO SUPREMO'. Acepta parcial ('decreto sup') y se resuelve solo; si es ambiguo devuelve candidatos. Ver listar_filtros. sector: entidad emisora, ej 'ECONOMIA Y FINANZAS'. Acepta parcial. agrupacion: grupo del acervo, ej 'LEGISLACION SUPRANACIONAL'. numero: numero del dispositivo, ej '200-2026-EF' o '31068' (sin prefijo 'Nº'). OJO: algunas leyes no estan indexadas como registro propio; en ese caso la respuesta trae los documentos que lo mencionan (con una nota que lo explica). fecha_ini / fecha_fin: rango de publicacion, formato AAAA-MM-DD. orden: '1' = fecha (recientes primero, default), '2'/'3'/'4' = relevancia. start: desplazamiento (multiplo de 10). Pagina N -> start = (N-1)*10. paginas: paginas consecutivas a traer en una sola llamada (cada pagina = 10 resultados, max 10 paginas). sumilla_chars: maximo de caracteres de la sumilla por documento (0 = sin limite). Para leer la sumilla completa usa detalle_norma(id).
Devuelve: ok, total, desde, hasta, siguiente_start (si hay mas paginas), normas: lista de {id, url_web, codigoNorma, dispositivoLegal, sector, fechaPublicacion, sumilla} (con 'sumilla_total' si se acoto). Ante 0 resultados devuelve 'nota' y 'sugerencias' ({param, consulta, total} de versiones mas cortas de la consulta o de la sumilla, sin filtros categoricos).
Inputs: orden, start, numero, sector, +8 more.
detalle_normaObteniendo detalle de la normaA
Devuelve los METADATOS y el TEXTO de una norma del SPIJ por su id.
Args: id: identificador del SPIJ, ej 'H1453062' (lo devuelve buscar_normas). offset: desde que caracter del texto empezar (0 = inicio). max_chars: maximo de caracteres de texto a devolver en esta llamada (0 = usa el limite por defecto). Si el texto es mas largo, 'siguiente_offset' indica por donde continuar. desde_final: si es True, devuelve los ULTIMOS max_chars caracteres (en sentencias judiciales la decision 'RESUELVE' esta al final).
Devuelve: ok, id, url_web (para abrir la norma en el sitio SPIJ), codigoNorma, dispositivoLegal, sector, fechaPublicacion, ruta, titulo, sumilla, texto (texto plano, sin HTML), total_caracteres, texto_truncado, siguiente_offset (si hay mas texto).
Nota: si el texto es muy largo para tu contexto, lee por rangos con offset (ej offset=20000) o la cola con desde_final=True.
Inputs: id (required), offset, max_chars, desde_final.
estructura_normaMapeando la estructura de la normaA
Devuelve el INDICE de encabezados de una norma del SPIJ, con el offset de cada uno para leer secciones concretas con texto_completo(id, offset=X, max_chars=N).
Args: id: identificador del SPIJ, ej 'H1453062' (lo dan buscar_*).
Devuelve: ok, id, url_web, fuente, total_caracteres, total_encabezados, encabezados: lista de {tipo: 'seccion'|'articulo', titulo, offset} (hasta 150; con 'siguiente_encabezado' si hay mas). Los offsets apuntan al mismo texto canonico que sirve texto_completo. Si la norma no tiene encabezados (sentencias del TC son prosa), 'encabezados' viene vacia: usa buscar_en_norma o lectura por rangos.
Inputs: id (required).
listar_filtrosListando filtrosA
Lista los valores validos para los filtros del SPIJ.
Args: categoria: una de 'dispositivos', 'agrupaciones', 'tomos', 'materias', 'sectores'. Si se omite, devuelve un resumen con conteos y ejemplos de cada categoria. tomo: solo para categoria='materias': el tomo de jurisprudencia del que se quieren las especialidades, ej 'TRIBUNAL CONSTITUCIONAL'.
'dispositivos': tipos de dispositivo legal (ej DECRETO SUPREMO). 'agrupaciones': grupos del acervo (ej LEGISLACION SUPRANACIONAL). 'tomos': tomos de jurisprudencia (ej TRIBUNAL CONSTITUCIONAL). 'materias': especialidades de un tomo de jurisprudencia (requiere 'tomo'). 'sectores': entidades emisoras (hay cientos; si el tuyo no esta en la lista puedes escribir parte del nombre en buscar_normas y se resuelve automaticamente).
Devuelve: dict con 'ok' y la lista 'valores': son los strings EXACTOS que aceptan buscar_normas y buscar_jurisprudencia.
Inputs: tomo, categoria.
texto_completoLeyendo el texto completoA
Devuelve el TEXTO COMPLETO de una norma o jurisprudencia del SPIJ.
Ruta robusta: obtiene el documento word del SPIJ (ruta que incluye el acervo completo de jurisprudencia) y devuelve texto plano. Si esa ruta falla, usa el texto del detalle.
Args: id: identificador del SPIJ, ej 'H1352213' (lo dan buscar_*). offset: desde que caracter del texto empezar (0 = inicio). max_chars: maximo de caracteres a devolver en esta llamada (0 = usa el limite por defecto). Si hay mas texto, 'siguiente_offset' indica por donde continuar. desde_final: si es True, devuelve los ULTIMOS max_chars caracteres (en sentencias judiciales la decision 'RESUELVE' esta al final; combinado con max_chars=3000 la lees directo).
Devuelve: ok, id, url_web, codigoNorma, fechaPublicacion, dispositivoLegal, texto (texto plano), total_caracteres, texto_truncado, siguiente_offset (si hay mas; None con desde_final).
Inputs: id (required), offset, max_chars, desde_final.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: listar_filtros discovers filter values, buscar_jurisprudencia and buscar_normas target different legal corpora, and buscar_en_norma vs estructura_norma are distinct operations. However, texto_completo and detalle_norma both retrieve document text with the same argument shape and overlapping returns, which could lead to misselection.
All tool names use consistent Spanish snake_case, with action verbs (buscar_, listar_) for searches and noun phrases for retrieval. The pattern is mostly predictable, though the verb_noun convention is not universal because three tools use noun-based names.
Seven tools is well-scoped for a read-only SPIJ legal research server. Each tool earns its place by covering a distinct stage of discovery, search, or document access, with no unnecessary duplication.
The set covers filter discovery, norm and jurisprudence search, document structure, in-document search, full text, and metadata. Minor gaps exist, such as a dedicated metadata-only endpoint or citation resolver, but agents can work around them using existing tools.
Maintenance
Related MCP Connectors
Official MCP connector for Legalize: read and search its whole open corpus, at any point in time.
Brazilian legal stack in one MCP: lawsuits, court publications, case law, tenders, certificates.
Public Indian legal search MCP for Roop judgments, statutes, and corpus grounding.
Resolve, search and verify legal citations against the official sources, with provenance.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP 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.4MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP server that provides access to over 285K Argentine court rulings and user's own case files via Streamable HTTP transport.-
- FlicenseAqualityBmaintenanceMCP server that provides access to Argentine legal documents (legislation, CSJN jurisprudence, international treaties) with verifiable provenance including SHA256 hashes and source URLs, enabling legal professionals to search and verify citations.13-
- FlicenseNot gradedqualityDmaintenanceMCP server for Peruvian government data, enabling search and anomaly detection in public procurement (OSCE) and legislative tracking (Congress), plus semantic search over both domains.-