Référence des outils MCP

Le catalogue ci-dessous repose sur les mêmes définitions que celles transmises aux clients MCP pendant la découverte des outils. Chaque page de référence ajoute les prérequis humains, les prompts, des exemples, le résultat attendu et des conseils pour résoudre les erreurs.

Pièces jointes natives

linkedin_message accepte le paramètre facultatif attachments. linkedin_invite_then_message accepte follow_up_attachments pour le message envoyé après acceptation. Le texte reste obligatoire. Chaque message peut contenir jusqu’à 5 fichiers et 20 000 000 octets au total, avec 200 Mo de stockage privé par espace de travail. Les PDF, MP4/MOV, PNG/JPG/GIF/BMP, documents Office et TXT/CSV/RTF sont validés par extension, type MIME et contenu. Le HTML et les exécutables ne sont pas pris en charge. Le fournisseur peut refuser les fichiers incompatibles avec la boîte de réception sélectionnée.

Pour un fichier local, sélectionnez-le avec le trombone dans l’inbox SalesTouch. L’application importe des morceaux de 2 Mo maximum via le parcours authentifié /api/linkedin/attachments, puis finalise le fichier. Utilisez son attachment_id dans un message d’agent. Les clients peuvent commencer par POST /api/linkedin/attachments avec account_id, filename, content_type, size_bytes, envoyer les morceaux bruts via POST /api/linkedin/attachments/{id} avec Content-Type: application/octet-stream et Upload-Offset, puis finaliser par PUT sur cette URL. GET renvoie le statut et la position des octets reçus ; DELETE retire un import inutilisé. Le serveur n’ouvre jamais un chemin local fourni par l’appelant.

Un agent peut aussi fournir content_base64 (base64 canonique sans préfixe de data URL) ou une url HTTPS publique, avec filename et content_type. Les URL utilisent le port 443 ; les réseaux privés et réservés, les redirections dangereuses et les téléchargements dépassant 15 secondes sont refusés. Chaque mode conserve les octets privés avant la mise en file. L’aperçu natif des médias est utilisé par défaut ; send_mode: "file" demande un fichier téléchargeable lorsque le fournisseur le permet.

queue et scheduled_for conservent les références des fichiers avec l’action. Les suivis après acceptation gardent les fichiers jusqu’à 90 jours après l’invitation planifiée ; les imports inachevés expirent après 24 heures et les fichiers livrés après 7 jours. Les envois en file gardent leurs fichiers jusqu’à la livraison. Les résultats incertains conservent leurs métadonnées de diagnostic et bloquent le renvoi automatique.

Réutilisez idempotency_key pour reprendre un message avec pièces jointes. Sans clé, les messages ayant le même destinataire, texte et fichiers sont dédupliqués. Utilisez une nouvelle clé uniquement pour un nouvel envoi volontaire. Les réponses incluent attachment_delivery_id, le statut et les identifiants des fichiers ; les réponses de suivi les exposent sous follow_up. Consultez le statut via le point d’accès authentifié GET /api/linkedin/attachment-deliveries/{id}. ATTACHMENT_SEND_UNCERTAIN impose de vérifier la conversation avant un nouvel envoi. Les erreurs d’import, de droits, de contenu, de taille et d’URL ont des codes explicites.

{
  "identifier": "https://www.linkedin.com/in/example",
  "text": "Here is the brochure we discussed.",
  "attachments": [{"filename": "brochure.pdf", "content_type": "application/pdf", "url": "https://example.com/brochure.pdf"}],
  "idempotency_key": "brochure-prospect-2026-10",
  "queue": true
}

Outils e-mail

Les outils e-mail nécessitent la permission e-mail sur votre connexion MCP et une boîte mail connectée.

• email_accounts : boîtes mail, capacité quotidienne, warmup et lien de connexion quand aucune ne peut envoyer.
• email_send : un e-mail personnel ou une réponse. Un e-mail isolé part immédiatement ; les envois groupés passent en file.
• email_conversations : conversations avec vos leads dans toutes vos boîtes, avec needs_reply et la recherche plein texte.
• email_messages : un fil page par page, avec le texte complet des messages.
• email_threads : tous les fils d’e-mails et les envois programmés d’un lead.
• email_attachment : un fichier joint à un e-mail, avec son lien de téléchargement ; les fichiers texte et CSV incluent leur contenu.

email_send accepte jusqu’à 5 attachments (15 Mo au total) : un attachment_id issu de email_messages pour transférer un fichier reçu, une url HTTPS publique ou content_base64. Les fichiers reçus sont conservés 90 jours ; au-delà de 15 Mo, seuls leur nom et leur taille sont gardés.