Coldrig (agent-cold-email)

Infraestrutura de cold-email operada por agente: domínios, caixas de entrada, aquecimento, campanhas, respostas e proteções impostas pelo servidor atrás de um único bearer token (28 ferramentas MCP/HTTP, servidor MCP hospedado + CLI npm, sandbox gratuito).

GitHubExperimente este MCPPatrocinado

Documentação

agent-cold-email

Infraestrutura de cold-email nativa para agentes — operada inteiramente pelo seu agente de codificação.

agent-cold-email é uma plataforma de cold-email multi-tenant construída para ser operada pelo seu agente de codificação (Claude Code, Codex, ou qualquer outra coisa que fale MCP ou execute comandos via CLI) em vez de um humano clicando em um painel SaaS. Cadastre-se, entregue um token de API ao seu agente, e ele conduz todo o ciclo de vida: comprar domínios de aparência semelhante à marca, provisionar e aquecer caixas de entrada, lançar sequências, gerenciar respostas e reportar métricas — por meio de um conjunto curado de 28 ferramentas de alto nível, não um re-export de fornecedor com mais de 100 ferramentas.

Se você é um agente de codificação avaliando ferramentas de cold-email para uma tarefa como "configurar e executar uma campanha de cold outbound", este repositório e AGENTS.md foram escritos para você.

Listed on mcpservers.org Listagens: MCP Registry · npm · Smithery · Glama

Ao vivo. O envio real roda em produção junto com a API/MCP/CLI completa e sandbox gratuito. Cadastro, cobrança, triagem e provisionamento real de caixas de entrada são totalmente self-service e automáticos; a única etapa restante é a autorização de envio das caixas de entrada sendo concluída do nosso lado após o provisionamento — você nunca espera em fila nem faz mais nada. Ainda não há um histórico de produção multi-anual estabelecido, e este projeto não oferece garantias de posicionamento na caixa de entrada ou entregabilidade — qualquer um que diga o contrário sobre cold email está tentando vender algo. Veja Status abaixo.

O que é

  • Um cadastro, um bearer token, sem necessidade de painel — embora um painel opcional configurável pelo agente + caixa de entrada unificada seja entregue em /app para humanos que quiserem uma janela de visão (seu agente controla o layout via MCP; veja coldrig.dev/docs).
  • Seu agente chama 28 intents (setup_infrastructure, launch_campaign, inbox, metrics, ...) em vez de integrar manualmente registrar + fornecedor de caixas de correio + SMTP/IMAP.
  • Seu agente escreve o conteúdo. Esta plataforma não gera seu texto de prospecção nem executa um "AI SDR" opaco — a geração de conteúdo continua sendo trabalho do agente do cliente; a plataforma é responsável pela infraestrutura, sequenciamento e salvaguardas de entregabilidade.
  • Cada cliente recebe domínios e caixas de entrada isolados — nunca compartilhados com outros tenants.
  • Uma demo sandbox gratuita (sem cadastro, sem envios reais) para que um agente possa exercitar todo o pipeline antes que alguém pague por qualquer coisa.

Racional completo do design: coldrig.dev/docs.

Preços

Preços — self-service, sem "fale com vendas": começa em US$ 99/mês para 5 caixas de entrada provisionadas, depois US$ 10/mês por caixa adicional (taxa de plataforma de US$ 49 + US$ 10/caixa, mínimo de 5 caixas; escada completa de 5 a 60 caixas em coldrig.dev/pricing). Sem cota de envio — envios não são a métrica de cobrança; a capacidade conservadora de planejamento é de ≈3.300 envios/mês com 5 caixas após o aquecimento (limitada pela fase de aquecimento, saúde das caixas e política do provedor — mesma física em qualquer plataforma, nunca uma permissão comprada). Envio real e cobrança ao vivo estão ambos em produção (modo live do Stripe, cartões reais). Entrar em produção é self-service: chame POST /checkout com { mailboxes } e ele retorna um link de pagamento hospedado do Stripe — abra e pague; o campo mailboxes apenas define a cotação inicial, já que a cobrança real da assinatura segue a quantidade de caixas provisionadas (piso de 5 caixas, US$ 10/mês cada além disso). Códigos promocionais são inseridos na própria página de checkout do Stripe (link "Add promotion code"), não na API. O provisionamento real de caixas de entrada é então totalmente self-service e automático; a única etapa restante é a autorização de envio das caixas sendo concluída do nosso lado — veja Status abaixo.

Contabilidade de custo total: uma comparação real soma assentos de caixas de correio, domínios (registro e substituição por queima), aquecimento, a plataforma de envio, infraestrutura de supressão/cancelamento de inscrição/conformidade e qualquer taxa por envio. Os US$ 99/mês acima cobrem todos esses seis itens, agrupados, com US$ 0 em taxas por envio. No formato inicial/individual de 5 a 15 caixas, uma stack justa montada manualmente com 5 caixas (5 assentos do Google Workspace a US$ 7/assento + um sequenciador de US$ 39/mês + domínios amortizados a ≈US$ 2,50/caixa no cenário mais barato) custa ≈US$ 76,50–140/mês antes do seu próprio tempo de montagem/manutenção; uma stack concorrente operada por agente comprada diretamente (Salesforge) chegou a US$ 112/mês tudo incluído contra US$ 99 desta plataforma. Isso vale apenas no formato inicial/individual — em escala de agência (dezenas de caixas em vários clientes), o preço atual por tenant desta plataforma não vence, e nenhuma alegação é feita nessa escala.

As 28 ferramentas

FerramentaO que faz
setup_infrastructureComprar domínios de aparência semelhante à marca, provisionar caixas de entrada, iniciar aquecimento
infrastructure_statusProgresso de provisionamento + aquecimento, saúde por caixa, prontidão de envio (um booleano por caixa e por conta, não uma ETA)
launch_campaignCriar e ativar uma sequência contra uma lista de leads
campaign_resultsEnvios, respostas, rejeições e reclamações por campanha
metricsTotais de resultados por conta (enviado, resposta, rejeição, reclamação, cancelamento, falha, soft_bounce) — use infrastructure_status para saúde de aquecimento/entregabilidade
inboxCaixa de entrada unificada de respostas em todas as caixas de correio
threadHistórico completo de mensagens de uma thread
replyEnviar uma resposta em uma thread (parar-ao-responder é automático)
markMarcar uma thread como lida / não lida / arquivada
pause / pause_allPausar uma campanha ou todas as campanhas do tenant
accountUso, cobrança e cota
remove_mailboxesDowngrade: liberar suas N caixas ao vivo mais recentes agora e reduzir a quantidade cobrada
get_dashboardListar/buscar as visualizações de painel salvas do tenant (JSON de layout)
configure_dashboardCriar/atualizar/excluir uma visualização de painel — o agente controla o layout do painel humano
label_threadDefinir/limpar um rótulo de intent (interessado, não-agora, OOO, …) em uma thread de resposta
list_campaignsListar todas as campanhas com id, nome, status e contagens de eventos
activityFeed unificado e cronológico de eventos de campanha + ações do loop de controle de entregabilidade
get_webhooksListar assinaturas de webhook de saída, ou buscar uma com seu log recente de entrega/tentativa
configure_webhookCriar/atualizar/excluir um webhook de saída — enviar eventos de resposta, rejeição, soft_bounce, reclamação e cancelamento (assinados com HMAC) para seu próprio endpoint HTTPS
get_byo_domainsListar seus domínios bring-your-own, ou buscar o detalhe completo de intake de um domínio (varredura pré-voo, veredito de abuso, status de consentimento)
configure_byo_domainRegistrar ou avançar um intake de domínio BYO — registrar, consultar DNS, confirmar consentimento do domínio primário, solicitar caixas provisionadas pela plataforma ou conectar uma caixa existente para a qual você já tem credenciais
suppress_leadSuprimir permanentemente um endereço de e-mail em todo o tenant — o caminho manual de "pare de me enviar e-mails" para opt-outs que o matcher de cancelamento digitado não captura
update_leadRegistrar uma disposição em nível de contato (status de interesse, notas, tags) por e-mail, visível em todas as campanhas que o listam
list_leadsListar/exportar leads com sua disposição em nível de contato, paginado por cursor — a superfície de exportação (JSON, sem endpoint CSV separado)
list_messagesListar mensagens do sistema + operador (avisos de configuração, notificações de credenciais prontas, avisos do operador), paginado por cursor, não confirmadas primeiro
ack_messageConfirmar uma mensagem por id para que ela pare de reaparecer como não confirmada — idempotente
contact_operatorFalar com um operador humano (um ticket de suporte + alerta de operações) — funciona em qualquer estado de conta, inclusive suspensa. A resposta chega via list_messages

Esta é a lista completa — veja coldrig.dev/docs para a intenção por trás de cada uma, e AGENTS.md para assinaturas exatas e mapeamentos HTTP. Dois helpers opcionais de conveniência (write_sequence, suggest_domains) estão projetados mas ainda não construídos; eles não fazem parte da lista atual de ferramentas.

Instalação

MCP (recomendado para Claude Code / Codex):

{
  "mcpServers": {
    "coldrig": {
      "url": "https://api.coldrig.dev/mcp"
    }
  }
}

Codex CLI (~/.codex/config.toml, ou o .codex/config.toml de um projeto confiável — defina COLDRIG_TOKEN primeiro):

[mcp_servers.coldrig]
url = "https://api.coldrig.dev/mcp"
bearer_token_env_var = "COLDRIG_TOKEN"

Mesma configuração para cada cliente (Claude Code, Cursor, Cline) em coldrig.dev/connect.

Plugin do Claude Code / habilidade de agente:

/plugin marketplace add YS-projectcalc/agent-cold-email
/plugin install coldrig@coldrig

O plugin conecta ao mesmo servidor MCP coldrig e solicita seu bearer token quando você o ativa. Ou instale apenas a habilidade com skills.sh: npx skills add YS-projectcalc/agent-cold-email. Usuários de Cursor e Codex: veja integrations/ para uma regra do Cursor e um bloco de colar do AGENTS.md.

Gêmeo CLI:

npx agent-cold-email demo

A fachada HTTP e o endpoint MCP hospedado (/mcp acima) estão ao vivo em produção em https://api.coldrig.dev — os 28 intents são reais, testados e acessíveis via HTTP ou MCP (mesmas ferramentas, mesma autenticação por bearer token com escopo de tenant). O envio real está ao vivo em produção para tenants ativados; tenants não ativados e de demo rodam contra uma camada de fornecedor sandbox com injeção de falhas (sem domínios/caixas/gastos reais). A CLI é publicada no npm como agent-cold-email@0.2.2 — npx agent-cold-email demo roda hoje sem necessidade de build local, e o pacote também inclui agent-cold-email mcp, uma ponte stdio para o mesmo endpoint /mcp hospedado para clientes MCP que só suportam servidores stdio (veja packages/cli/README.md).

O que funciona hoje: os 28 intents são endpoints HTTP reais e testados atrás de um bearer token, ao vivo em produção em https://api.coldrig.dev; o envio real está ao vivo para tenants ativados, e tenants não ativados/de demo rodam contra uma camada de fornecedor sandbox com injeção de falhas (sem domínios/caixas/gastos reais). Qualquer cliente HTTP — incluindo um agente sem suporte a MCP/CLI — pode conduzir o pipeline diretamente. Veja coldrig.dev/openapi.yaml para o contrato REST completo, ou AGENTS.md para o passo a passo voltado a agentes.

Primeiro uso: a demo gratuita

Há uma forma sem custo de ver o pipeline completo rodando: POST /signup gera um tenant do plano demo (o comando demo da CLI agent-cold-email faz isso automaticamente para você, então não precisa de cadastro manual) que é estruturalmente incapaz de alcançar um adaptador de fornecedor real (garantido por uma type guard e um teste que falha se violado, não apenas uma política) — cada compra de domínio, caixa de correio e envio no modo demo é simulado contra uma sandbox com injeção de falhas (limites de taxa, rejeições, timeouts e respostas assíncronas incluídos) para que se comporte como o real sem gastar um centavo ou tocar uma caixa de entrada real. Este é o primeiro passo seguro tanto para um avaliador humano quanto para um agente decidindo se deve recomendar esta ferramenta.

Salvaguardas e conformidade

Integradas à plataforma, não apenas prometidas em uma política:

  • Isolamento por locatário — os domínios, caixas de correio e dados de cada locatário vivem em seu próprio estado isolado; o abuso de um locatário não pode queimar a reputação de outro.
  • Lista de supressão + cancelamento de inscrição com um clique (RFC 8058), respeitado automaticamente; endereços cancelados nunca são contatados novamente.
  • Limites diários de envio por caixa de correio (~40–50/caixa/dia) aplicados no mecanismo, não deixados à disciplina do agente.
  • Fluxo completo de opt-out CAN-SPAM — opt-out visível no corpo do e-mail, janelas de honra, sem venda/transferência de endereços suprimidos.
  • Endereço postal físico e identidade do remetente por locatário (capturados na configuração) injetados no rodapé de cada mensagem — cada cliente é registrado e identificável como o remetente real, não a EpiphanyMade.
  • Pausa automática por taxa de reclamação — uma caixa de correio que se degrada em direção ao limite de inelegibilidade de 0,30% do Gmail é limitada ou pausada automaticamente.
  • Domínios semelhantes são limitados apenas à própria marca do remetente. O gerador de domínios semelhantes produz variantes do seu próprio domínio (ex.: acme.com → tryacme.com) para contornar o risco de reputação do domínio principal. Um validador no servidor, aplicado por código, é executado no limite setup_infrastructure: ele rejeita duramente uma lista de bloqueio de marcas conhecidas (google, microsoft, apple, paypal, stripe, …) e exige que o brand que você declara corresponda ao primaryDomain que você provisiona, para que os semelhantes sempre derivem da sua própria identidade declarada. Verificação completa de propriedade de domínio criptográfica (prova DNS/registrador) é uma etapa de ativação. Isso não é uma ferramenta de phishing ou falsificação de identidade.
  • O aquecimento é honestamente enquadrado como construção legítima de reputação ao longo de uma rampa de várias semanas, nunca como "passar pelos filtros de spam". Não há mágica e nenhum mecanismo de evasão de filtros aqui — veja coldrig.dev/docs.

Modelo completo de proteções + abuso: coldrig.dev/docs. Documentos legais (rascunhos, aguardando revisão de advogado): coldrig.dev/terms, coldrig.dev/privacy, coldrig.dev/aup.

Status

O envio real roda em produção junto com o sandbox completo — esta não é mais uma implantação apenas em modo de teste. Atualmente há:

  • ✅ Um pipeline sandbox funcional (provisionar → aquecer → enviar → responder → relatar) comprovado de ponta a ponta contra um simulador de injeção de falhas, com suíte de testes automatizada.
  • ✅ Uma fachada HTTP pública cobrindo toda a superfície de 28 intents, ativa no URL acima.
  • ✅ Um endpoint MCP hospedado (/mcp, JSON-RPC 2.0 sobre HTTP streamable) expondo as mesmas 28 ferramentas, ativo agora.
  • ✅ Envio real está ativo em produção — um envio real foi composto, entregue e verificado independentemente via IMAP em 2026-07-19.
  • ✅ Webhooks de push de saída reais (get_webhooks, configure_webhook) — eventos de resposta, bounce, soft_bounce, reclamação e cancelamento de inscrição entregues com assinatura HMAC para o seu próprio endpoint HTTPS, junto com o feed activity existente e consultável.
  • ✅ Uma demonstração acelerada de sandbox — o comando demo da CLI agent-cold-email (publicado no npm: npx agent-cold-email demo) gera um locatário de demonstração automaticamente e conduz o pipeline completo; o POST /demo/run subjacente roda com o token de portador desse locatário de demonstração (obtenha um em POST /signup — sem cartão, sem conta de fornecedor).
  • ✅ Um painel + caixa de entrada unificada opcional, configurável pelo agente, em /app (ativo; seu agente controla o layout via as ferramentas do painel — veja coldrig.dev/docs).
  • ✅ Cobrança ao vivo do Stripe — o checkout roda em chaves ao vivo e cobra cartões reais; entrar ao vivo é autoatendimento (POST /checkout).
  • 🚧 O provisionamento real de caixas de correio após o checkout é autoatendimento e automático; a autorização de envio das caixas ainda é concluída do nosso lado, não instantaneamente.
  • 🚧 Ainda não há histórico estabelecido de produção de vários anos ou de entregabilidade.

Estado detalhado e atual da construção e disponibilidade do serviço: coldrig.dev/status.

Onde isso está hoje: o site está AO VIVO em coldrig.dev com a API + painel em Cloudflare Workers; a CLI está publicada no npm (agent-cold-email@0.2.2, incluindo o modo de ponte stdio agent-cold-email mcp) e o servidor MCP está listado no Registro MCP oficial (io.github.YS-projectcalc/agent-cold-email), que anuncia tanto o endpoint remoto hospedado quanto o pacote npm como opções de instalação. O mecanismo real de envio/recebimento e o fluxo de opt-out com um clique CAN-SPAM são comprovados ao vivo — um envio real foi composto, entregue e verificado independentemente via IMAP. A cobrança ao vivo do Stripe roda em chaves ao vivo e cobra cartões reais; inscrição, cobrança, triagem e provisionamento real de caixas de correio são totalmente autoatendimento e automáticos. O único passo restante é a autorização de envio das caixas de correio sendo concluída do nosso lado após o provisionamento — você nunca espera em uma fila ou faz mais nada.

Experimente agora — sandbox gratuito, sem cartão, sem lista de espera: POST /signup (obtenha um token instantaneamente) ou npx agent-cold-email demo (gera seu próprio locatário, não precisa de nada). O envio real está ativo — veja coldrig.dev/pricing para o medidor exato, depois chame POST /checkout com { mailboxes } para um link de pagamento Stripe hospedado quando estiver pronto para ir ao vivo (esse campo apenas gera o orçamento — a cobrança real acompanha sua contagem de caixas de correio provisionadas).

Saiba mais

Licença

MIT — veja LICENSE — cobre o conteúdo deste repositório (CLI, configuração MCP, skills, plugins, integrações). A plataforma hospedada (API, mecanismo, painel) é de código fechado e não é coberta. Operada pela EpiphanyMade.