mailtani

Gerencie o email marketing do mailtani a partir do Claude, Cursor ou qualquer agente de IA compatível com MCP — contatos, listas, campanhas, segmentos e rastreamento de eventos.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Mailtani

Gerencie seu email marketing diretamente do Claude, Cursor ou qualquer agente de IA compatível com MCP.

O servidor MCP Mailtani expõe seus contatos, listas, segmentos, campanhas, emails, tags, campos personalizados e rastreamento de eventos como ferramentas nativas de IA — para que seu agente possa enviar campanhas, inscrever contatos e rastrear eventos sem sair do chat.

O que você pode fazer

Categoria	Ferramentas
Contatos	Listar, criar (ou upsert), atualizar, excluir
Listas	Listar todas, criar, adicionar contatos, remover contato
Segmentos	Listar todos, criar com condições, obter contatos correspondentes
Campanhas	Listar, criar transmissão, criar sequência, criar fluxo (todos como rascunhos)
Emails	Listar emails enviados, enviar email transacional único
Tags	Listar todas, criar, excluir
Campos personalizados	Listar todos, criar
Eventos	Rastrear um evento personalizado (dispara fluxos)

Exemplos de prompts que você pode usar

"Create a broadcast campaign called 'Q3 Newsletter' targeting my 'Leads' list."

"Create a contact for john@acme.com, tag him as VIP, and send him the onboarding email."

"Track a purchase_completed event for sarah@example.com with plan=pro."

"Show me all contacts added in the last 7 days."

"Set up a 3-step welcome sequence for new signups with delays of 0, 3, and 7 days."

"Create a flow that sends an email whenever a contact is added to my project."

Autenticação

O servidor MCP usa o mesmo sistema de chave de API da API REST do Mailtani.

Cada requisição requer dois cabeçalhos:

Cabeçalho	Valor
`Authorization`	`Bearer mk_YOUR_API_KEY`
`X-Project-Id`	Seu ID de projeto (encontrado em Configurações → API)

Gere uma chave de API em Configurações → Chaves de API dentro da sua conta Mailtani.

Configuração

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mailtani": {
      "type": "http",
      "url": "https://mailtani.com/mcp",
      "headers": {
        "Authorization": "Bearer mk_YOUR_API_KEY",
        "X-Project-Id": "YOUR_PROJECT_ID"
      }
    }
  }
}

Reinicie o Claude Desktop. Você verá um ícone de martelo confirmando que o servidor foi conectado.

Claude Code

Execute no seu terminal:

claude mcp add --transport http mailtani https://mailtani.com/mcp \
  --header "Authorization: Bearer mk_YOUR_API_KEY" \
  --header "X-Project-Id: YOUR_PROJECT_ID"

Cursor

Adicione nas suas configurações MCP do Cursor (Cursor → Settings → MCP):

{
  "mailtani": {
    "type": "http",
    "url": "https://mailtani.com/mcp",
    "headers": {
      "Authorization": "Bearer mk_YOUR_API_KEY",
      "X-Project-Id": "YOUR_PROJECT_ID"
    }
  }
}

Codex

Adicione em ~/.codex/config.json:

{
  "mcpServers": {
    "mailtani": {
      "type": "http",
      "url": "https://mailtani.com/mcp",
      "headers": {
        "Authorization": "Bearer mk_YOUR_API_KEY",
        "X-Project-Id": "YOUR_PROJECT_ID"
      }
    }
  }
}

Qualquer cliente compatível com MCP

Endpoint:  POST https://mailtani.com/mcp
Protocol:  MCP over HTTP (JSON-RPC 2.0)
Auth:      Authorization: Bearer mk_...
Scope:     X-Project-Id: <id>
Rate limit: 30 requests / minute

Referência de ferramentas

Contatos

Ferramenta	Descrição
`list-contacts`	Listar contatos com busca opcional, filtro por lista/ tag/ status, paginação
`create-contact`	Criar ou upsert um contato por email; opcionalmente atribuir listas e tags
`update-contact`	Atualizar campos, listas e tags do contato por ID
`delete-contact`	Excluir permanentemente um contato por ID

Listas

Ferramenta	Descrição
`list-lists`	Listar todas as listas de contatos com contagens de contatos
`create-list`	Criar uma nova lista de contatos
`add-contact-to-list`	Adicionar até 500 contatos a uma lista de uma vez
`remove-contact-from-list`	Remover um único contato de uma lista

Segmentos

Ferramenta	Descrição
`list-segments`	Listar todos os segmentos com contagens de contatos
`create-segment`	Criar um segmento com condições de filtro (máx. 50)
`get-segment-contacts`	Obter contatos paginados que correspondem a um segmento

Campanhas

As campanhas são sempre criadas como rascunhos. Abra o aplicativo Mailtani para revisá-las e ativá-las.

Ferramenta	Descrição
`list-campaigns`	Listar campanhas filtradas por tipo ou status
`create-broadcast`	Criar um rascunho de envio único; opcionalmente direcionar listas e segmentos
`create-sequence`	Criar um rascunho de sequência de gotejamento em várias etapas com atrasos por etapa
`create-flow`	Criar um rascunho de fluxo de automação visual acionado pelo comportamento do contato

Emails

Ferramenta	Descrição
`list-emails`	Listar emails enviados, opcionalmente filtrados por contato
`send-email`	Enviar um email transacional único para qualquer endereço

Ferramenta	Descrição
`list-tags`	Listar todas as tags com contagens de contatos
`create-tag`	Criar uma nova tag
`delete-tag`	Excluir uma tag por ID

Campos personalizados

Ferramenta	Descrição
`list-custom-fields`	Listar todos os campos personalizados
`create-custom-field`	Criar um campo personalizado (idempotente por nome)

Eventos

Ferramenta	Descrição
`track-event`	Rastrear um evento personalizado para um contato; persiste propriedades e dispara fluxos

Segurança

Todas as operações são limitadas ao seu projeto via X-Project-Id — nenhuma ferramenta pode ler ou modificar dados de outro projeto
As chaves de API são hash SHA-256 em repouso; texto simples nunca é armazenado
Limite de 30 requisições por minuto
Os limites diários de envio de email são aplicados conforme seu plano