Skip to main content
Glama

Sistema Peruano de Información jurídica - SPIJ (Conector MCP No oficial)

spij-mcp

Licencia Python MCP Local

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)

  1. Descarga spij-mcp-0.6.2.mcpb desde Releases.

  2. Abre Claude Desktop → Ajustes → Extensiones → Instalar desde archivo.

  3. Selecciona el .mcpb y 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 sync

Y 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 DISPONIBLE y te pedirá descargar spij-mcp.mcpb de Releases e instalarlo de nuevo (arrástralo como la primera vez). Se desactiva con SPIJ_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

buscar_normas

Búsqueda full-text con filtros (dispositivo, sector, agrupación, número, fechas) y paginación

buscar_jurisprudencia

Igual, para jurisprudencia; organismo="TC" filtra localmente por organismo emisor

estructura_norma

Índice de encabezados de una norma (TÍTULO, CAPÍTULO, Artículo N.) con offsets navegables

buscar_en_norma

Salta a las ocurrencias de una palabra o frase dentro de una norma

detalle_norma

Metadatos + texto plano de una norma por id (lectura por rangos)

texto_completo

Texto completo garantizado, incluido el acervo de suscriptores

listar_filtros

Valores exactos para los filtros (dispositivos, sectores, tomos, materias, agrupaciones)

Cómo se lee (4 niveles)

  1. Descubrir — buscar_normas / buscar_jurisprudencia: cada resultado trae id, url_web y sumilla.

  2. Mapear — estructura_norma(id): índice de encabezados con offsets.

  3. Saltar — buscar_en_norma(id, texto): ocurrencias con offsets.

  4. Leer — texto_completo(id, offset, max_chars): lectura por rangos; desde_final=True lee 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 sugerencias con 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.

  • 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

Apache-2.0

Available Tools

7 tools
buscar_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

    A4.4/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      4
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      MCP 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Peruvian government data, enabling search and anomaly detection in public procurement (OSCE) and legislative tracking (Congress), plus semantic search over both domains.
      -