Kit.com (formerly ConvertKit) MCP

Por que usar isso?

Se você administra uma newsletter ou email marketing na Kit.com, este servidor MCP permite que você:

• Gerenciar assinantes - Listar, criar, atualizar e organizar seus assinantes de email
• Lidar com tags com eficiência - Criar tags, adicionar/remover tags de assinantes, listar assinantes por tag
• Trabalhar com sequências - Visualizar sequências de email e adicionar assinantes a sequências automatizadas
• Criar transmissões - Rascunhar e gerenciar campanhas de email
• Analisar sua lista - Consultar dados de assinantes com filtros (status, intervalos de datas, campos personalizados)
• Automatizar fluxos de trabalho - Deixe o Claude lidar com tarefas repetitivas de email marketing

Recursos

Referência completa de ferramentas

Conta

• kit_get_account - Obter informações da conta Kit.com

Assinantes (7 ferramentas)

• kit_list_subscribers - Listar assinantes com filtros (status, intervalos de datas, paginação)
• kit_get_subscriber - Obter um assinante específico por ID
• kit_create_subscriber - Criar um novo assinante
• kit_update_subscriber - Atualizar detalhes do assinante
• kit_get_subscriber_tags - Obter todas as tags de um assinante
• kit_add_tag_to_subscriber - Adicionar uma tag a um assinante
• kit_remove_tag_from_subscriber - Remover uma tag de um assinante

Tags (6 ferramentas)

• kit_list_tags - Listar todas as tags
• kit_get_tag - Obter uma tag específica
• kit_create_tag - Criar uma nova tag
• kit_update_tag - Renomear uma tag
• kit_delete_tag - Excluir uma tag
• kit_list_tag_subscribers - Listar todos os assinantes com uma tag específica

Sequências (3 ferramentas)

• kit_list_sequences - Listar todas as sequências de email
• kit_get_sequence - Obter detalhes da sequência
• kit_add_subscriber_to_sequence - Adicionar assinante a uma sequência

Transmissões (5 ferramentas)

• kit_list_broadcasts - Listar todas as transmissões
• kit_get_broadcast - Obter detalhes da transmissão
• kit_create_broadcast - Criar uma nova transmissão
• kit_update_broadcast - Atualizar uma transmissão
• kit_delete_broadcast - Excluir uma transmissão

Formulários (3 ferramentas)

• kit_list_forms - Listar todos os formulários
• kit_get_form - Obter detalhes do formulário
• kit_add_subscriber_to_form - Adicionar assinante via formulário

Campos personalizados (1 ferramenta)

• kit_list_custom_fields - Listar todos os campos personalizados

Webhooks (3 ferramentas)

• kit_list_webhooks - Listar webhooks configurados
• kit_create_webhook - Criar um novo webhook
• kit_delete_webhook - Excluir um webhook

Pré-requisitos

• Node.js 18+
• Uma conta Kit.com
• Sua chave de API da Kit.com (API v4)

Instalação

Opção 1: Instalar a partir do npm (recomendado)

npx kit-mcp-server

Ou instale globalmente:

npm install -g kit-mcp-server

Opção 2: Clonar e compilar

git clone https://github.com/aplaceforallmystuff/mcp-kit.git
cd mcp-kit
npm install
npm run build

Configuração

1. Obtenha sua chave de API da Kit.com

1. Faça login na Kit.com
2. Navegue até Configurações > Desenvolvedor
3. Crie uma nova chave de API ou copie uma chave de API v4 existente

2. Configure seu cliente MCP

Para Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kit": {
      "command": "node",
      "args": ["/path/to/mcp-kit/dist/index.js"],
      "env": {
        "KIT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Para Claude Code

claude mcp add kit -e KIT_API_KEY=your-api-key-here -- node /path/to/mcp-kit/dist/index.js

Ou adicione a ~/.claude.json:

{
  "mcpServers": {
    "kit": {
      "command": "node",
      "args": ["/path/to/mcp-kit/dist/index.js"],
      "env": {
        "KIT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Exemplos de uso

Uma vez configurado, você pode interagir com a Kit.com por meio de linguagem natural:

Gerenciamento de assinantes

"Mostre-me todos os assinantes ativos dos últimos 30 dias"

"Crie um novo assinante com o email user@example.com e marque-o como 'newsletter'"

"Quais tags o subscriber@example.com tem?"

Operações de tags

"Liste todas as minhas tags e quantos assinantes cada uma tem"

"Crie uma tag chamada 'VIP Customers'"

"Adicione a tag 'engaged' a todos os assinantes que se inscreveram este mês"

Sequências de email

"Mostre-me todas as minhas sequências de email"

"Adicione user@example.com à sequência de boas-vindas"

Transmissões

"Crie um rascunho de transmissão com o assunto 'Weekly Update' e texto de pré-visualização 'This week in AI...'"

"Liste todas as minhas transmissões recentes e suas estatísticas"

Formulários

"Mostre-me todos os formulários ativos"

"Adicione um assinante ao meu formulário de inscrição principal"

Desenvolvimento

# Run in development mode (watches for changes)
npm run dev

# Build for production
npm run build

# Run the built version
npm start

Solução de problemas

"A variável de ambiente KIT_API_KEY é obrigatória"

Certifique-se de ter definido a variável de ambiente KIT_API_KEY na sua configuração MCP.

"Erro da API Kit (401)"

Sua chave de API é inválida ou expirou. Gere uma nova em Configurações > Desenvolvedor da Kit.com.

"Erro da API Kit (403)"

Sua chave de API não tem permissão para esta operação. Verifique se você está usando uma chave de API v4 com escopos apropriados.

"Erro da API Kit (404)"

O recurso (assinante, tag, transmissão, etc.) não foi encontrado. Verifique se o ID está correto.

"Erro da API Kit (422)"

Dados de solicitação inválidos. Verifique se os endereços de email são válidos e se os campos obrigatórios foram fornecidos.

Referência da API

Este servidor usa a API v4 da Kit.com. Todas as ferramentas suportam paginação quando aplicável usando os parâmetros de cursor per_page e after.

Contribuindo

Este projeto está obsoleto e não está aceitando contribuições. Por favor, use os servidores MCP oficiais da Kit em vez disso.

Licença

Licença MIT - veja LICENSE para detalhes.

Links

• Kit.com
• Documentação da API da Kit.com
• Model Context Protocol
• Especificação MCP