Referencia para desarrolladores

Transporte y descubrimiento

El servidor usa MCP Streamable HTTP. Inicia una sesión en el endpoint, conserva su identificador y envía las peticiones MCP a la misma URL.

Endpoint: https://mcp.captain.legal/connect/
Transporte: Streamable HTTP
Autenticación: ninguna para catálogo y vista previa
Esquemas: devueltos por tools/list

Configuración mínima

mcp.json

{
  "mcpServers": {
    "captain-legal": {
      "type": "streamable-http",
      "url": "https://mcp.captain.legal/connect/"
    }
  }
}

Referencia de herramientas

Llama a las herramientas en orden. Los esquemas del servidor son la fuente de verdad.

`list_document_types`

Busca y pagina el catálogo validado por país, categoría o texto. Incluye el precio exacto.

`get_requirements`

Devuelve la entrevista: campos, tipos, opciones, condiciones y reglas jurídicas codificadas.

`generate_document`

Valida respuestas y devuelve una vista previa PDF gratuita con marca de agua y precio exacto.

`purchase_document`

Crea o reutiliza la orden de pago segura. El documento final se envía por correo.

`get_document_status`

Consulta el pago y la entrega con el token privado de seguimiento.

Ciclo recomendado

Busca primero y carga después los requisitos. Pregunta solo lo definido por la entrevista. Genera cuando todos los campos activos obligatorios estén completos. No compres sin confirmación expresa.

Errores y reintentos

Los errores tienen códigos estables. Corrige la validación antes de repetir y usa espera progresiva para fallos temporales. La orden es idempotente por borrador.

Límites de seguridad

No expongas el token de seguimiento ni recojas datos de pago en el chat. Los enlaces están firmados y caducan. Respeta el país del tipo de documento.