Email Countdowns
Email Countdowns (https://emailcountdowns.com) héberge un GIF de compte à rebours pour chaque échéance de campagne. L'image est dessinée lorsque l'e-mail est ouvert, affichant ainsi le temps restant à cet instant. Vous créez le minuteur, récupérez le embed_html retourné, et le placez dans l'e-mail.
URL de base : https://emailcountdowns.com
1. Choisir comment accéder au service
Vérifiez ce que vous pouvez appeler, dans cet ordre :
- Les outils MCP sont connectés. Votre liste d'outils contient
create-countdownetget-countdown-stats(le serveur est souvent affiché comme « Email Countdowns » ou « Countdown Automation »). Utilisez-les. Passez à l'étape 3. - Une clé API est disponible. L'utilisateur vous a donné une clé d'espace de travail, ou
COUNTDOWN_API_KEYest définie dans l'environnement. Utilisez l'API REST dans references/rest-api.md. - Ni l'un ni l'autre. L'utilisateur a besoin d'un espace de travail et d'une connexion. Passez à l'étape 2.
Ne demandez pas à l'utilisateur de coller un mot de passe dans le chat. Ne tapez jamais un mot de passe à leur place.
2. Configurer un espace de travail (uniquement si nécessaire)
Demandez une fois : « Avez-vous déjà un compte Email Countdowns ? »
Pas de compte. Envoyez l'utilisateur sur https://emailcountdowns.com/register. Chaque nouveau compte reçoit 1 000 vues de compte à rebours gratuites, une fois, sans carte bancaire ni abonnement, afin de pouvoir créer et tester des minuteurs sans rien dépenser. Ils saisissent un nom, un nom d'espace de travail facultatif, une adresse e-mail et un mot de passe. Si vous contrôlez un navigateur, vous pouvez ouvrir cette page et remplir le nom, l'espace de travail et l'e-mail que l'utilisateur vous a donnés ; l'utilisateur tape le mot de passe et appuie sur S'inscrire lui-même.
Connectez-le. Choisissez la route qui correspond au client dans lequel vous vous exécutez :
| Client | Comment se connecter |
|---|---|
| Claude (web, desktop) | Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Nommez Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. Sélectionnez Connecter, connectez-vous, approuvez. Activez-le dans le chat. |
| Claude Code | claude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, puis exécutez /mcp et authentifiez-vous. L'installation de ce dépôt en tant que plugin ajoute le serveur pour vous. |
| ChatGPT | Paramètres → Apps → Paramètres avancés → activer le mode développeur. Créez une app, nommez Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, authentification OAuth. Connectez-vous, puis sélectionnez l'app dans le menu outils d'un nouveau chat. Les paramètres du plan et de l'espace de travail déterminent si cela est disponible. |
| Codex CLI | codex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, puis codex mcp login email-countdowns. |
| Gemini CLI | gemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, puis /mcp auth countdowns. |
| Scripts, actions GPT personnalisées, tout ce qui n'a pas de MCP | Le propriétaire de l'espace de travail crée une clé sous Clé API d'équipe sur https://emailcountdowns.com/workspace. Stockez-la comme COUNTDOWN_API_KEY. Voir references/rest-api.md. |
La connexion OAuth se produit dans le navigateur de l'utilisateur. S'ils ne sont pas encore inscrits, ils peuvent s'inscrire d'abord, puis relancer la connexion. L'écran de consentement accorde l'accès à l'espace de travail actif au moment où ils approuvent.
Après la connexion, appelez get-countdown-stats avec {"days": 7} pour confirmer que la connexion fonctionne. Dites à l'utilisateur quel nom d'espace de travail a été retourné.
3. Définir l'échéance
Vous avez besoin de quatre informations avant de créer quoi que ce soit :
| Champ | Format | Notes |
|---|---|---|
name | texte, max 255 | Étiquette interne, également utilisée comme texte alternatif de l'image. Rendez-la lisible : « Fin des soldes du Black Friday ». |
date | AAAA-MM-JJ | Doit produire une échéance future. |
time | HH:MM, 24 heures | Le moment où le minuteur atteint zéro. |
timezone | Nom IANA | Europe/Paris, America/New_York, Australia/Sydney. |
Envoyez également campaign_key : un slug court et stable pour cette échéance, par exemple black-friday-2026. Réessayer avec la même clé et les mêmes paramètres retourne le minuteur existant au lieu d'un doublon. Une échéance différente nécessite une clé différente.
Résolvez les ambiguïtés avant d'appeler l'outil :
- « Se termine vendredi à minuit » peut signifier 00:00 au début du vendredi ou 23:59 à sa fin. Demandez, ou énoncez votre lecture : « Je vais régler à 23:59 le vendredi 27 novembre, Europe/Paris. »
- Convertissez les abréviations en fuseaux IANA : EST/EDT →
America/New_York, PST/PDT →America/Los_Angeles, GMT/BST →Europe/London, CET →Europe/Paris, AEST →Australia/Sydney. Si le public couvre plusieurs régions, utilisez le fuseau dans lequel l'offre est définie. - Pas d'année donnée : utilisez la prochaine occurrence de cette date.
- Lisez la date dans le texte de l'e-mail si l'utilisateur en rédige un. Le minuteur et le texte doivent correspondre.
Confirmez l'échéance à l'utilisateur en une ligne avant de créer le minuteur, à moins qu'il n'ait déjà énoncé les quatre faits sans ambiguïté.
Champs d'apparence facultatifs :
text_colour: hex,#RRGGBB. Par défaut#000000.background_colour: hex outransparent. Par défaut#ffffff. Faites correspondre la couleur de fond de l'e-mail là où se trouve le minuteur.style_id,font_id: entiers. Envoyez uniquement les ID que l'utilisateur vous donne ou que vous lisez depuis l'éditeur de son tableau de bord. Ne les devinez pas ; un ID inconnu échoue à la validation. Omettez les deux pour le style par défaut.description: texte libre, max 1 000.
4. Créer le compte à rebours
MCP :
{
"name": "create-countdown",
"arguments": {
"name": "Fin des soldes d'hiver",
"campaign_key": "winter-sale-2026",
"date": "2026-12-18",
"time": "17:00",
"timezone": "Europe/Paris",
"background_colour": "#ffffff",
"text_colour": "#1a1a1a"
}
}
Le résultat contient id, name, expires_at, gif_url et embed_html. L'API REST retourne les mêmes champs sous data (voir references/rest-api.md).
Erreurs que vous pouvez corriger :
Choose a future deadline.La date et l'heure sont passées dans ce fuseau horaire. Vérifiez l'année et le fuseau.This campaign key already has different settings.La clé a été utilisée pour une autre échéance. Utilisez une nouvelle clé, ou réutilisez les paramètres d'origine.- Format invalide de
timezone,dateoutime. Corrigez le format et réessayez avec la même clé.
5. Placer dans l'e-mail
embed_html ressemble à ceci :
<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="Fin des soldes d'hiver" width="300" style="max-width:100%;border:0;display:block;" />
Règles :
- Utilisez l'URL hébergée exactement comme retournée. Ne téléchargez pas le GIF, ne le téléversez pas dans la bibliothèque d'images de la plateforme e-mail et ne le joignez pas en pièce jointe. Un GIF copié est figé au moment où il a été copié.
- N'ajoutez pas de chaînes de requête, de paramètres de redimensionnement ou de proxys au
src. - Vous pouvez modifier
width(jusqu'à la largeur de la colonne de contenu, généralement 600) et entourer la balise d'un lien vers l'offre. Conservezmax-width:100%pour qu'il rétrécisse sur les téléphones. - Pour le centrer, enveloppez-le :
<table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>. - Placez l'échéance en texte brut près du minuteur, pour les lecteurs dont le client bloque les images : « Soldes se terminent le 18 décembre à 17h heure française. »
- Placez-le près de l'appel à l'action qu'il soutient, généralement juste au-dessus ou en dessous du bouton principal.
Les étapes spécifiques à chaque plateforme (Klaviyo, Mailchimp, Resend, HubSpot et autres) se trouvent dans references/email-platforms.md. Si vous pouvez modifier le brouillon via un autre outil connecté, insérez le HTML là, puis relisez le brouillon et vérifiez que le src est inchangé. Si vous ne pouvez pas modifier le brouillon, donnez à l'utilisateur le HTML et l'URL de l'image avec une phrase sur l'endroit où coller chacun.
N'envoyez ni ne planifiez la campagne. Cela reste à la charge de l'utilisateur.
Avant un envoi important, vérifiez que l'espace de travail a suffisamment de vues disponibles. Une fois les 1 000 vues gratuites utilisées, les minuteurs affichent une image vierge jusqu'à ce que le propriétaire de l'espace de travail active l'utilisation payante sous Utilisation et facturation sur https://emailcountdowns.com/dashboard/account. Si la liste est plus grande que les vues gratuites restantes, dites à l'utilisateur d'activer d'abord la facturation.
6. Faire un rapport
Donnez à l'utilisateur :
- l'échéance telle que créée, avec le fuseau horaire
- l'URL de l'image
- le HTML d'intégration dans un bloc de code
- où vous l'avez placé, ou où il doit le coller
- la ligne de texte de secours en texte brut que vous avez ajoutée ou recommandée
Statistiques
get-countdown-stats prend days (1–90, défaut 30) et retourne, pour l'espace de travail actif : le nombre total et actif de minuteurs, les vues totales, les vues sur la période et une série quotidienne. Une vue est une requête pour l'image. Les clients de messagerie et les proxies de confidentialité (Apple Mail Privacy Protection, proxy d'image de Gmail) peuvent précharger ou mettre en cache les images, donc les vues ne sont pas des ouvertures humaines uniques. Dites-le lorsque vous les rapportez.
Modifier ou supprimer un minuteur
Les outils MCP créent uniquement des minuteurs et lisent des statistiques. Pour modifier l'échéance ou les couleurs, ou supprimer un minuteur, utilisez l'API REST avec une clé d'espace de travail, ou le tableau de bord sur https://emailcountdowns.com/dashboard.
Supprimer un minuteur brise l'image dans chaque e-mail déjà envoyé avec celui-ci. Confirmez avec l'utilisateur avant de supprimer, et préférez laisser les minuteurs terminés en place ; après l'échéance, l'image affiche zéro.
Plus
- Guide agent et API : https://emailcountdowns.com/docs/api (Markdown : https://emailcountdowns.com/ai.md)
- Tarifs : https://emailcountdowns.com/pricing
