Automação do Mailchimp via Rube MCP

Automatize fluxos de trabalho de marketing por e-mail do Mailchimp, incluindo criação e envio de campanhas, gerenciamento de público/listas, operações de assinantes, segmentação e análise de desempenho através do kit de ferramentas Mailchimp da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do Mailchimp via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas mailchimp
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas mailchimp
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Mailchimp
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Enviar Campanhas de E-mail

Quando usar: O usuário deseja criar, configurar, testar e enviar uma campanha de e-mail.

Sequência de ferramentas:

1. MAILCHIMP_GET_LISTS_INFO - Listar públicos disponíveis e obter list_id [Pré-requisito]
2. MAILCHIMP_ADD_CAMPAIGN - Criar uma nova campanha com tipo, público, assunto, nome do remetente [Obrigatório]
3. MAILCHIMP_SET_CAMPAIGN_CONTENT - Definir conteúdo HTML para a campanha [Obrigatório]
4. MAILCHIMP_SEND_TEST_EMAIL - Enviar prévia para revisores antes do envio real [Opcional]
5. MAILCHIMP_SEND_CAMPAIGN - Enviar a campanha imediatamente [Obrigatório]
6. MAILCHIMP_SCHEDULE_CAMPAIGN - Agendar para entrega futura em vez de envio imediato [Opcional]

Parâmetros chave para MAILCHIMP_ADD_CAMPAIGN:

• type: "regular", "plaintext", "rss" ou "variate" (obrigatório)
• recipients__list__id: ID do público/lista para destinatários
• settings__subject__line: Linha de assunto do e-mail
• settings__from__name: Nome de exibição do remetente
• settings__reply__to: Endereço de e-mail de resposta (obrigatório para envio)
• settings__title: Título interno da campanha
• settings__preview__text: Texto de prévia mostrado na caixa de entrada

Parâmetros chave para MAILCHIMP_SET_CAMPAIGN_CONTENT:

• campaign_id: ID da campanha da etapa de criação (obrigatório)
• html: Conteúdo HTML bruto para o e-mail
• plain_text: Versão em texto simples (gerada automaticamente se omitida)
• template__id: Usar um modelo pré-construído em vez de HTML bruto

Armadilhas:

• MAILCHIMP_SEND_CAMPAIGN é irreversível; sempre envie um e-mail de teste primeiro e obtenha aprovação explícita do usuário
• A campanha deve estar no status "salvo" (rascunho) com público, assunto, nome do remetente, e-mail verificado e conteúdo válidos antes do envio
• MAILCHIMP_SCHEDULE_CAMPAIGN requer uma data/hora futura válida; timestamps passados falham
• Modelos e conteúdo HTML devem incluir tags de rodapé/cancelamento de inscrição compatíveis
• O Mailchimp usa notação de duplo sublinhado para parâmetros aninhados (por exemplo, settings__subject__line)

2. Gerenciar Públicos e Assinantes

Quando usar: O usuário deseja visualizar públicos, listar assinantes ou verificar detalhes de assinantes.

Sequência de ferramentas:

1. MAILCHIMP_GET_LISTS_INFO - Listar todos os públicos com contagem de membros [Obrigatório]
2. MAILCHIMP_GET_LIST_INFO - Obter detalhes para um público específico [Opcional]
3. MAILCHIMP_LIST_MEMBERS_INFO - Listar membros com filtro de status e paginação [Obrigatório]
4. MAILCHIMP_SEARCH_MEMBERS - Pesquisar por e-mail ou nome em todas as listas [Opcional]
5. MAILCHIMP_GET_MEMBER_INFO - Obter perfil detalhado para um assinante específico [Opcional]
6. MAILCHIMP_LIST_SEGMENTS - Listar segmentos dentro de um público [Opcional]

Parâmetros chave para MAILCHIMP_LIST_MEMBERS_INFO:

• list_id: ID do público (obrigatório)
• status: "subscribed", "unsubscribed", "cleaned", "pending", "transactional", "archived"
• count: Registros por página (padrão 10, máximo 1000)
• offset: Deslocamento de paginação (padrão 0)
• sort_field: "timestamp_opt", "timestamp_signup" ou "last_changed"
• fields: Lista separada por vírgulas para limitar o tamanho da resposta

Armadilhas:

• stats.avg_open_rate e stats.avg_click_rate são frações de 0-1, NÃO porcentagens de 0-100
• Sempre use status="subscribed" para filtrar assinantes ativos; omitir retorna todos os status
• Deve-se paginar usando count e offset até que os membros coletados correspondam a total_items
• Respostas de listas grandes podem ser truncadas; os dados estão sob response.data.members

3. Adicionar e Atualizar Assinantes

Quando usar: O usuário deseja adicionar novos assinantes, atualizar os existentes ou gerenciar em massa a associação à lista.

Sequência de ferramentas:

…