JurisNet
搜尋並閱讀來自阿根廷、巴西、智利和墨西哥官方來源的法律、官方公報和法院判決。唯讀。需要 JurisNet API 金鑰。
託管 MCP 伺服器
npx add-mcp 'https://mcp.jurisnet.ai/public/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
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, elige tus países y genera una API key. Se muestra una sola vez, así que guárdala como un secreto. Toda key empieza con jn_live_.
Guarda la key en una variable de entorno de tu terminal. Los comandos de esta página la leen de ahí:
Terminalbash
export JURISNET_API_KEY="<tu-key>"
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 mcp add --transport http jurisnet \ https://mcp.jurisnet.ai/public/mcp \ --header "X-API-Key: $JURISNET_API_KEY"
{ "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.
# 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 y ChatGPT: conecta con tu cuenta
Claude (web y escritorio) y ChatGPT agregan servidores remotos con tu cuenta de JurisNet, sin API key. Necesitas un plan activo con tus países elegidos en el panel. La URL del servidor es la misma: https://mcp.jurisnet.ai/public/mcp.
Claude
- Abre Conectores (
claude.ai/customize/connectors), elige «Add» y después «Add custom connector». - Ponle de nombre JurisNet, pega la URL del servidor y continúa.
- En autenticación deja la opción de iniciar sesión, agrega el conector y pulsa «Connect» si aparece.
- Se abre una página de jurisnet.ai: entra con el email de tu cuenta (te enviamos un enlace; ábrelo en ese mismo navegador) y pulsa «Autorizar».
En los planes Team y Enterprise de Claude, un Owner agrega primero el conector para la organización; después cada miembro lo conecta desde su página de conectores.
ChatGPT
- Abre
chatgpt.com/plugins, pulsa el botón + y elige «Add custom MCP server». - Escribe un nombre y una descripción y, en «Connection», pega la URL del servidor.
- Si te pregunta cómo autenticar, elige OAuth; acepta el aviso y elige «Create as a plugin».
- Entra y autoriza en jurisnet.ai. En un chat nuevo, escribe
@y elige JurisNet. - Si la página dice «Necesitas un plan activo», la cuenta con la que entraste no tiene plan: empieza uno en la página de planes y vuelve a conectar.
- Cada aplicación conectada aparece en tu panel, en «Aplicaciones conectadas», y ahí puedes desconectarla. Las conexiones usan los países y el límite por minuto de tu plan y no cuentan como API keys.
- Los nombres de los menús son de cada aplicación y pueden cambiar; sus páginas de ayuda tienen los actuales.
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.
search
Busca en todas las fuentes de tu plan. Devuelve resultados ordenados por relevancia, cada uno con su enlace oficial.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
query | string | obligatorio | Palabras clave o una cita («Ley 24.240»). |
country | string | — | Código ISO: AR, BR, CL o MX. Sin él, todos los países de tu plan. |
source | string | — | Un id de fuente de list_sources, por ejemplo AR/SCBA. |
type | string | — | Tipo de documento tal como figura en los resultados: legislation, case_law. |
date_from · date_to | string | — | Fechas ISO, AAAA-MM-DD. |
tipo_norma · numero_norma | string | — | Filtros exactos de InfoLEG: Ley y 24240. |
limit | integer | 10 | Resultados por página, de 1 a 50. |
offset | integer | 0 | Resultados a saltear, hasta 1.000. |
Cada resultado trae id (úsalo con get_document), source, type, title, citation, date, issuer, url (la fuente oficial), un text_snippet con las coincidencias marcadas con <mark> y un score de relevancia.
Argumentossearch
{ "query": "suspensión del acto reclamado", "country": "MX", "source": "MX/SCJN-Tesis", "limit": 2 }
RespuestaJSON
{ "total": 1602, "results": [ { "id": 6317175, "source": "MX/SCJN-Tesis", "upstream_id": "2029697", "type": "case_law", "title": "I.11o.C.28 K (11a.) — 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, …", "text_snippet": "GARANTÍA FIJADA CON MOTIVO DE LA <mark>SUSPENSIÓN</mark> <mark>DEL</mark> <mark>ACTO</mark> <mark>RECLAMADO</mark>, SI EN EL JUICIO DE AMPARO DIRECTO SE DICTA SENTENCIA...", "date": "2024-12-06", "url": "https://sjf2.scjn.gob.mx/detalle/tesis/2029697", "lang": "es", "issuer": "Tribunales Colegiados de Circuito", "citation": "I.11o.C.28 K (11a.) — RECURSO DE QUEJA. …", "source_metadata": { "url": "https://sjf2.scjn.gob.mx/detalle/tesis/2029697", "date": "2024-12-06", "lang": "es", "type": "case_law", "issuer": "Tribunales Colegiados de Circuito", "source_id": "MX/SCJN-Tesis", "upstream_id": "2029697" }, "score": 3.5615804195404053 } // … ] }
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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
id | integer | obligatorio | El id de un resultado de búsqueda. |
max_chars | integer | 20000 | Caracteres de texto por llamada, hasta 100.000. |
offset_chars | integer | 0 | Desde 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 actualización de cada fuente.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
country | string | — | 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" } // … ] }
get_relations
Recorre la legislación argentina: qué normas modifican una ley y qué leyes modifica ella. Datos de InfoLEG.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
id | integer | obligatorio | El id de una norma argentina de InfoLEG, tal como lo devuelve search. |
direction | string | both | modificada_por, modifica_a o both. |
limit | integer | 50 | Relaciones por página, de 1 a 200. |
cursor | string | — | 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 ruta | Herramienta | Notas |
|---|---|---|
GET /search?q=… | search | Los 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_document | Todo el texto disponible en una sola respuesta, más raw_payload (los metadatos propios de la fuente), fetched_at y last_seen_at. |
GET /sources | list_sources | Incluye el status de cada fuente. |
GET /documents/{id}/relations | get_relations | direction, 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
countrysiempre que lo sepas, ysourcecuando 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, ohas_moreen su lugar; y traematch: "any_terms"cuando ningún documento tenía todas las palabras y los resultados pasan a documentos con algunas.
Paginado
search: sumalimitaoffseten cada llamada. Hasta 1.000 resultados de profundidad.get_document: vuelve a llamar conoffset_chars=text_next_offsethasta que seanull.get_relations: pasanext_cursorcomocursorhasta que seanull.
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, unknown, revoked or expired key HTTP 401 {"detail": {"error": "…", "code": "UNAUTHORIZED"}} # 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
429conRATE_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.
Qué trae cada documento
Cada documento trae sus metadatos, su cita y el enlace oficial.
texttrae el texto tal como lo publica la fuente; su extensión depende de la fuente.urllleva a la publicación oficial, muchas veces un PDF. Úsala cuando necesites el documento tal como se publicó.- Los textos largos llegan por partes: mira el paginado.
Cómo citar
- Cita la
url: es la fuente oficial. JurisNet es el camino al documento, no el documento. - Arma la referencia con
titleocitation,issuerydate. - 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