Saltar al contenido principal
Documentación · MCP + API REST

De cero a la primera respuesta en cinco minutos.

Una API key, un comando y tu agente ya consulta fuentes oficiales de Argentina, Brasil, Chile y México. Esta página es la referencia completa: herramientas, parámetros, errores y límites, con respuestas reales del servidor.

Primeros pasos

1. Obtén tu key

Elige un plan en la página de planes y entra con tu email: te enviamos un enlace, sin contraseña. En el panel, genera una API key. Se muestra una sola vez, así que guárdala como un secreto. Toda key empieza con jn_live_.

2. Conecta tu cliente

El servidor habla MCP por HTTP (streamable HTTP) y se autentica con la key en un header. Sirve cualquier cliente que acepte un servidor remoto por HTTP con headers.

Claude CodeMCP · HTTP
claude mcp add --transport http jurisnet \ https://mcp.jurisnet.ai/public/mcp \ --header "X-API-Key: $JURISNET_API_KEY"
Cursor · ~/.cursor/mcp.json o .cursor/mcp.jsonMCP · HTTP
{ "mcpServers": { "jurisnet": { "url": "https://mcp.jurisnet.ai/public/mcp", "headers": { "X-API-Key": "<tu-key>" } } } }
VS Code · .vscode/mcp.json (pide la key una vez)MCP · HTTP
{ "inputs": [ { "type": "promptString", "id": "jurisnet-key", "description": "JurisNet API key", "password": true } ], "servers": { "jurisnet": { "type": "http", "url": "https://mcp.jurisnet.ai/public/mcp", "headers": { "X-API-Key": "${input:jurisnet-key}" } } } }

Endpoint, transporte y header: es todo lo que necesita un cliente. El MCP acepta X-API-Key: <key> o Authorization: Bearer <key>. El servidor no guarda estado: cada solicitud se sostiene sola.

Cualquier cliente MCP por HTTPMCP · HTTP
# Endpoint https://mcp.jurisnet.ai/public/mcp # Transport streamable HTTP # Header X-API-Key: <tu-key> curl -s https://mcp.jurisnet.ai/public/mcp \ -H "X-API-Key: $JURISNET_API_KEY" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Claude en la web y en escritorio, y ChatGPT, agregan servidores remotos con OAuth, no con API keys. OAuth está en camino; mientras tanto, usa uno de los clientes de arriba.

3. Tu primera llamada REST

La misma key abre la API REST. Una llamada, una respuesta en JSON:

RESTGET
# Tesis de la Suprema Corte, primer resultado curl -s -G "https://api.jurisnet.ai/api/raw/search" \ --data-urlencode "q=suspensión del acto reclamado" \ -d country=MX -d source=MX/SCJN-Tesis -d limit=1 \ -H "X-API-Key: $JURISNET_API_KEY"

Prueba esto con tu agente

  • «Busca las tesis de la Suprema Corte sobre la suspensión del acto reclamado en el amparo y dame el enlace oficial de cada una».
  • «¿Qué leyes modificaron la Ley 24.240 de Defensa del Consumidor? Ordénalas por fecha».
  • «Busca fallos de la SCBA sobre despido por embarazo desde 2020 y resume el criterio, citando cada fallo».

Las cuatro herramientas

Respuestas reales del servicio, recortadas por largo.

get_document

Trae los metadatos y el texto de un documento por el id numérico que devuelve search. Los textos largos llegan por partes.

ParámetroTipoPor defectoQué hace
idintegerobligatorioEl id de un resultado de búsqueda.
max_charsinteger20000Caracteres de texto por llamada, hasta 100.000.
offset_charsinteger0Desde dónde leer. Pasa el text_next_offset anterior.

text_length es el largo total; text_next_offset vale null cuando ya leíste hasta el final.

Argumentosget_document
{ "id": 6317175, "max_chars": 300 }
RespuestaJSON
{ "id": 6317175, "country": "MX", "source": "MX/SCJN-Tesis", "upstream_id": "2029697", "type": "case_law", "title": "I.11o.C.28 K (11a.) — RECURSO DE QUEJA. …", "citation": null, "date": "2024-12-06", "issuer": "Tribunales Colegiados de Circuito", "lang": "es", "url": "https://sjf2.scjn.gob.mx/detalle/tesis/2029697", "text": "RECURSO DE QUEJA. QUEDA SIN MATERIA EL INTERPUESTO CONTRA LA RESOLUCIÓN DICTADA POR LA AUTORIDAD RESPONSABLE EN EL INCIDENTE DE MODIFICACIÓN DEL MONTO DE LA GARANTÍA FIJADA CON MOTIVO DE LA SUSPENSIÓN DEL ACTO RECLAMADO, SI EN EL JUICIO DE AMPARO DIRECTO SE DICTA SENTENCIA EJECUTORIA QUE CONCEDE LA ", "text_length": 2957, "text_offset": 0, "text_next_offset": 300 }

list_sources

Lista las fuentes que tu key puede leer, con totales por país y la fecha de la última corrida de actualización de cada fuente.

ParámetroTipoPor defectoQué hace
countrystring—AR, BR, CL o MX. Sin él, todos los países de tu plan.

doc_count cambia todos los días, por eso el ejemplo lo oculta. last_run es la fecha de la última actualización de esa fuente.

Argumentoslist_sources
{ "country": "MX" }
RespuestaJSON
{ "countries": { "MX": { "sources": 9, "documents": 1262629 } }, "total_documents": 1262629, "sources": [ { "id": "MX/DOF", "country": "MX", "name": "Diario Oficial de la Federación (SIDOF)", "url": "https://sidof.segob.gob.mx/dof/sidof", "doc_count": …, "last_run": "2026-11-06T07:49:48.884532+00:00" }, { "id": "MX/SCJN-Tesis", "country": "MX", "name": "Suprema Corte de Justicia de la Nación — Tesis del Semanario Judicial (texto completo)", "url": "https://sjf2.scjn.gob.mx/SJFHome/home", "doc_count": …, "last_run": "2026-11-06T22:28:43.391884+00:00" } // … ] }

get_relations

Recorre la legislación argentina: qué normas modifican una ley y qué leyes modifica ella. Datos de InfoLEG.

ParámetroTipoPor defectoQué hace
idintegerobligatorioEl id de un documento de InfoLEG (source = AR/INFOLEG-SEED).
directionstringbothmodificada_por, modifica_a o both.
limitinteger50Relaciones por página, de 1 a 200.
cursorstring—El next_cursor anterior.

Cada relación apunta a la otra norma por related_document_id, que puedes pasar a get_document.

Argumentosget_relations
{ "id": 123135, "direction": "modifica_a", "limit": 2 }
RespuestaJSON
{ "document_id": 123135, "upstream_id": "52068", "direction": "modifica_a", "relations": [ { "direction": "modifica_a", "related_document_id": 74702, "related_upstream_id": "638", "related_title": "Ley 24240 - REGIMEN LEGAL", "related_type": "legislation", "related_date": "1993-09-22", "related_url": "http://servicios.infoleg.gob.ar/infolegInternet/anexos/0-4999/638/texact.htm", "related_issuer": "HONORABLE CONGRESO DE LA NACION ARGENTINA", "infoleg_metadata": { "tipo_norma": "Ley", "numero_norma": "24240", "titulo_sumario": "DEFENSA DEL CONSUMIDOR", "texto_original": "http://servicios.infoleg.gob.ar/infolegInternet/anexos/0-4999/638/norma.htm", "texto_actualizado": "http://servicios.infoleg.gob.ar/infolegInternet/anexos/0-4999/638/texact.htm" // … }, "titulo_resumido": "MODIFICACION PARCIAL LEY 24.240", "titulo_sumario": "DEFENSA DEL CONSUMIDOR" } ], "next_cursor": null, "limit": 2 }

API REST

La API REST lee los mismos datos que las herramientas. Envía la key en X-API-Key: la API REST no acepta Authorization: Bearer.

URL base: https://api.jurisnet.ai/api/raw

Método y rutaHerramientaNotas
GET /search?q=…searchLos mismos filtros, con q en lugar de query. limit de 1 a 100, 20 por defecto. Sin offset: para paginar a fondo, usa el MCP.
GET /documents/{id}get_documentTodo el texto disponible en una sola respuesta, más raw_payload (los metadatos propios de la fuente), fetched_at y last_seen_at.
GET /sourceslist_sourcesIncluye el status de cada fuente.
GET /documents/{id}/relationsget_relationsdirection, limit (1 a 200) y cursor.

Búsqueda y filtros

  • Escribe pocas palabras clave, en el idioma de los documentos: español para Argentina, Chile y México; portugués para Brasil.
  • Pasa country siempre que lo sepas, y source cuando sepas dónde está la respuesta. Acota la búsqueda y la hace más rápida.
  • Cita las normas por número: Ley 24.240, Decreto 70/2023.
  • La respuesta trae total, la cantidad de coincidencias. Con la búsqueda mejorada trae has_more en su lugar, y match: "any_terms" cuando ningún documento tenía todas las palabras y los resultados pasan a documentos con algunas.

Paginado

  • search: suma limit a offset en cada llamada. Hasta 1.000 resultados de profundidad.
  • get_document: vuelve a llamar con offset_chars = text_next_offset hasta que sea null.
  • get_relations: pasa next_cursor como cursor hasta que sea null.

Errores y límites

Los errores de autenticación y de límite llegan como códigos HTTP:

MCPHTTP
# Missing or unknown key HTTP 401 {"error": "…", "code": "UNAUTHORIZED"} # Over the per-minute limit HTTP 429 {"error": "…", "code": "RATE_LIMITED"}

Dentro de una herramienta, los problemas de la solicitud vuelven como un resultado normal con un campo error: un documento que no existe o está fuera de tu plan, un país que tu plan no incluye, un cursor inválido. Tu agente lee el mensaje y se corrige.

MCPget_document
{ "error": "document not found" }

La API REST usa códigos HTTP para todo:

RESTHTTP
# Missing X-API-Key header HTTP 422 # Unknown, revoked or expired key HTTP 401 # Document not found or outside your plan HTTP 404

Límites

  • Solo: 30 solicitudes por minuto por key, 1 key activa.
  • Builder: 120 solicitudes por minuto por key, hasta 5 keys activas.
  • Si superas el límite, recibes 429 con RATE_LIMITED. Espera unos segundos y reintenta.
  • Una key revocada responde 401. Las keys se revocan cuando termina la suscripción.
  • Cada key lee los países de su plan: hasta 2 a elección con Solo; con Builder, hasta 5, que hoy son los cuatro disponibles (AR, BR, CL, MX). Pedir un país fuera de tu plan devuelve un error.

Texto completo, sumario o ficha

Cada documento trae sus metadatos, su cita y el enlace oficial. Cuánto texto lo acompaña depende de la fuente: en Brasil la mayoría de los documentos trae el texto completo; en Argentina, Chile y México la mayoría son fichas, con el texto donde la fuente lo publica.

  • Completo: text trae el documento entero, tal como lo publica la fuente.
  • Parcial: text trae un resumen que escribe la propia fuente (un sumario o una tesis), o el texto de solo una parte de la colección.
  • Ficha: text trae los metadatos y una descripción breve. El documento completo está en url, muchas veces un PDF oficial.

El nivel de cada fuente está en la tabla de cobertura →

Cómo citar

  • Cita la url: es la fuente oficial. JurisNet es el camino al documento, no el documento.
  • Arma la referencia con title o citation, issuer y date.
  • Antes de apoyarte en una norma, verifica en el sitio oficial que siga vigente y que ningún texto posterior la haya reemplazado.
Ejemplo
Tribunales Colegiados de Circuito, tesis I.11o.C.28 K (11a.), 2024-12-06. https://sjf2.scjn.gob.mx/detalle/tesis/2029697

JurisNet devuelve documentos de fuentes oficiales. No presta asesoramiento jurídico y no garantiza que un documento esté completo, actualizado o vigente.

¿Falta algo o hay un error en esta página? Escríbenos · help@jurisnet.ai