Email Countdowns
O Email Countdowns (https://emailcountdowns.com) hospeda um GIF de contagem regressiva para cada prazo de campanha. A imagem é desenhada quando o e-mail é aberto, mostrando o tempo restante naquele momento. Você cria o timer, pega o embed_html retornado e o insere no e-mail.
URL base: https://emailcountdowns.com
1. Escolha como acessar o serviço
Verifique o que você pode chamar, nesta ordem:
- Ferramentas MCP estão conectadas. Sua lista de ferramentas contém
create-countdowneget-countdown-stats(o servidor geralmente aparece como "Email Countdowns" ou "Countdown Automation"). Use-as. Pule para a etapa 3. - Uma chave de API está disponível. O usuário forneceu uma chave de workspace, ou
COUNTDOWN_API_KEYestá definida no ambiente. Use a API REST em references/rest-api.md. - Nenhum dos dois. O usuário precisa de um workspace e uma conexão. Vá para a etapa 2.
Não peça ao usuário para colar uma senha no chat. Nunca digite uma senha para ele.
2. Configure um workspace (apenas se necessário)
Pergunte uma vez: "Você já tem uma conta no Email Countdowns?"
Sem conta. Envie o usuário para https://emailcountdowns.com/register. Cada nova conta recebe 1.000 visualizações gratuitas de contagem regressiva, uma vez, sem cartão de crédito e sem assinatura, para que você possa criar e testar timers sem gastar nada. Eles inserem um nome, um nome opcional de workspace, um endereço de e-mail e uma senha. Se você controlar um navegador, pode abrir essa página e preencher o nome, workspace e e-mail fornecidos pelo usuário; o próprio usuário digita a senha e pressiona Registrar.
Conecte-o. Escolha a rota que se adequa ao cliente em que você está executando:
| Cliente | Como conectar |
|---|---|
| Claude (web, desktop) | Configurações → Conectores → Adicionar conector personalizado. Nome Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. Selecione Conectar, faça login, aprove. Ative-o no chat. |
| Claude Code | claude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, depois execute /mcp e autentique-se. Instalar este repositório como plugin adiciona o servidor automaticamente. |
| ChatGPT | Configurações → Apps → Configurações avançadas → ativar modo desenvolvedor. Crie um app, nome Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, autenticação OAuth. Conecte-se e selecione o app no menu de ferramentas em uma nova conversa. As configurações do plano e do workspace determinam se isso está disponível. |
| Codex CLI | codex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, depois codex mcp login email-countdowns. |
| Gemini CLI | gemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, depois /mcp auth countdowns. |
| Scripts, Ações personalizadas do GPT, qualquer coisa sem MCP | O proprietário do workspace cria uma chave em Chave de API da equipe em https://emailcountdowns.com/workspace. Armazene-a como COUNTDOWN_API_KEY. Veja references/rest-api.md. |
O login OAuth ocorre no navegador do usuário. Se ele ainda não estiver registrado, pode se registrar primeiro e depois executar a conexão novamente. A tela de consentimento concede acesso ao workspace que está ativo no momento da aprovação.
Após conectar, chame get-countdown-stats com {"days": 7} para confirmar que a conexão funciona. Informe ao usuário qual nome de workspace foi retornado.
3. Defina o prazo final
Você precisa de quatro informações antes de criar qualquer coisa:
| Campo | Formato | Observações |
|---|---|---|
name | texto, máximo 255 | Rótulo interno, também usado como texto alternativo da imagem. Torne-o legível: "Promoção de Black Friday termina". |
date | YYYY-MM-DD | Deve produzir um prazo futuro. |
time | HH:MM, formato 24h | O momento em que o timer chega a zero. |
timezone | Nome IANA | Europe/London, America/New_York, Australia/Sydney. |
Envie também campaign_key: um slug curto e estável para este prazo, como black-friday-2026. Tentar novamente com a mesma chave e as mesmas configurações retorna o timer existente em vez de um duplicado. Um prazo diferente precisa de uma chave diferente.
Resolva ambiguidades antes de chamar a ferramenta:
- "Termina sexta à meia-noite" pode significar 00:00 do início de sexta-feira ou 23:59 do final. Pergunte ou declare sua interpretação: "Vou definir 23:59 de sexta-feira, 27 de novembro, Europe/London."
- Converta abreviações para fusos IANA: EST/EDT →
America/New_York, PST/PDT →America/Los_Angeles, GMT/BST →Europe/London, CET →Europe/Paris, AEST →Australia/Sydney. Se o público abranger várias regiões, use o fuso em que a oferta é definida. - Sem ano informado: use a próxima ocorrência dessa data.
- Leia a data do texto do e-mail se o usuário estiver redigindo um rascunho. O timer e o texto devem coincidir.
Confirme o prazo de volta ao usuário em uma linha antes de criar o timer, a menos que ele já tenha informado todos os quatro fatos de forma inequívoca.
Campos de aparência opcionais:
text_colour: hexadecimal,#RRGGBB. Padrão#000000.background_colour: hexadecimal outransparent. Padrão#ffffff. Combine com o fundo do e-mail onde o timer está.style_id,font_id: números inteiros. Envie apenas IDs que o usuário forneceu ou que você leu do editor do painel dele. Não adivinhe; um ID desconhecido falha na validação. Omita ambos para o estilo padrão.description: texto livre, máximo 1.000.
4. Crie a contagem regressiva
MCP:
{
"name": "create-countdown",
"arguments": {
"name": "Promoção de inverno termina",
"campaign_key": "winter-sale-2026",
"date": "2026-12-18",
"time": "17:00",
"timezone": "Europe/London",
"background_colour": "#ffffff",
"text_colour": "#1a1a1a"
}
}
O resultado contém id, name, expires_at, gif_url e embed_html. A API REST retorna os mesmos campos em data (veja references/rest-api.md).
Erros que você pode corrigir:
Choose a future deadline.A data e hora já passaram naquele fuso horário. Verifique o ano e o fuso.This campaign key already has different settings.A chave foi usada para outro prazo. Use uma nova chave ou reutilize as configurações originais.- Formato inválido de
timezone,dateoutime. Corrija o formato e tente novamente com a mesma chave.
5. Insira no e-mail
embed_html tem a seguinte aparência:
<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="Promoção de inverno termina" width="300" style="max-width:100%;border:0;display:block;" />
Regras:
- Use a URL hospedada exatamente como retornada. Não baixe o GIF, faça upload para a biblioteca de imagens da plataforma de e-mail ou anexe-o. Um GIF copiado fica congelado no momento em que foi copiado.
- Não adicione strings de consulta, parâmetros de redimensionamento ou proxies ao
src. - Você pode alterar
width(até a largura da coluna de conteúdo, geralmente 600) e encapsular a tag em um link para a oferta. Mantenhamax-width:100%para que ele encolha em celulares. - Para centralizá-lo, encapsule:
<table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>. - Coloque o prazo em texto simples próximo ao timer, para leitores cujo cliente bloqueia imagens: "Promoção termina em 18 de dezembro às 17h (horário do Reino Unido)."
- Posicione-o perto da chamada para ação que ele suporta, geralmente logo acima ou abaixo do botão principal.
Etapas específicas de plataforma (Klaviyo, Mailchimp, Resend, HubSpot e outras) estão em references/email-platforms.md. Se você puder editar o rascunho por meio de outra ferramenta conectada, insira o HTML lá, depois leia o rascunho de volta e verifique se o src não foi alterado. Se não puder editar o rascunho, forneça ao usuário o HTML e a URL da imagem com uma frase sobre onde colar cada um.
Não envie nem agende a campanha. Isso fica com o usuário.
Antes de um envio grande, verifique se o workspace tem visualizações disponíveis. Depois que as 1.000 visualizações gratuitas forem usadas, os timers mostrarão uma imagem em branco até que o proprietário do workspace ative o uso pago em Uso e faturamento em https://emailcountdowns.com/dashboard/account. Se a lista for maior do que as visualizações gratuitas restantes, informe ao usuário para ativar o faturamento primeiro.
6. Relate de volta
Forneça ao usuário:
- o prazo conforme criado, com fuso horário
- a URL da imagem
- o HTML de incorporação em um bloco de código
- onde você o inseriu, ou onde ele deve colá-lo
- a linha de texto simples de fallback que você adicionou ou recomenda
Estatísticas
get-countdown-stats recebe days (1–90, padrão 30) e retorna, para o workspace ativo: total e contagens regressivas ativas, visualizações de todos os tempos, visualizações no período e uma série diária. Uma visualização é uma solicitação da imagem. Clientes de e-mail e proxies de privacidade (Apple Mail Privacy Protection, proxy de imagem do Gmail) podem pré-buscar ou armazenar em cache imagens, portanto, as visualizações não são aberturas humanas únicas. Diga isso ao relatá-las.
Alterar ou excluir um timer
As ferramentas MCP apenas criam timers e leem estatísticas. Para alterar o prazo ou as cores, ou excluir um timer, use a API REST com uma chave de workspace ou o painel em https://emailcountdowns.com/dashboard.
Excluir um timer quebra a imagem em todos os e-mails já enviados com ele. Confirme com o usuário antes de excluir e prefira deixar timeres finalizados no lugar; após o prazo, a imagem mostra zero.
Mais
- Guia do agente e da API: https://emailcountdowns.com/docs/api (Markdown: https://emailcountdowns.com/ai.md)
- Preços: https://emailcountdowns.com/pricing
