Countdowns por Correo Electrónico (Email Countdowns)
Email Countdowns (https://emailcountdowns.com) aloja un GIF de cuenta atrás para cada plazo de campaña. La imagen se genera en el momento en que se abre el correo, mostrando el tiempo restante en ese instante. Tú creas el temporizador, tomas el embed_html devuelto y lo colocas en el correo.
URL base: https://emailcountdowns.com
1. Elegir cómo acceder al servicio
Verifica qué puedes usar, en este orden:
- Las herramientas MCP están conectadas. Tu lista de herramientas contiene
create-countdownyget-countdown-stats(el servidor suele aparecer como "Email Countdowns" o "Countdown Automation"). Úsalas. Salta al paso 3. - Hay una clave API disponible. El usuario te ha proporcionado una clave de workspace, o
COUNTDOWN_API_KEYestá definida en el entorno. Usa la API REST que se describe en references/rest-api.md. - Ninguna de las anteriores. El usuario necesita un workspace y una conexión. Ve al paso 2.
No le pidas al usuario que pegue una contraseña en el chat. Nunca escribas una contraseña por él.
2. Configurar un workspace (solo si es necesario)
Pregunta una vez: "¿Ya tienes una cuenta de Email Countdowns?"
Sin cuenta. Envía al usuario a https://emailcountdowns.com/register. Cada cuenta nueva recibe 1.000 visualizaciones de countdown gratuitas, una vez, sin necesidad de tarjeta ni suscripción, para que puedas crear y probar temporizadores sin gastar nada. El usuario introduce un nombre, un nombre de workspace opcional, una dirección de correo electrónico y una contraseña. Si controlas un navegador, puedes abrir esa página y rellenar el nombre, el workspace y el correo que el usuario te haya dado; el usuario escribe la contraseña y pulsa Registrar por sí mismo.
Conectar. Elige la ruta que se adapte al cliente en el que estés trabajando:
| Cliente | Cómo conectar |
|---|---|
| Claude (web, escritorio) | Ajustes → Conectores → Añadir conector personalizado. Nombre Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. Selecciona Conectar, inicia sesión, autoriza. Actívalo en el chat. |
| Claude Code | claude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, luego ejecuta /mcp y autentica. Instalar este repositorio como plugin añade el servidor automáticamente. |
| ChatGPT | Ajustes → Apps → Ajustes avanzados → activar modo desarrollador. Crear app, nombre Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, autenticación OAuth. Conectar, luego seleccionar la app desde el menú de herramientas en un nuevo chat. La configuración del plan y del workspace determina si está disponible. |
| Codex CLI | codex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, luego codex mcp login email-countdowns. |
| Gemini CLI | gemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, luego /mcp auth countdowns. |
| Scripts, Acciones personalizadas de GPT, cualquier cosa sin MCP | El propietario del workspace crea una clave en Clave API del equipo en https://emailcountdowns.com/workspace. Guárdala como COUNTDOWN_API_KEY. Consulta references/rest-api.md. |
El inicio de sesión OAuth ocurre en el navegador del usuario. Si aún no está registrado, puede registrarse primero y luego volver a ejecutar la conexión. La pantalla de consentimiento concede acceso al workspace que esté activo cuando el usuario lo apruebe.
Después de conectar, llama a get-countdown-stats con {"days": 7} para confirmar que la conexión funciona. Indica al usuario qué nombre de workspace ha devuelto.
3. Definir el plazo
Necesitas cuatro datos antes de crear nada:
| Campo | Formato | Notas |
|---|---|---|
name | texto, máximo 255 | Etiqueta interna, también se usa como texto alternativo de la imagen. Hazlo legible: "Oferta de Black Friday termina". |
date | AAAA-MM-DD | Debe ser una fecha futura de plazo. |
time | HH:MM, formato 24h | El momento en que el temporizador llega a cero. |
timezone | Nombre IANA | Europe/London, America/New_York, Australia/Sydney. |
También envía campaign_key: un slug corto y estable para este plazo, como black-friday-2026. Reintentar con la misma clave y la misma configuración devuelve el temporizador existente en lugar de un duplicado. Un plazo diferente necesita una clave diferente.
Resuelve ambigüedades antes de llamar a la herramienta:
- "Termina el viernes a medianoche" puede significar 00:00 al inicio del viernes o 23:59 al final. Pregunta, o indica tu interpretación: "Configuraré 23:59 del viernes 27 de noviembre, Europe/London."
- Convierte abreviaturas a zonas IANA: EST/EDT →
America/New_York, PST/PDT →America/Los_Angeles, GMT/BST →Europe/London, CET →Europe/Paris, AEST →Australia/Sydney. Si la audiencia abarca varias regiones, usa la zona en la que está definida la oferta. - Sin año: usa la próxima ocurrencia de esa fecha.
- Lee la fecha del texto del correo si el usuario está redactando uno. El temporizador y el texto deben coincidir.
Confirma el plazo al usuario en una sola línea antes de crear el temporizador, a menos que ya haya indicado los cuatro datos de forma inequívoca.
Campos de apariencia opcionales:
text_colour: hexadecimal,#RRGGBB. Por defecto#000000.background_colour: hexadecimal otransparent. Por defecto#ffffff. Debe coincidir con el fondo del correo donde se coloca el temporizador.style_id,font_id: enteros. Solo envía IDs que el usuario te haya dado o que hayas leído de su editor de panel. No los adivines; un ID desconocido falla la validación. Omite ambos para el estilo predeterminado.description: texto libre, máximo 1.000.
4. Crear el countdown
MCP:
{
"name": "create-countdown",
"arguments": {
"name": "Oferta de invierno termina",
"campaign_key": "winter-sale-2026",
"date": "2026-12-18",
"time": "17:00",
"timezone": "Europe/London",
"background_colour": "#ffffff",
"text_colour": "#1a1a1a"
}
}
El resultado contiene id, name, expires_at, gif_url y embed_html. La API REST devuelve los mismos campos bajo data (consulta references/rest-api.md).
Errores que puedes solucionar:
Elige una fecha futura.La fecha y hora ya han pasado en esa zona horaria. Verifica el año y la zona.Esta clave de campaña ya tiene una configuración diferente.La clave se usó para otro plazo. Usa una clave nueva o reutiliza la configuración original.- Formato inválido de
timezone,dateotime. Corrige el formato y vuelve a intentar con la misma clave.
5. Colocarlo en el correo
embed_html tiene este aspecto:
<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="Oferta de invierno termina" width="300" style="max-width:100%;border:0;display:block;" />
Reglas:
- Usa la URL alojada exactamente como se devuelve. No descargues el GIF, no lo subas a la biblioteca de imágenes de la plataforma de correo ni lo adjuntes. Un GIF copiado se congela en el momento en que se copia.
- No añadas cadenas de consulta, parámetros de redimensionamiento ni proxies al
src. - Puedes cambiar
width(hasta el ancho de la columna de contenido, normalmente 600) y envolver la etiqueta en un enlace a la oferta. Manténmax-width:100%para que se reduzca en teléfonos. - Para centrarlo, envuélvelo:
<table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>. - Coloca el plazo en texto plano cerca del temporizador, para los lectores cuyo cliente de correo bloquee las imágenes: "La oferta termina el 18 de diciembre a las 5 p.m. (hora del Reino Unido)".
- Colócalo cerca de la llamada a la acción a la que acompaña, generalmente justo encima o debajo del botón principal.
Los pasos específicos de cada plataforma (Klaviyo, Mailchimp, Resend, HubSpot y otras) están en references/email-platforms.md. Si puedes editar el borrador a través de otra herramienta conectada, inserta el HTML allí, luego lee el borrador de vuelta y verifica que el src no haya cambiado. Si no puedes editar el borrador, entrégale al usuario el HTML y la URL de la imagen con una frase sobre dónde pegar cada uno.
No envíes ni programes la campaña. Eso queda en manos del usuario.
Antes de un envío masivo, verifica que el workspace tenga vistas disponibles. Una vez utilizadas las 1.000 vistas gratuitas, los temporizadores muestran una imagen en blanco hasta que el propietario del workspace active el uso de pago en Uso y facturación en https://emailcountdowns.com/dashboard/account. Si la lista es mayor que las vistas gratuitas restantes, dile al usuario que primero active la facturación.
6. Informar al usuario
Proporciónale al usuario:
- el plazo tal como se creó, con la zona horaria
- la URL de la imagen
- el HTML de inserción en un bloque de código
- dónde lo has colocado, o dónde debe pegarlo
- la línea de texto alternativo que has añadido o que recomiendas
Estadísticas
get-countdown-stats recibe days (1–90, por defecto 30) y devuelve, para el workspace activo: total de countdowns y countdowns activos, vistas totales, vistas en el período y una serie diaria. Una vista es una solicitud de la imagen. Los clientes de correo y los proxies de privacidad (Protección de Privacidad de Apple Mail, proxy de imágenes de Gmail) pueden precargar o cachear imágenes, por lo que las vistas no corresponden a aperturas únicas de personas. Indícalo al reportarlas.
Cambiar o eliminar un temporizador
Las herramientas MCP solo crean temporizadores y leen estadísticas. Para cambiar el plazo o los colores, o para eliminar un temporizador, usa la API REST con una clave de workspace, o el panel en https://emailcountdowns.com/dashboard.
Eliminar un temporizador rompe la imagen en todos los correos ya enviados con él. Confírmalo con el usuario antes de eliminar, y prefiere dejar los temporizadores finalizados en su lugar; después del plazo, la imagen muestra cero.
Más información
- Guía para agentes y API: https://emailcountdowns.com/docs/api (Markdown: https://emailcountdowns.com/ai.md)
- Precios: https://emailcountdowns.com/pricing
