Sendlet

npx add-mcp 'https://sendlet.email/mcp/{endpoint}'

Premiers pas

1. Connectez-vous à sendlet.email avec votre adresse e-mail. Un nouveau compte comprend déjà un destinataire accepté : vous.
2. Ajoutez les personnes auxquelles vos agents peuvent envoyer des e-mails. Chacune reçoit une invitation et doit l’accepter avant de recevoir quoi que ce soit.
3. Créez un endpoint pour un destinataire ou un groupe : une URL privée pour un agent, avec sa propre limite quotidienne. Copiez-la lorsqu’elle s’affiche ; pour des raisons de sécurité, elle n’est affichée qu’une seule fois.
4. Transmettez l’URL à votre agent, ou ajoutez son adresse MCP à Claude. Chaque envoi apparaît dans votre journal des envois.

Les URL des endpoints ressemblent à https://sendlet.email/to/sam-k7F2x9Qa4mB8nR1vT6yZ3c. Toute personne disposant de l’URL peut envoyer des e-mails à ce destinataire, dans la limite autorisée. Traitez-la donc comme un mot de passe : vous pouvez la suspendre, la renouveler ou la révoquer à tout moment.

Envoyer par HTTP

Envoyez une requête POST JSON à l’URL de l’endpoint :

POST https://sendlet.email/to/sam-k7F2x9Qa4mB8nR1vT6yZ3c
Content-Type: application/json

{"subject": "Short summary", "body": "Message text. **Markdown** is supported."}

subject

Obligatoire. Une ligne, jusqu’à 200 caractères. Également accepté sous la forme title.

body

Obligatoire. Texte brut ou Markdown, jusqu’à 50 000 caractères. Également accepté sous la forme message, text ou content.

idempotency_key

Facultatif. Jusqu’à 100 de A-Z a-z 0-9 _ . : -. Une même clé utilisée dans un délai de 10 minutes ne déclenche qu’un seul envoi ; les nouvelles tentatives sont donc sans risque. Également accepté comme en-tête Idempotency-Key.

attachments

Facultatif, si votre forfait inclut les pièces jointes. Voir ci-dessous.

Les requêtes de formulaire (application/x-www-form-urlencoded) utilisent les mêmes champs. Avec text/plain ou text/markdown, la première ligne correspond à l’objet et le reste au corps du message.

Fichiers et images

Ajoutez un tableau attachments contenant le nom et le contenu base64 de chaque fichier, ou envoyez une requête POST à multipart/form-data :

curl -F subject="Floor plan" -F body="![Floor plan](plan.png)" -F [email protected] \
     https://sendlet.email/to/sam-k7F2x9Qa4mB8nR1vT6yZ3c

• Jusqu’à 10 fichiers par e-mail. La taille autorisée dépend de votre forfait ; la description GET de l’endpoint indique la limite disponible.
• Types autorisés : png, jpg, jpeg, gif, webp, pdf, txt, csv, md, json, ics, docx, xlsx, pptx, odt et ods. Le contenu doit correspondre à l’extension.
• Pour afficher une image jointe dans le message, référencez-la comme une image Markdown : ![Description](plan.png). Les images provenant d’adresses Web ne sont pas chargées.

Avant l’envoi

Effectuez une requête GET sur l’URL de l’endpoint pour savoir à qui il envoie des e-mails, combien d’envois il vous reste aujourd’hui et quels formats il accepte : Markdown par défaut, ou JSON avec Accept: application/json. Une requête GET n’envoie rien.

Après l’envoi

Effectuez une requête GET sur …/to/{address}/sends/{id} avec l’identifiant snd_ de la réponse pour connaître le résultat : mis en file d’attente, envoyé, rejeté, en attente d’approbation, etc., pour chaque destinataire identifié par son libellé. Les adresses ne sont jamais affichées.

MCP et Claude

Chaque endpoint est également un serveur MCP (Streamable HTTP). Remplacez /to/ par /mcp/ :

https://sendlet.email/mcp/sam-k7F2x9Qa4mB8nR1vT6yZ3c

• Claude : Paramètres, Connecteurs, ajoutez un connecteur personnalisé et collez l’URL MCP. Chaque page d’endpoint comporte un bouton Copy MCP URL.
• Claude Code : claude mcp add --transport http sendlet https://sendlet.email/mcp/…
• Outils : send_email (objet, corps, pièces jointes facultatives et clé d’idempotence), endpoint_info (destinataires et nombre d’envois restants aujourd’hui) et get_send_status.

Garder le contrôle

• Limites quotidiennes pour chaque endpoint et pour votre compte. Un envoi à un groupe nécessite une place disponible pour chaque copie destinée à ses membres.
• Approbation : un endpoint peut retenir chaque e-mail jusqu’à ce que vous l’approuviez. Vous recevez immédiatement un e-mail ; tout envoi sans décision après 3 jours est rejeté.
• Groupes : un endpoint peut envoyer des e-mails à plusieurs destinataires, chacun recevant sa propre copie. Seuls les membres ayant accepté la reçoivent.
• Alertes : vous recevez un e-mail en cas d’échec d’un envoi, de rejet ou de réclamation d’un destinataire, ou lorsque l’endpoint atteint sa limite quotidienne.
• Les destinataires gardent le contrôle : chaque e-mail comporte un lien de désabonnement en un clic, et un rejet définitif ou une réclamation entraîne automatiquement le désabonnement.

Pour les agents et les outils

• llms.txt : ces instructions dans un format destiné aux modèles de langage.
• openapi.json : la description OpenAPI de l’API d’envoi.