Referência para programadores

Transporte e descoberta

O servidor usa MCP Streamable HTTP. Inicie uma sessão no endpoint, guarde o identificador e envie os pedidos MCP para o mesmo URL.

Endpoint: https://mcp.captain.legal/connect/
Transporte: Streamable HTTP
Autenticação: nenhuma para catálogo e pré-visualização
Esquemas: devolvidos por tools/list

Configuração mínima

mcp.json

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

Referência das ferramentas

Chame as ferramentas por ordem. Os esquemas devolvidos pelo servidor são a fonte oficial.

`list_document_types`

Pesquisa e pagina o catálogo qualificado por país, categoria ou texto. Inclui o preço exato.

`get_requirements`

Devolve campos, tipos, opções, condições e regras jurídicas codificadas.

`generate_document`

Valida respostas e cria uma pré-visualização PDF gratuita com marca de água e preço exato.

`purchase_document`

Cria ou reutiliza a encomenda segura. O documento final é enviado por email.

`get_document_status`

Verifica pagamento e entrega com o token de estado privado.

Ciclo recomendado

Pesquise primeiro e carregue depois os requisitos. Faça apenas as perguntas da entrevista. Gere quando todos os campos obrigatórios ativos estiverem completos. Não compre sem confirmação explícita.

Erros e repetições

Os erros têm códigos estáveis. Corrija a validação antes de repetir e use espera progressiva em falhas temporárias. A encomenda é idempotente por rascunho.

Limites de segurança

Não exponha o token de estado nem recolha dados de pagamento na conversa. Os links são assinados e expiram. Respeite o país do documento.