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ámetroTipoPor defectoQué hace
querystringobligatorioPalabras clave o una cita («Ley 24.240»).
countrystring—Código ISO: AR, BR, CL o MX. Sin él, todos los países de tu plan.
sourcestring—Un id de fuente de list_sources, por ejemplo AR/SCBA.
typestring—Tipo de documento tal como figura en los resultados: legislation, case_law.
date_from · date_tostring—Fechas ISO, AAAA-MM-DD.
tipo_norma · numero_normastring—Filtros exactos de InfoLEG: Ley y 24240.
limitinteger10Resultados por página, de 1 a 50.
offsetinteger0Resultados 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á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 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" } // … ] }

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 una norma argentina de InfoLEG, tal como lo devuelve search.
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, o has_more en su lugar; y trae 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, 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 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.

Qué trae cada documento

Cada documento trae sus metadatos, su cita y el enlace oficial.

  • text trae el texto tal como lo publica la fuente; su extensión depende de la fuente.
  • url lleva 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 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