API de datos de Luthor

Conectar desde tu asistente

Para abogadas y abogados que usan Claude, Claude Code o ChatGPT a título personal: conectas Luthor con tu cuenta de Luthor, sin llave. Tu asistente pide autorización, entras en luthor.mx/conectar con tu sesión o con Google y apruebas la conexión en mcp.luthor.mx. Es el mismo endpoint (https://mcp.luthor.mx/mcp), con las mismas seis herramientas de sólo lectura. Empiezas gratis y sin tarjeta.

Una organización que integra sus sistemas usa una llave por organización.

Claude (web, escritorio y móvil)

1. Con tu sesión de Claude abierta, usa el enlace Agregar Luthor a Claude: abre el formulario de conector personalizado con el nombre y la URL ya puestos. También puedes agregarlo a mano con la URL https://mcp.luthor.mx/mcp.
2. Pulsa Conectar. En luthor.mx/conectar continúa con tu sesión de Luthor o con Google.
3. Revisa el consentimiento (tu cuenta, tu plan y lo que te queda del mes) y pulsa Permitir. Vuelves a Claude ya conectado.

Lo que conectas en la web sirve también en la app de escritorio y en las de iOS y Android. En el plan gratuito de Claude cabe un solo conector personalizado. El enlace, para compartirlo:

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Luthor&connectorUrl=https%3A%2F%2Fmcp.luthor.mx%2Fmcp

Claude Team o Enterprise (Owner de la organización)

El Owner lo agrega una vez para toda la organización con el enlace de administración: Agregar Luthor a la organización. Después, cada miembro pulsa Conectar y entra con su cuenta de Luthor: cada persona tiene su propio plan, su propio cupo y sus propias conexiones.

https://claude.ai/admin-settings/connectors?modal=add-custom-connector&connectorName=Luthor&connectorUrl=https%3A%2F%2Fmcp.luthor.mx%2Fmcp

Claude Code

claude mcp add --transport http luthor https://mcp.luthor.mx/mcp

Sin --header ni llave: abre /mcp dentro de Claude Code, elige luthor y autentícate; se abre tu navegador con el mismo flujo. Cada computadora es una conexión aparte.

ChatGPT (modo desarrollador)

Mientras Luthor no esté en el directorio de ChatGPT, se conecta con el modo desarrollador, si tu plan lo tiene: actívalo en la configuración de aplicaciones y conectores, crea un conector con la URL https://mcp.luthor.mx/mcp y autenticación OAuth, y sigue el mismo flujo (luthor.mx/conectar → Permitir).

Planes

Una lectura cuenta 1 unidad por fragmento y una búsqueda, 5. Sin búsqueda completa: para ti, luthor_buscar_tesis es siempre la rápida, que no pasa por modelos de lenguaje, y su esquema no trae modo. Sin excedente ni cobro por uso: agotado el mes, tu asistente te dice que tu cupo se agotó y que se renueva el día 1; al llegar al límite del día, que se renueva a las 00:00 (hora de CDMX). Toda consulta admitida cuenta para el límite del día, aunque falle. Te avisamos por correo al 80 % y al 100 % del mes.

Tu plan lo decide tu cuenta de Luthor. Luthor Conector es una suscripción mensual con tarjeta que se contrata y se administra en luthor.mx/conector/. Al contratarlo, tus conexiones lo toman a más tardar en una hora, sin reconectar, y al terminar su periodo vuelven a Gratis; con el plan Individual pasa lo mismo. Si tienes los dos, rige Luthor Conector, que trae más.

Privacidad: qué se guarda y qué no

• No se guarda el texto de tus consultas ni lo que Luthor responde, y nada de eso va a un registro. Aun así, no escribas datos de tu cliente en la consulta.
• Por cada llamada se guardan la operación, el modo, las unidades, la hora y el resultado; del documento leído, sólo una huella cifrada (HMAC) para contar la cobertura.
• Tu identidad en el servicio es un identificador opaco derivado de tu cuenta, no tu correo. Tu correo viaja cifrado dentro de la conexión: se usa para mostrártelo al conectar y en tus conexiones, y para los avisos de cupo.
• Tokens: sólo se guardan sus huellas. El de acceso dura una hora y la conexión, 30 días como máximo; después, tu asistente te pide autorizar otra vez.

Tus conexiones y cómo revocarlas

En mcp.luthor.mx/conexiones ves cada conexión (el asistente, cuándo se conectó y su último uso) y la revocas con un clic: el corte es inmediato. La página no guarda sesión: cada visita entra por luthor.mx/conectar. Cerrar sesión en luthor.mx no revoca ninguna conexión.

Puedes tener hasta 5 conexiones activas (por ejemplo, Claude, ChatGPT y Claude Code en tu computadora), y todas comparten tu cupo. Si ya tienes 5 y conectas otra, el consentimiento te dice cuál se desconectará —la de uso más antiguo— y al pulsar Permitir se revoca antes de crear la nueva.

Conexión por cliente

Un solo endpoint MCP: https://mcp.luthor.mx/mcp (especificación 2026-07-28, sin sesiones; los clientes que aún negocian con initialize usan el carril 2025-11-25 del mismo endpoint). /mcp/ con barra final responde 404. La llave viaja siempre como Authorization: Bearer; guárdala en una variable de entorno, nunca en el código.

Claude API (conector MCP)

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 4096,
    "mcp_servers": [{"type": "url", "url": "https://mcp.luthor.mx/mcp", "name": "luthor",
                     "authorization_token": "lxk_live_…"}],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "luthor"}],
    "messages": [{"role": "user", "content": "¿Qué tesis interpretan el artículo 42 del CFF?"}]
  }'

Claude Code

claude mcp add --transport http luthor https://mcp.luthor.mx/mcp \
  --header "Authorization: Bearer lxk_live_…"

OpenAI Responses

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "<tu modelo>",
    "tools": [{"type": "mcp", "server_label": "luthor", "server_url": "https://mcp.luthor.mx/mcp",
               "authorization": "lxk_live_…", "require_approval": "never"}],
    "input": "¿Qué tesis interpretan el artículo 42 del CFF?"
  }'

Cursor (.cursor/mcp.json o ~/.cursor/mcp.json)

{
  "mcpServers": {
    "luthor": {
      "url": "https://mcp.luthor.mx/mcp",
      "headers": { "Authorization": "Bearer ${env:LUTHOR_API_KEY}" }
    }
  }
}

REST

curl https://mcp.luthor.mx/v1/tesis/buscar \
  -H "Authorization: Bearer lxk_live_…" -H "Content-Type: application/json" \
  -d '{"consulta": "domicilio fiscal", "limite": 3}'

curl "https://mcp.luthor.mx/v1/articulos/CFF-art-17-H-Bis?fragmento=2" -H "Authorization: Bearer lxk_live_…"

El cuerpo de éxito de la REST es el mismo JSON que el structuredContent de la tool gemela. Esquema completo: OpenAPI 3.1.

Operaciones

Seis operaciones, gemelas en las dos puertas: misma entrada, misma salida y mismo cobro.

Buscar tesis — luthor_buscar_tesis

Busca por significado y por palabras tesis del Archivo Soberano Luthor: jurisprudencias y tesis aisladas del Poder Judicial de la Federación y, según el plan, del Tribunal Federal de Justicia Administrativa. Úsala cuando necesites criterios judiciales sobre un tema o un problema jurídico y aún no tengas el identificador de la tesis. Devuelve hasta 10 resultados con extracto, posición, puntaje, procedencia, estado y situación de la tesis, la fecha de corte del archivo y, en las del Tribunal Federal de Justicia Administrativa, a quién obligan.

REST: POST /v1/tesis/buscar (cuerpo JSON). MCP: tool luthor_buscar_tesis. Cobro: 5 unidades la rápida y 20 la completa (se cobra el modo que de verdad corrió: modo_efectivo).

Entrada

Salida (structuredContent y cuerpo de la REST)

Leer tesis — luthor_leer_tesis

Lee una tesis del Archivo Soberano Luthor por su identificador (JP-… del Poder Judicial de la Federación o, según el plan, TFJA-… del Tribunal Federal de Justicia Administrativa). Úsala cuando ya tengas el identificador de la tesis (p. ej. de un resultado de luthor_buscar_tesis) y necesites su texto para citarla o analizarla. Devuelve el texto por fragmentos fijos, con procedencia, estado y situación de la tesis, el truncado declarado y la fecha de corte del archivo.

REST: GET /v1/tesis/{id} (con ?fragmento=N opcional; el id va sólo en la ruta). MCP: tool luthor_leer_tesis. Cobro: 1 unidad por fragmento entregado.

Entrada

Salida (structuredContent y cuerpo de la REST)

Buscar artículos — luthor_buscar_articulo

Busca por coincidencia léxica artículos de las 16 leyes de Luthor. Úsala cuando necesites saber qué artículos regulan un tema y no conozcas su número, en todas las leyes o en una sola. Devuelve hasta 10 resultados con extracto, URL, posición, puntaje, procedencia y vigencia.

REST: POST /v1/articulos/buscar (cuerpo JSON). MCP: tool luthor_buscar_articulo. Cobro: 5 unidades (es léxica: siempre rápida).

Entrada

Salida (structuredContent y cuerpo de la REST)

Leer artículo — luthor_leer_articulo

Lee un artículo de las 16 leyes de Luthor, por identificador o por ley y número. Úsala cuando necesites el texto de un artículo o de una regla que ya identificaste, p. ej. para citarlo o revisar su vigencia. Devuelve el texto por fragmentos fijos, con procedencia, vigencia y el truncado declarado.

REST: GET /v1/articulos/{id} (con ?fragmento=N opcional; el id va sólo en la ruta). MCP: tool luthor_leer_articulo. Cobro: 1 unidad por fragmento entregado.

Por MCP se pide con id o con ley y articulo, nunca con los dos.

Entrada

Salida (structuredContent y cuerpo de la REST)

Buscar ordenamientos — luthor_buscar_ordenamiento

Busca por palabras normas del Archivo Soberano Luthor: leyes, códigos, reglamentos, decretos y tratados de todo México (federales, de las 32 entidades federativas e internacionales). Úsala cuando necesites ubicar una norma que no está en las 16 leyes de Luthor, p. ej. una ley estatal, un código civil local o un tratado, y aún no tengas su identificador. Devuelve hasta 10 normas con su identificador ORD-, título, ámbito, entidad y categoría, la vigencia declarada con su fuente y su fecha de corte, y la versión vigente con el tipo de texto que tiene.

REST: POST /v1/ordenamientos/buscar (cuerpo JSON). MCP: tool luthor_buscar_ordenamiento. Cobro: 5 unidades (es léxica: siempre rápida).

Entrada

Salida (structuredContent y cuerpo de la REST)

Leer ordenamiento — luthor_leer_ordenamiento

Lee el texto de una norma del Archivo Soberano Luthor por su identificador (ORD-… de luthor_buscar_ordenamiento): todo su articulado por fragmentos fijos, un artículo por su número o los artículos que tratan un tema. Úsala cuando ya tengas el identificador de la norma y necesites su texto para citarla o analizarla. Devuelve el texto de la versión vigente, o de la versión pedida, como transcripción sin cotejar de la versión publicada, con su procedencia, la vigencia declarada y el truncado declarado; si esa versión sólo existe como facsímil, responde SIN_TEXTO_LEGIBLE y no hay texto que citar.

REST: GET /v1/ordenamientos/{id} (con ?fragmento=N y ?articulo= o ?consulta= opcionales; el id va sólo en la ruta). MCP: tool luthor_leer_ordenamiento. Cobro: 1 unidad por fragmento entregado.

Se pide con articulo o con consulta, nunca con los dos; sin ninguno, se lee todo el articulado por fragmentos. Si la versión sólo existe como facsímil, responde SIN_TEXTO_LEGIBLE (sin cobro): no hay texto que citar.

Entrada

Salida (structuredContent y cuerpo de la REST)

Errores y qué hacer

Ningún error cobra. Por REST llegan como application/problem+json; por MCP, los de validación y negocio vuelven como resultado de tool con isError:true para que el modelo corrija su llamada, y el único error de protocolo es una tool desconocida o un mensaje mal formado. Un 429 o un 503 traen Retry-After. Ningún error lleva tu consulta, el texto de un documento ni tu llave.

Forma del error

Límites

Unidades y precios

Precios en MXN más IVA. La cuota es una bolsa de unidades por mes (hora de CDMX): una lectura = 1 unidad por fragmento, una búsqueda rápida = 5 y una búsqueda completa de tesis = 20. Una búsqueda sin resultados sí se cobra. Un error nunca.

Cada organización fija un tope de gasto mensual en excedente (por omisión, igual a la cuota base). Al alcanzarlo, las llamadas se rechazan sin cobro hasta el mes siguiente o hasta que el administrador lo suba. Cada respuesta REST exitosa trae la cabecera Luthor-Unidades con lo cobrado (un error no cobra y no la trae). Facturación mensual por transferencia contra CFDI.

Corpus y cobertura

Tesis: el Archivo Soberano Luthor, 311,972 tesis del Poder Judicial de la Federación en la búsqueda rápida y en la completa (sin filtro de época se busca de la Novena a la Duodécima, y el Tribunal Electoral; la Quinta a la Octava, con el filtro epoca); la búsqueda completa suma además las 48,242 del Tribunal Federal de Justicia Administrativa, que se cuentan aparte, se entregan después de las del Poder Judicial y llevan su peso. Leyes: 16 (CFF, LISR, LIVA, LFPCA, RCFF, RLISR, RLIVA, RMF-2026, LAMP, LOTFJA, CPEUM, RISAT, LFT, CNPP, CPF, CCOM), 5,880 artículos. Cada respuesta declara su corpus.corte: la fecha de la última publicación de esa familia o el corte del archivo. No se promete frescura; revisa esa fecha.

Techo de cobertura: además de la cuota, cada plan tiene un máximo de documentos distintos leídos en 30 días móviles: Developer 4,000 y Growth 15,000. Releer un documento no cuenta dos veces. Rebasarlo es COBERTURA_AGOTADA; para volúmenes mayores está el plan Datos. Los términos prohíben reconstruir el corpus, revenderlo o entrenar modelos sin licencia de Datos.

Normativa: además de las 16 leyes, la normativa del Archivo Soberano Luthor —federal, de las 32 entidades federativas y los tratados internacionales— con luthor_buscar_ordenamiento y luthor_leer_ordenamiento. Cada norma trae su vigencia_ordenamiento declarada (con su fuente, su fecha de corte y su confianza: la del catálogo es registrada, no verificada) y su version_vigente, con el tipo de texto que tiene. Muchas normas estatales sólo existen como facsímil (imagen): su lectura es SIN_TEXTO_LEGIBLE y su texto nunca se reconstruye.

Atribución: la fuente que debes citar es «Archivo Soberano Luthor». Cada documento trae su procedencia (órgano, clave, registro, época y localización en tesis; ley y número en artículos; ámbito, entidad y categoría en la normativa).

Sandbox

Endpoint: https://sandbox.luthor.mx/mcp y https://sandbox.luthor.mx/v1/…. Llaves lxk_test_. Gratis, 100 llamadas por día (hora de CDMX), sin acuerdo de nivel de servicio. Una llave test contra producción, o una live contra el sandbox, recibe 403.

El sandbox responde desde un corpus fijo: CFF y LIVA completos y 1,000 tesis. Las respuestas las genera de antemano el mismo código del servicio, sobre ese subconjunto reconstruido de las fuentes del corpus: tienen el mismo contrato, los mismos errores y las mismas unidades. Diferencias que conviene conocer:

• Las búsquedas sólo responden las consultas de abajo (sin distinguir mayúsculas ni espacios de sobra), con limite de 1 a 10 y sin filtros. Cualquier otra es ARGUMENTO_INVALIDO con el campo que falló.
• En las búsquedas de tesis, el orden es el que entregó el servicio real a esa consulta y el puntaje va en 0.
• corpus.corte es null y estado_tesis queda NO_VERIFICADO con su causa.
• Un documento fuera del subconjunto es NO_ENCONTRADO.

Consultas de tesis (rápida y completa)

• interpretación jurisprudencial del art. 42 CFF
• interpretación jurisprudencial del art. 69-B CFF
• interpretación jurisprudencial del art. 2-A LIVA
• tesis aplicables al artículo 63 de la Ley Federal de Procedimiento Contencioso Administrativo
• tesis aplicables al artículo 61 de la Ley de Amparo
• criterios judiciales sobre el artículo 93 LISR
• criterios judiciales relativos a orden de visita domiciliaria
• jurisprudencia sobre el concepto de comprobante fiscal digital (cfdi)
• jurisprudencia sobre el concepto de derecho de audiencia previa
• suspensión provisional en el amparo
• aseguramiento precautorio de los bienes o de la negociación del contribuyente
• competencia concurrente prevista en el artículo 104 constitucional

Consultas de artículos (sin ley, o con ley CFF o LIVA)

• domicilio fiscal
• buzón tributario
• certificado de sello digital
• firma electrónica avanzada
• operaciones inexistentes
• tasa del 0%
• exportación
• acreditamiento

Normativa del archivo (12 normas fijas)

Cuatro federales, cuatro tratados y cuatro estatales, con una que sólo existe como facsímil (su lectura es SIN_TEXTO_LEGIBLE), una abrogada y su homónima vigente. Se leen por su id (su articulado completo, su versión vigente explícita y cada artículo por su número) y con la consulta indicada; otra lectura es NO_ENCONTRADO.

• ORD-160795 · por consulta: horario estacional
• ORD-9806 · por consulta: acción penal
• ORD-142630 · por consulta: amnistía
• ORD-91 · por consulta: tratado
• ORD-23754 · por consulta: controversia
• ORD-107392 · por consulta: certificado de origen
• ORD-11155 · por consulta: convenio
• ORD-149530 · por consulta: buques
• ORD-77211 · por consulta: declaratoria
• ORD-32098
• ORD-139229 · por consulta: amnistía
• ORD-136400 · por consulta: conducta

Consultas de normas (sin filtros)

• ley de amnistía
• husos horarios
• celebración de tratados
• convención
• tratado de libre comercio
• emergencia policial
• código de conducta
• desarrollo pecuario

Estado del servicio

Sondas sintéticas con hora de CDMX: https://mcp.luthor.mx/status (también en JSON: https://mcp.luthor.mx/status.json, con la fuente de cada componente). Las cuatro operaciones de tesis y artículos se sondean contra el sandbox, que no pasa por la búsqueda semántica ni por modelos de lenguaje, y un componente aparte mide el almacenamiento del servicio. No miden el camino de producción completo: una falla ahí se publica en la misma página como incidente.

Versiones y deprecación

La REST se versiona por ruta (/v1/) y las tools por nombre estable. Un cambio compatible agrega un campo opcional. Un cambio incompatible es una operación nueva o una versión nueva del contrato, con aviso de 90 días antes de retirar la anterior; la fecha de retiro se publica aquí y en el _meta de la tool que se retira.

Cambios

Soporte

Un solo canal: jccc@bytx.dev. Growth: respuesta en un día hábil.

La información que entrega esta API es de consulta. No constituye asesoría jurídica ni sustituye la revisión de un profesional del derecho.