ConvertKit (Kit) Automação via Rube MCP

Automatize operações de marketing por e-mail do ConvertKit (agora conhecido como Kit) através do toolkit Kit do Composio via Rube MCP.

Pré-requisitos

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

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — apenas adicione 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 toolkit kit
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do Kit
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Pesquisar Assinantes

Quando usar: O usuário deseja navegar, pesquisar ou filtrar assinantes de e-mail

Sequência de ferramentas:

1. KIT_LIST_SUBSCRIBERS - Listar assinantes com filtros e paginação [Obrigatório]

Parâmetros chave:

• status: Filtrar por status ('active' ou 'inactive')
• email_address: E-mail exato para pesquisar
• created_after/created_before: Filtro de intervalo de datas (AAAA-MM-DD)
• updated_after/updated_before: Filtro de intervalo de datas (AAAA-MM-DD)
• sort_field: Ordenar por 'id', 'cancelled_at' ou 'updated_at'
• sort_order: 'asc' ou 'desc'
• per_page: Resultados por página (mínimo 1)
• after/before: Strings de cursor para paginação
• include_total_count: Definir como 'true' para obter a contagem total de assinantes

Armadilhas:

• Se sort_field for 'cancelled_at', status deve ser definido como 'cancelled'
• Filtros de data usam o formato AAAA-MM-DD (sem componente de hora)
• email_address é uma correspondência exata; pesquisa de e-mail parcial não é suportada
• A paginação usa uma abordagem baseada em cursor com strings de cursor after/before
• include_total_count é uma string 'true', não um booleano

2. Gerenciar Tags de Assinantes

Quando usar: O usuário deseja adicionar tags a assinantes para segmentação

Sequência de ferramentas:

1. KIT_LIST_SUBSCRIBERS - Encontrar ID do assinante por e-mail [Pré-requisito]
2. KIT_TAG_SUBSCRIBER - Associar um assinante a uma tag [Obrigatório]
3. KIT_LIST_TAG_SUBSCRIBERS - Listar assinantes de uma tag específica [Opcional]

Parâmetros chave para adicionar tags:

• tag_id: ID da tag numérica (obrigatório)
• subscriber_id: ID do assinante numérico (obrigatório)

Armadilhas:

• Ambos tag_id e subscriber_id devem ser inteiros positivos
• IDs de tag devem referenciar tags existentes; tags são criadas através da interface web do Kit
• Adicionar tag a um assinante já com tag é idempotente (sem erro)
• IDs de assinantes são retornados de LIST_SUBSCRIBERS; use o filtro email_address para encontrar assinantes específicos

3. Cancelar Inscrição de um Assinante

Quando usar: O usuário deseja cancelar a inscrição de um assinante de todas as comunicações

Sequência de ferramentas:

1. KIT_LIST_SUBSCRIBERS - Encontrar ID do assinante [Pré-requisito]
2. KIT_DELETE_SUBSCRIBER - Cancelar inscrição do assinante [Obrigatório]

Parâmetros chave:

• id: ID do assinante (obrigatório, inteiro positivo)

Armadilhas:

• Isso cancela permanentemente a inscrição do assinante de TODAS as comunicações por e-mail
• Os dados históricos do assinante são retidos, mas ele não receberá mais e-mails
• A operação é idempotente; cancelar a inscrição de um assinante já desinscrito é bem-sucedido sem erro
• Retorna resposta vazia (HTTP 204 No Content) em caso de sucesso
• O ID do assinante deve existir; IDs inexistentes retornam 404

4. Listar e Visualizar Transmissões

Quando usar: O usuário deseja navegar por transmissões de e-mail ou obter detalhes de uma específica

Sequência de ferramentas:

1. KIT_LIST_BROADCASTS - Listar todas as transmissões com paginação [Obrigatório]
2. KIT_GET_BROADCAST - Obter informações detalhadas de uma transmissão específica [Opcional]
3. KIT_GET_BROADCAST_STATS - Obter estatísticas de desempenho de uma transmissão [Opcional]

Parâmetros chave para listagem:

• per_page: Resultados por página (1-500)
• after/before: Strings de cursor para paginação
• include_total_count: Definir como 'true' para contagem total

Parâmetros chave para detalhes:

• id: ID da transmissão (obrigatório, inteiro positivo)

Armadilhas:

• O máximo de per_page é 500 para transmissões
• Estatísticas de transmissão estão disponíveis apenas para transmissões enviadas
• Transmissões em rascunho não terão estatísticas
• IDs de transmissão são inteiros numéricos

5. Excluir uma Transmissão

Quando usar: O usuário deseja remover permanentemente uma transmissão

Sequência de ferramentas:

1. KIT_LIST_BROADCASTS - Encontrar a transmissão a ser excluída [Pré-requisito]

…