Documentación de LexGraph MCP

Conexión y autenticación

LexGraph ofrece un endpoint Streamable HTTP sin estado. Las solicitudes y respuestas usan JSON; el endpoint de producción no transmite notificaciones de progreso por SSE.

MCP URL: https://api.lexgraph.de/mcp

Transporte

MCP Streamable HTTP

Autenticación

OAuth 2.0 o clave MCP

Scope de OAuth

mcp

Modo de respuesta

una respuesta JSON por solicitud

OAuth 2.0 (recomendado)

Los clientes compatibles con OAuth se conectan mediante registro dinámico y Authorization Code con PKCE. El cliente gestiona automáticamente el registro, el intercambio y la renovación de tokens.

1. Añade la URL de MCP como servidor MCP remoto personalizado en tu cliente.
2. Selecciona OAuth 2.0 con registro dinámico de clientes si el cliente lo solicita.
3. Inicia sesión en LexGraph y autoriza la conexión.
4. Después de la redirección, el cliente carga la lista actual de herramientas de LexGraph.

Clave MCP (para autenticación por header)

Los clientes sin OAuth pueden usar una clave MCP personal. Créala en tu perfil de LexGraph y envía Authorization: Bearer <MCP_KEY>. La clave completa solo se muestra una vez; rotarla revoca la anterior, pero no reinicia el cupo.

Herramientas disponibles

lexgraph_search_legal_graph

Crea en el servidor un memorando jurídico terminado, con enlaces permanentes de LexGraph y un contrato vinculante de salida literal.

lexgraph_search_legal_graph_enriched

Crea el mismo memorando y añade las entidades realmente citadas como contexto legible por máquina para preguntas posteriores.

lexgraph_search_legal_data

Usa las mismas rutas de investigación de Engine sin generar respuesta. Para una resolución identificada inequívocamente, su description contiene las secciones de texto completo disponibles.

lexgraph_get_capabilities

Devuelve la versión del esquema, las rutas de búsqueda elegidas por el servidor, las fuentes según el plan, los límites y el contrato de idempotencia.

lexgraph_get_mcp_usage

Devuelve el plan y el estado actual del cupo sin consumirlo.

Las cinco herramientas son de solo lectura, no destructivas y se limitan a datos públicos de LexGraph. Los diagnósticos y controles de desarrollo permanecen en la vista previa local de administración. Los argumentos desconocidos se rechazan.

Parámetros y respuestas

lexgraph_search_legal_graph

lexgraph_search_legal_graph_enriched

lexgraph_search_legal_data

lexgraph_get_capabilities

Sin parámetros. Devuelve schema_version, las rutas del servidor lexgraph_legal_agent, lexgraph_cases y lexgraph_entity, las fuentes según el plan, los límites fijos de Engine y el contrato de request_id/idempotencia. No consume cupo de investigación.

lexgraph_get_mcp_usage

Sin parámetros. Devuelve el plan y limit, remaining, used y reset_at del cupo de investigación. Esta llamada no consume cupo.

Respuesta de búsqueda

• LexGraph Memorandum devuelve answer seguido de response_contract con mode=verbatim, instrucción de salida, estándar de citas y suma SHA-256.
• LexGraph Memorandum Enriched añade searchable_entities. Es solo contexto y no debe adjuntarse a la respuesta visible.
• LexGraph Legal Data devuelve trace_id, original_query, search_mode, count, entities, quota_charged y usage, pero no answer.
• En una consulta directa inequívoca de una resolución, la description de la entidad principal contiene secciones disponibles como sumarios, fallo, hechos y fundamentos.
• Las entidades normativas pueden contener book, slug y prefix_category; las fuentes resolubles incluyen enlaces Markdown listos para citar.
• No se devuelven públicamente puntuaciones internas de reranking, diagnósticos ni controles locales de desarrollo.

Modos de búsqueda, colecciones y planes

Las colecciones no incluidas en el plan se filtran en el servidor. Si no queda ninguna, la llamada falla.

Otros límites técnicos de la cuenta

• 30 solicitudes por minuto
• 1.000 solicitudes por día
• 2.000.000 de caracteres de solicitud al mes
• máximo de 20.000 caracteres por solicitud
• el alcance y el número de candidatos los fija el servidor

Ejemplos de llamadas

Consultar las funciones de la cuenta actual

{}

Memorando con un ID de reintento seguro

{
  "query": "¿Qué resoluciones alemanas de derecho laboral del BAG desde 2020 son relevantes?",
  "request_id": "search-20260821-001"
}

Cupos y reintentos seguros

• Las investigaciones en LexGraph Engine y las búsquedas MCP correctas comparten el mismo cupo de la cuenta.
• El plan Free incluye 25 consultas de investigación. Las cuentas nuevas reciben diez días desde su creación y las existentes diez días desde la introducción del modelo. Después no se permiten más investigaciones.
• Una búsqueda correcta consume una consulta del cupo semanal compartido, además del uso normal de solicitudes y caracteres. Las búsquedas fallidas no se cobran. El cupo semanal se restablece los lunes.
• Los derechos del plan y el cupo se aplican en el servidor en cada llamada; capabilities y usage solo muestran snapshots de estado de lectura.
• request_id es opcional para la búsqueda. Repetirlo con parámetros idénticos en ocho días no cobra dos veces; usarlo con parámetros distintos se rechaza.
• El cupo está vinculado a la cuenta. Rotar una clave MCP no lo reinicia.

Errores y códigos

• HTTP 401: falta la autenticación, es inválida o ha caducado.
• HTTP 403: falta el scope necesario o el acceso a la cuenta.
• JSON-RPC -32601: herramienta desconocida o eliminada.
• JSON-RPC -32602: parámetros inválidos, campos desconocidos o valores no compatibles.
• Error de herramienta: cupo agotado, el plan no permite un modo/colección, conflicto de request_id o error interno. No todos los errores de herramienta son errores HTTP.

Privacidad y uso de datos

Las consultas de búsqueda MCP se anonimizan localmente en el servidor de LexGraph antes de iniciar la investigación. Se detectan personas, direcciones, correos electrónicos y otros identificadores estructurados y se sustituyen por marcadores tipificados. Para este paso no se llama a ningún servicio externo de PII; solo la consulta depurada pasa a las siguientes etapas de búsqueda. LexGraph también procesa los parámetros y los números de expediente seleccionados para ejecutar la herramienta. El identificador de cuenta se usa para controlar el acceso, analizar el uso y calcular los cupos. Las herramientas MCP no cargan documentos, no acceden a documentos privados ni modifican el grafo. El perfilado HTTP de MCP registra datos como marcas de tiempo, herramienta, estado, duraciones, tamaño de respuesta y request_id si se proporciona, pero no la consulta ni el token de autenticación. No envíes tokens ni claves secretas al soporte.

Limitaciones conocidas

• Memorandum y Memorandum Enriched devuelven una respuesta terminada; solo Legal Data deja la redacción al asistente conectado.
• La cobertura depende del material disponible actualmente en LexGraph y puede ser incompleta.
• El modo, las fuentes, la descomposición, el número de candidatos y el reranking se eligen exclusivamente en el servidor en la versión 3.0.0 y no son argumentos públicos.
• Solo una consulta directa inequívoca de una resolución mediante Legal Data puede incluir las secciones de texto completo disponibles en description; una búsqueda jurisprudencial general no garantiza el texto íntegro.
• searchable_entities de la herramienta Enriched es solo contexto legible por máquina y no debe emitirse junto a la respuesta terminada.
• El progreso se informa internamente solo después de 45 segundos; el endpoint JSON de producción no lo transmite a clientes HTTP.
• Los resultados son ayudas de investigación y no sustituyen una evaluación jurídica profesional.

Registro de cambios

3.0.0 · 21 August 2026

• El MCP público ahora llama a las mismas funciones que la vista previa interna, de modo que vista previa y publicación comparten una sola ruta de ejecución.
• El contrato público contiene cinco herramientas de solo lectura: Memorandum, Memorandum Enriched, Legal Data, Capabilities y Usage.
• Las tres herramientas de investigación solo aceptan query y request_id opcional. El cliente copia el mensaje original literalmente; el servidor elige modo, fuentes, descomposición, límites y reranking.
• Memorandum devuelve answer y un response_contract verificable criptográficamente y exige salida literal. Enriched añade solo searchable_entities citadas; Legal Data devuelve entidades sin respuesta terminada.
• El routing automático usa lexgraph_legal_agent, lexgraph_cases o lexgraph_entity. Los modos y parámetros de búsqueda elegidos por el cliente ya no forman parte del esquema público v3.
• Las normas pueden contener book, slug y prefix_category; los enlaces permanentes y metadatos de cita permanecen en las entidades serializadas.
• La anonimización local se ejecuta antes del fingerprint de idempotencia y la búsqueda. Los límites de cuenta siguen usando la longitud original; si falla la anonimización, la búsqueda no empieza.
• Los diagnósticos en bruto y controles de desarrollo siguen en la vista previa local protegida, mientras sus rutas predeterminadas ejecutan las mismas funciones que /mcp.

2.3.1 · 19 August 2026

• El límite predeterminado de la búsqueda MCP cambió de 40 a 30 resultados.

2.3.0 · 19 August 2026

• La selección de modos se redujo a embeddings, graph_search y agentic_search.
• Graph Search asume ahora el routing estándar y los fallbacks de retrieval.

2.2.2 · 18 August 2026

• El límite predeterminado de la búsqueda MCP aumentó de 20 a 40 resultados.

2.2.1 · 18 August 2026

• embeddings es ahora el modo predeterminado de búsqueda MCP; graph_search sigue disponible de forma explícita.

2.2.0 · 14 August 2026

• lexgraph_get_capabilities devuelve ahora las recomendaciones actuales completas de áreas jurídicas y códigos normalizados de tribunales en search.filters.recommended_values.
• Las recomendaciones siguen abiertas a valores futuros o específicos de la base de datos y no se validan como enums de entrada cerrados.

2.1.0 · 14 August 2026

• Añadido el objeto opcional filters para área jurídica, región, tribunal e intervalo temporal.
• Documentada la semántica AND/OR según la fuente y las normas estatales recuperadas mediante Arango Views configuradas.
• Excluidas temporalmente las normas de la UE y las resoluciones europeas cuando hay filtros activos.

2.0.1 · 1 August 2026

• Añadidos lexgraph_get_capabilities y el contrato de esquema 2.0.1.
• limit=20 ahora es un valor explícito del esquema; usa un valor inferior solo si el usuario pide menos resultados.
• Documentadas las colecciones por plan, la disponibilidad agentic y los cupos semanales corregidos.
• Añadidos request_id, quota_charged, parámetros efectivos y contratos de respuesta.

2.0.0 · 1 August 2026

• Introducidos cuatro modos de búsqueda, el comportamiento de quality control y esquemas estrictos.
• Documentadas las relaciones opcionales.
• Eliminadas las herramientas antiguas de respuestas y extracción de referencias.

Soporte

Para preguntas técnicas e incidencias, escribe al soporte de MCP: office@lexgraph.de.