Jurisprudencia.io

npx add-mcp 'https://jurisprudencia.io/mcp'

Qué es el servidor MCP

Model Context Protocol permite que un asistente consulte herramientas externas durante la conversación. Con Jurisprudencia.io puede descubrir órganos judiciales, buscar resoluciones españolas y consultar sus referencias oficiales.

El MCP no incorpora un agente de inteligencia artificial propio. Expone herramientas deterministas para que el asistente conectado decida cuándo buscar, leer o comprobar una referencia. El MCP y la API REST utilizan el mismo lector judicial, la misma ordenación y las mismas reglas de visibilidad. Los resúmenes de las fuentes se identifican como tales y no se convierten en texto íntegro.

Endpoint y transporte

https://jurisprudencia.io/mcp

Transporte: Streamable HTTP, con mensajes JSON-RPC 2.0. Las herramientas se invocan mediante POST. El cliente negocia la versión durante initialize; los ejemplos utilizan 2025-06-18.

El cliente debe aceptar application/json y text/event-stream y enviar el encabezado MCP-Protocol-Version con la versión negociada. El servidor SDK está configurado sin sesiones persistentes ni un canal GET de eventos; ese GET devuelve 405.

Autenticación y autorización

Los clientes compatibles pueden utilizar OAuth 2.0, registro dinámico de cliente y Authorization Code con PKCE. Autoriza tu cuenta y revisa los permisos solicitados. El token se envía como Authorization: Bearer en las solicitudes MCP.

El servicio publica metadatos de autorización en /.well-known/oauth-authorization-server y del recurso en /.well-known/oauth-protected-resource, en la base del servicio configurada.

Las herramientas judiciales requieren autorización de consulta. Una conexión sin token válido se rechaza; los tokens revocados deben dejar de permitir el acceso. Leer esta documentación no crea claves ni autoriza una conexión.

Herramientas de jurisprudencia

list_courts

Lista los órganos con resoluciones visibles. Devuelve nombre, identificador, tipo y recuento, con el total de la selección y la fecha de consulta. No admite parámetros.

search_decisions

Busca resoluciones mediante el lector textual indexado, con el órgano como filtro opcional. Puedes empezar por la cuestión jurídica sin conocer el tribunal.

Parámetro	Uso
query	Consulta textual. Obligatoria si no envías query_intent.
query_intent	Objeto con listas required, any_of, phrases y exclude. Tiene precedencia sobre query.
court	Identificador del órgano, opcional; obtén los valores del catálogo.
source_groups	Lista opcional con boe_tc, cendoj o tc_hj.
page	Página desde 0; máximo 100.
per_page	Entre 1 y 20; por defecto 5.
date_from / date_to	Intervalo de fecha judicial, YYYY-MM-DD.

El texto admite términos, secuencias entre comillas, alternativas con OR y exclusión con «-». La consulta estructurada construye esas alternativas conservando los términos obligatorios y excluidos en cada una.

lookup_decision

Consulta una resolución con id o identifier — ECLI, ROJ o número de resolución/proceso —, indicando uno de los dos. court es opcional. Una referencia ambigua devuelve ambiguous_identifier para que el asistente precise la consulta.

Ejemplo de llamada

Después de inicializar el cliente y descubrir las herramientas con tools/list, puedes solicitar una búsqueda general:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_decisions",
    "arguments": {
      "query_intent": {
        "required": ["tutela"],
        "phrases": ["judicial efectiva"],
        "exclude": []
      },
      "date_from": "2020-01-01",
      "per_page": 5
    }
  }
}

La respuesta de la herramienta incluye un JSON con data y meta. Cada resolución conserva los metadatos disponibles, su fragmento literal y el enlace oficial. Si meta.has_next_page es true, puedes solicitar la página siguiente.

Investigar y comprobar los fundamentos

search_decisions selecciona resoluciones distintas y las ordena por correspondencia textual, fecha judicial e identificador estable. No interpreta la pregunta mediante un agente ni ejecuta el flujo de la búsqueda web. Las fuentes BOE, CENDOJ y HJ se consultan conjuntamente por defecto. meta.has_next_page indica si puedes solicitar otra página; no acredita una cobertura exhaustiva de toda la jurisprudencia española.

Utiliza query_intent cuando necesites expresar términos obligatorios, alternativos, frases o exclusiones sin depender de que el asistente construya la sintaxis textual.

read_decision

Envía id y el version_id obtenido en los resultados, con section=legal_grounds para los fundamentos o ruling para el fallo. Devuelve párrafos literales, procedencia, available_sections y next_offset. limit admite de uno a cinco párrafos y cada párrafo se recorta a 4000 caracteres. Para completarlo, usa paragraph_offset como offset, next_char como start_char y limit=1, conservando la versión. Las otras secciones disponibles son antecedentes, voto particular y resumen de la fuente.

El asistente conectado debe comprobar los fundamentos antes de atribuir una doctrina, contrastar hechos y decisiones, reformular si falta evidencia y declarar límites o fallos. La conexión no garantiza que el modelo siga todas las instrucciones. No debe inventar posiciones favorables o contrarias ni convertir un resumen en lectura íntegra.

Evidencias para la respuesta de tu asistente

También están disponibles search_evidence, answer_with_sources y list_source_groups. Estas herramientas de compatibilidad devuelven fragmentos. Para investigar por decisiones, utiliza search_decisions y comprueba las secciones con read_decision.

Fuentes, límites y errores

Los campos ECLI, ROJ, ponente o sala quedan nulos cuando no están disponibles. Se preservan content_scope, full_text_available, versión y extracción. Las resoluciones que todavía solo tienen metadatos no se devuelven en las herramientas públicas. Un fragmento o un resumen no sustituye la lectura de la fuente oficial.

MCP y API contabilizan las operaciones en la cuenta autorizada. Las llamadas de herramientas están sujetas a límites; los mensajes de inicialización, descubrimiento y ping no se contabilizan como búsquedas en el servidor SDK. Las cantidades comerciales se consultan en la oferta y en Uso.

Los errores de herramienta se identifican con isError y un código: argumentos inválidos, referencia ambigua, recurso no visible o indisponibilidad. Un fallo del servicio no debe interpretarse como ausencia de jurisprudencia. Si falta autorización o se alcanza un límite, también se aplican los estados HTTP correspondientes.

Instalación y referencia

Consulta el flujo de instalación en Claude o la documentación de la API. Para preguntas técnicas, escribe a developer@jurisprudencia.io.

Doctrina administrativa tributaria

Utiliza search_administrative_documents para buscar en los documentos incorporados de DYCTEA y DGT/PETETE. lookup_administrative_document acepta referencias como DGT:V0001-25 o DYCTEA:00/05409/2025/00/00. Con el identificador obtenido, read_administrative_document permite leer tax_answer, tax_facts y tax_question en DGT, o administrative_criterion y legal_grounds en DYCTEA.

Conserva la versión al continuar la lectura. La clasificación pertenece al criterio o consulta indicados; no convierte el documento en una sentencia ni acredita por sí sola aplicabilidad al caso o vigencia actual. La incorporación es progresiva y no implica cobertura completa.