Référence développeur | MCP Captain.Legal

Transport et découverte

Le serveur utilise MCP Streamable HTTP. Initialisez une session sur l’endpoint, conservez l’identifiant renvoyé et envoyez les requêtes MCP standards à la même adresse.

Endpoint : https://mcp.captain.legal/connect/
Transport : Streamable HTTP
Authentification : aucune pour le catalogue et l’aperçu
Schémas du protocole : renvoyés par tools/list

Configuration minimale du client

mcp.json

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

Référence des outils

Appelez les outils dans l’ordre. Les schémas renvoyés par le serveur font foi pour les champs obligatoires.

`list_document_types`

Recherche et pagination dans le catalogue qualifié. Filtres : code pays ISO, catégorie et texte libre. Le prix exact à payer est inclus.

`get_requirements`

Renvoie le questionnaire du modèle : champs, types, options, conditions et règles juridiques encodées.

`generate_document`

Valide les réponses, crée un brouillon et renvoie gratuitement un aperçu PDF filigrané avec son prix exact.

`purchase_document`

Crée ou réutilise la commande sécurisée du brouillon. Le document final est envoyé par email après paiement.

`get_document_status`

Vérifie le paiement et la livraison avec le jeton privé renvoyé par l’outil d’achat.

Cycle recommandé

Commencez par la recherche, puis chargez le questionnaire. Ne posez que les questions prévues et conservez les identifiants des champs. Générez le document lorsque tous les champs obligatoires actifs sont remplis. Ne lancez jamais l’achat sans confirmation explicite.

Erreurs et nouvelles tentatives

Les erreurs d’outil ont un code stable et un message lisible. Corrigez les erreurs de validation avant de recommencer. Pour une indisponibilité temporaire, utilisez un délai progressif. Ne bouclez pas sur la création du paiement : elle est idempotente par brouillon.

Limites de sécurité

Ne montrez pas le jeton de suivi, sauf demande explicite. Ne recueillez jamais de données bancaires dans la conversation. Les liens d’aperçu et de paiement sont signés et expirent. Utilisez le pays du document sélectionné sans déduire une autre juridiction.