Sequenzy MCP Server

oficial

Ferramenta de Email Marketing para SaaS

Documentação

Sequenzy MCP Server

Servidor MCP oficial para Sequenzy, a plataforma de email marketing com inteligência artificial.

Conecte o Sequenzy ao Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw e outros clientes MCP para que seu assistente de IA possa gerenciar operações de email com ferramentas estruturadas em vez de chamadas de API manuais.

O Que Você Pode Fazer

Gerenciar assinantes, tags, listas e segmentos dinâmicos.
Sincronizar segmentos com públicos personalizados do Meta para retargeting no Facebook e Instagram.
Gerenciar produtos e anexar arquivos de entrega digital para automações de compra.
Rascunhar, atualizar, agendar e inspecionar campanhas.
Criar e editar sequências de email, incluindo automações acionadas por eventos e entrada em segmentos.
Cancelar, pausar, retomar, duplicar ou excluir campanhas e inscrever contatos em sequências.
Gerenciar modelos de email transacional e enviar emails transacionais individuais.
Criar, editar, publicar, despublizar e excluir landing pages.
Conectar e verificar domínios personalizados para landing pages publicadas.
Gerenciar convites de equipe, conversas da caixa de entrada e endpoints de webhook de saída.
Gerar texto de email, linhas de assunto e sequências de múltiplas etapas.
Inspecionar análises, atividade de assinantes, saúde de entregabilidade e URLs do painel.
Configurar informações de produto da empresa, sites de remetente e exemplos de integração para frameworks comuns.

Cada ferramenta MCP publicada inclui anotações explícitas de readOnlyHint, destructiveHint e openWorldHint para que clientes compatíveis possam exibir affordances precisas de uso de ferramentas. As ferramentas também publicam definições de outputSchema e retornam structuredContent, fornecendo a clientes e modelos formatos de resultado legíveis por máquina para chamadas de acompanhamento.

Configuração Rápida

O caminho de configuração mais fácil é o assistente do Sequenzy:

npx @sequenzy/setup

O assistente abre o fluxo de login no navegador, cria uma chave de API pessoal, detecta clientes de IA suportados e os configura automaticamente quando possível.

MCP Remoto Hospedado

Para clientes que suportam MCP HTTP Transmissível, use o endpoint hospedado do Sequenzy em vez de executar um processo stdio local:

https://api.sequenzy.com/v1/mcp

Clientes remotos devem autenticar com o fluxo OAuth do Sequenzy quando suportado. Clientes locais e de automação ainda podem usar o pacote stdio abaixo com SEQUENZY_API_KEY.

Arquivos de descoberta legíveis por máquina:

Manifesto do servidor MCP: server.json
Cartão do agente: .well-known/agent-card.json
Manifesto de capacidade do agente: agent-capability.json
Metadados de habilidade OpenClaw: openclaw/skill.json

Configuração Manual

Todos os clientes MCP stdio usam o mesmo comando:

Comando: npx
Args: -y @sequenzy/mcp
Env obrigatória: SEQUENZY_API_KEY=seq_user_your_key_here

Variáveis de ambiente opcionais:

SEQUENZY_API_URL - URL base da API do Sequenzy. O padrão é https://api.sequenzy.com.
SEQUENZY_APP_URL - URL base do painel do Sequenzy usada pelos auxiliares de URL do app. O padrão é https://sequenzy.com.

Claude Desktop

Adicione isto à sua configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Reinicie o Claude Desktop após editar a configuração.

Claude Code

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- npx -y @sequenzy/mcp

No Windows nativo, envolva npx com cmd /c:

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- cmd /c npx -y @sequenzy/mcp

Para uma configuração de projeto compartilhada, use .mcp.json:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Codex

codex mcp add sequenzy --env SEQUENZY_API_KEY=seq_user_your_key_here -- npx -y @sequenzy/mcp
codex mcp list

Configuração manual do Codex em ~/.codex/config.toml:

[mcp_servers.sequenzy]
command = "npx"
args = ["-y", "@sequenzy/mcp"]

[mcp_servers.sequenzy.env]
SEQUENZY_API_KEY = "seq_user_your_key_here"

Cursor

Adicione isto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Windsurf

Use o mesmo formato JSON do Cursor.

macOS: ~/Library/Application Support/Windsurf/mcp.json
Windows: %APPDATA%\Windsurf\mcp.json

VS Code Copilot

O VS Code usa um objeto servers:

{
  "servers": {
    "sequenzy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Outros Clientes MCP

Para OpenClaw, Hermes e outros clientes compatíveis com MCP, aponte o cliente para npx -y @sequenzy/mcp e defina SEQUENZY_API_KEY.

Obtendo uma Chave de API

Abra o painel do Sequenzy.
Vá para Configurações -> Chaves de API.
Crie uma chave pessoal.
Adicione a chave à configuração do seu cliente MCP.

Chaves pessoais começam com seq_user_. Você pode revogá-las a qualquer momento no painel.

Ferramentas

Este servidor atualmente expõe 120 ferramentas MCP.

Conta, Empresas, Configuração

Ferramenta	Descrição
`get_account`	Obter informações da conta, empresas disponíveis e a empresa atual.
`select_company`	Definir a empresa ativa para futuras chamadas de ferramentas.
`get_app_urls`	Construir URLs do painel para campanhas, landing pages, sequências, emails, configurações, domínios e detalhes de emails enviados.
`create_company`	Criar uma nova empresa ou marca.
`get_company`	Ler detalhes da empresa, informações do produto, cores da marca, contexto de escrita de IA e configurações de localização.
`update_company`	Editar informações do produto e contexto da marca que a IA usa para emails gerados.
`create_api_key`	Criar uma chave de API para uma empresa.
`list_websites`	Listar sites de remetente e domínios configurados.
`add_website`	Adicionar um site de remetente. O processamento pode levar cerca de 30 segundos.
`check_website`	Verificar se um site está processado e pronto.
`get_integration_guide`	Obter exemplos de integração específicos do framework.

Assinantes

Ferramenta	Descrição
`add_subscriber`	Adicionar um assinante com atributos, tags, status, modo de opt-in e IDs de lista opcionais.
`update_subscriber`	Atualizar atributos, adicionar tags ou remover tags.
`remove_subscriber`	Cancelar inscrição de um assinante ou excluí-lo permanentemente.
`get_subscriber`	Buscar detalhes do assinante por email ou ID externo.
`search_subscribers`	Pesquisar por consulta, tags, lista, status, segmento ou paginação.

Produtos e Entrega Digital

Ferramenta	Descrição
`list_products`	Listar produtos sincronizados do Stripe, Shopify, WooCommerce, dados manuais ou da API Commerce.
`upsert_products`	Criar ou atualizar até 100 produtos da API Commerce indexados pelo seu ID de produto.
`delete_product`	Excluir um produto enviado anteriormente pela API Commerce.
`attach_product_file`	Anexar um arquivo de entrega hospedado ou enviado localmente a um produto.
`remove_product_file`	Remover um arquivo de entrega de produto anexado.
`sync_products`	Enfileirar uma sincronização do catálogo de produtos do Stripe.

Após um arquivo de entrega de produto ser anexado, eventos de compra correspondentes incluem download.url e download.name, para que emails acionados por compra possam usar tags de mesclagem como {{event.download.url}}.

Listas, Tags, Segmentos

Ferramenta	Descrição
`list_tags`	Listar todas as tags.
`create_tag`	Criar uma definição de tag com uma cor opcional.
`update_tag`	Atualizar a cor de uma tag.
`delete_tag`	Excluir uma tag e removê-la dos assinantes.
`list_lists`	Listar listas de assinantes.
`create_list`	Criar uma lista de assinantes.
`update_list`	Renomear ou descrever uma lista de assinantes.
`delete_list`	Excluir uma lista de assinantes.
`add_subscribers_to_list`	Adicionar até 500 assinantes a uma lista a partir de um array de emails.
`remove_subscribers_from_list`	Remover até 500 assinantes de uma lista.
`list_segments`	Listar segmentos salvos e contagens.
`create_segment`	Criar segmentos salvos a partir de filtros ou grupos aninhados AND/OR.
`update_segment`	Atualizar nome do segmento, filtros, grupo raiz ou operador de junção.
`delete_segment`	Excluir um segmento salvo.
`get_segment_count`	Visualizar a contagem de assinantes ativos para um segmento.

Para exportações de assinantes, search_subscribers aceita listId, listName exato ou list (ID primeiro, depois nome exato). Se limit for omitido, a ferramenta busca todos os assinantes correspondentes usando páginas de API de 100 linhas.

Para preenchimento de lista em massa, use add_subscribers_to_list; o endpoint da API de suporte é POST /api/v1/lists/{listId}/subscribers sem sufixo /bulk:

{
  "emails": ["[email protected]", "[email protected]"],
  "duplicateStrategy": "skip",
  "enrollInSequences": false,
  "optInMode": "default"
}

Envie no máximo 500 emails por requisição. Os limites de taxa padrão da API ainda se aplicam: 100 requisições por minuto por chave de API e 20 requisições por segundo em rajada. Para importações CLI orientadas por CSV, os cabeçalhos de email aceitos incluem email, e-mail, email address e mail; se nenhum cabeçalho reconhecido existir, a CLI lê a primeira coluna.

Filtros de segmento suportam atributos, eventos, associação a segmentos salvos, eventos de engajamento, regras de compra de produtos Stripe e regras de compra de produtos commerce. Use filterJoinOperator: "or" para segmentos de correspondência qualquer, ou passe um grupo v2 root para lógica aninhada.

Cada campo de filtro de segmento valida seus próprios operadores:

status, segment: is, is_not
tag: contains, not_contains, is_empty, is_not_empty
email: contains, not_contains
emailProvider, list: is, is_not, is_empty, is_not_empty
firstName, lastName: contains, not_contains, is_empty, is_not_empty
added: less_than, more_than
attribute: is, is_not, is_empty, is_not_empty, gte, lte, gt, lt, contains, not_contains
event, campos de engajamento de email: is, is_not, at_least, less_than_count
emailBounced: também suporta is_temporary_bounce, is_permanent_bounce
stripeProduct: is, is_not, at_least, less_than_count
stripeCurrentProduct, stripeTrialProduct: is, is_not, gte, lte, gt, lt
commerceProduct: is, is_not, at_least, less_than_count

Exemplos de filtro de produto Stripe:

{ "field": "stripeProduct", "operator": "is", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "is_not", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "at_least", "value": "prod_pro:3" }
{ "field": "stripeProduct", "operator": "less_than_count", "value": "prod_pro:3" }

Os filtros de produtos de comércio correspondem a produtos adquiridos por meio de pedidos de comércio. Os valores podem ser provider:productId para IDs com escopo de provedor (shopify, woocommerce ou api), um ID de produto simples para corresponder a qualquer provedor ou provider:productId:count para operadores de limite:

{ "field": "commerceProduct", "operator": "is", "value": "api:starter-kit" }
{ "field": "commerceProduct", "operator": "at_least", "value": "shopify:42:2" }

Campos de engajamento como emailSent, emailDelivered, emailOpened, emailClicked, emailBounced e emailComplained aceitam janelas móveis como 7d, 30d, 90d, 180d, all, valores de limite como 5:30d ou um escopo de campanha como campaign:cmp_123.

Sincronizações de Público (Meta Ads)

Ferramenta	Descrição
`list_audience_syncs`	Lista sincronizações de segmento para público com agendamento e status da última sincronização.
`list_ad_accounts`	Lista as contas de anúncios do Meta disponíveis para sincronização.
`create_audience_sync`	Envia um segmento para um público personalizado do Meta em um agendamento.
`update_audience_sync`	Altera a frequência de sincronização (`hourly`, `daily`, `weekly`) ou pausa/retoma.
`delete_audience_sync`	Remove um mapeamento de sincronização; o público do Meta em si é mantido.
`sync_audience_now`	Aciona um envio imediato fora do agendamento regular.

Requer que a integração com Meta Ads esteja conectada no painel do Sequenzy (Configurações -> Integrações). create_audience_sync aceita um segmento existente (segmentId) ou um modelo pronto (predefinedSegmentId, por exemplo zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged) - o segmento do modelo é criado automaticamente no primeiro uso, e o primeiro envio é executado imediatamente.

Os públicos são somente de adição: assinantes que posteriormente saem do segmento permanecem no público do Meta. O Meta exige mais de 100 pessoas correspondidas antes que um público possa ser usado para entrega de anúncios.

Modelos

Ferramenta	Descrição
`list_templates`	Lista modelos com status de localização.
`get_template`	Lê detalhes do modelo, conteúdo e variantes localizadas.
`create_template`	Cria modelos a partir de HTML ou blocos do Sequenzy.
`update_template`	Atualiza metadados do modelo, rótulos, HTML ou blocos.
`delete_template`	Exclui um modelo.

Testes A/B

Ferramenta	Descrição
`list_ab_tests`	Lista testes A/B e variantes, opcionalmente com escopo por sequência.
`get_ab_test`	Obtém variantes, conteúdo e status de localização.
`get_ab_test_stats`	Obtém estatísticas agregadas e por variante.
`restart_ab_test`	Reinicia um teste A/B interrompido ou concluído.
`update_ab_test_variant`	Atualiza assunto, texto de pré-visualização, HTML ou blocos de uma variante de rascunho.
`create_ab_test`	Cria um teste A/B de campanha ou sequência.
`add_ab_test_variant`	Adiciona uma variante a um teste A/B existente.
`delete_ab_test_variant`	Exclui uma variante de rascunho de teste A/B.
`delete_ab_test`	Exclui um teste A/B.

Use get_ab_test para descobrir IDs de variantes antes de editar. As atualizações de variantes aceitam html ou blocks, não ambos.

Campanhas

Ferramenta	Descrição
`list_campaigns`	Lista campanhas, opcionalmente filtradas por status.
`get_campaign`	Obtém detalhes e estatísticas da campanha.
`get_email_send`	Inspeciona um registro de detalhes de e-mail enviado.
`create_campaign`	Cria uma campanha de rascunho a partir de HTML, blocos, um modelo ou dados de campanha.
`update_campaign`	Atualiza uma campanha de rascunho, incluindo dados da campanha e listas computadas.
`schedule_campaign`	Agenda um rascunho ou reagenda uma campanha agendada existente.
`send_test_email`	Envia um e-mail de teste para um endereço.
`cancel_campaign`	Cancela uma campanha agendada ou em envio.
`pause_campaign`	Pausa uma campanha em envio.
`resume_campaign`	Retoma uma campanha pausada, opcionalmente distribuindo a entrega ao longo do tempo.
`delete_campaign`	Exclui uma campanha.
`duplicate_campaign`	Duplica uma campanha em um novo rascunho.
`resend_campaign_to_non_openers`	Cria um rascunho de reenvio para os membros do público original que não abriram uma campanha enviada.

Páginas de Destino

Ferramenta	Descrição
`list_landing_pages`	Lista páginas de destino com status, métricas, conteúdo e URLs.
`get_landing_page`	Obtém detalhes da página de destino, conteúdo do construtor, métricas e URLs públicas.
`create_landing_page`	Cria uma página de destino de rascunho a partir do conteúdo do modelo padrão ou JSON.
`update_landing_page`	Edita o nome, slug ou conteúdo completo compatível com o editor de uma página de destino.
`publish_landing_page`	Publica uma página de destino, opcionalmente salvando as edições primeiro.
`unpublish_landing_page`	Retorna uma página de destino ao status de rascunho, opcionalmente salvando as edições primeiro.
`delete_landing_page`	Exclui uma página de destino não publicada.
`connect_landing_page_domain`	Conecta um domínio personalizado de página de destino e retorna detalhes de configuração de DNS.
`update_landing_page_domain_settings`	Substitui ou verifica as configurações de domínio personalizado da página de destino.

O conteúdo da página de destino usa o esquema JSON compatível com o editor do Sequenzy com version, template, seo, theme e blocks. Domínios personalizados de página de destino exigem um registro CNAME apontando para pages.sequenzydns.com; chame update_landing_page_domain_settings com verify: true após a propagação das alterações de DNS.

Sequências

Ferramenta	Descrição
`list_sequences`	Lista sequências de e-mail e status de automação.
`get_sequence`	Obtém detalhes da sequência, incluindo `nodeId` da etapa, `emailId` vinculado, assunto, texto de pré-visualização e blocos.
`create_sequence`	Cria sequências geradas por IA ou com etapas explícitas.
`update_sequence`	Atualiza configurações da sequência, comportamento de inscrição, etapas existentes, lógica de ramificação ou insere etapas lineares.
`insert_sequence_step`	Insere uma nova etapa de e-mail, opcionalmente com um nó de atraso antes dela.
`enable_sequence`	Ativa uma sequência.
`disable_sequence`	Congela uma sequência, bloqueando novas inscrições e retendo os destinatários atuais.
`pause_sequence_enrollments`	Interrompe novas inscrições para uma sequência ativa enquanto os destinatários atuais continuam.
`resume_sequence_enrollments`	Reabre novas inscrições para uma sequência ativa sem alterar os destinatários atuais.
`enroll_subscribers_in_sequence`	Inscreve até 500 assinantes por e-mail, ID de assinante ou ambos, opcionalmente em um nó de destino.
`cancel_sequence_enrollments`	Interrompe inscrições ativas ou em espera por valores de campos de assinante ou evento de entrada.
`delete_sequence`	Exclui uma sequência.

A criação de sequências suporta:

trigger: "segment_entered" mais segmentId para automações de entrada de segmento salvo.
trigger: "event_received" mais {{event.*}} tags de mesclagem em assuntos ou conteúdo do corpo.
trigger: "inactivity" mais eventName, inactiveDays e inactivityBaseline opcional (sequence_created_at ou subscriber_created_at).
goal para conteúdo de e-mail gerado por IA.
steps explícito com blocks do Sequenzy.
steps explícito com HTML, que o Sequenzy converte em blocos editáveis.
Esperas fixas via delay / delayMs, ou esperas dinâmicas de campo de data via waitUntil para lembretes de renovação, acompanhamentos de compromissos, avisos de expiração de teste e outras datas específicas de eventos.
Etapas de ação de desconto que expõem tags de mesclagem como {{discount.code}} e {{discount.percentOff}}.
enrollmentMode: "matching_field" e enrollmentFieldPath para automações de eventos específicos de produto, variante, pedido ou assinatura.

As atualizações de sequências suportam insertSteps para adicionar novas etapas lineares após um nodeId retornado por get_sequence. Omita afterNodeId apenas ao anexar a uma sequência com exatamente uma cauda linear. insertSteps suporta etapas adicionáveis que não exigem registros complementares, como e-mail, atraso, ações de tag/lista, atualizações de atributos, descontos, condições, etapas de espera por evento e webhooks. Use branch para ramificações se/senão de múltiplos caminhos; forneça branch ou insertSteps, não ambos. As condições de ramificação suportam verificações de presença e ausência de tag com has_tag e does_not_have_tag, além de listas, segmentos salvos, eventos, links clicados e comparações de campos. Os arrays emails e steps editam apenas etapas de e-mail existentes por nodeId, emailId ou ordem do array; use insertSteps para criar novas etapas e inclua um delay, delayMs ou waitUntil no nível da etapa quando o e-mail inserido precisar de um temporizador. waitUntil aceita um campo de data do evento de gatilho mais offset opcional, direction (before ou after) e missingAction (continue ou exit). Para sequências ativas, passe confirmStructuralChange: true com insertSteps ou branch somente após confirmar o impacto no fluxo ao vivo.

Execute cancel_sequence_enrollments com dryRun: true antes de aplicar o cancelamento em massa.

Estilização de Blocos de E-mail

Ferramentas que aceitam blocks persistem a estilização visual por bloco sob o objeto styles de um bloco:

{
  "type": "card",
  "title": "Your update",
  "content": "Everything is ready.",
  "variant": "default",
  "styles": {
    "backgroundColor": "#f8fafc",
    "backgroundOpacity": 85,
    "borderColor": "#cbd5e1",
    "borderWidth": 1,
    "borderRadius": 12
  }
}

Para compatibilidade com prompts de agentes mais antigos, chaves de estilo de nível superior como backgroundColor, backgroundOpacity, borderColor, borderWidth e borderRadius também são aceitas e salvas em styles.

E-mail Transacional

Ferramenta	Descrição
`list_transactional_emails`	Listar templates transacionais e slugs de API.
`get_transactional_email`	Ler um e-mail transacional por ID ou slug.
`create_transactional_email`	Criar um template de e-mail transacional.
`update_transactional_email`	Atualizar metadados transacionais ou conteúdo do corpo.
`send_email`	Enviar um único e-mail transacional por template ou HTML.

Variáveis send_email suportam arrays aninhados para blocos de repetição, como { "event": { "items": [...] } }.

Analytics

Ferramenta	Descrição
`get_stats`	Obter estatísticas gerais para `7d`, `30d` ou `90d`.
`get_campaign_stats`	Obter desempenho detalhado da campanha.
`get_sequence_stats`	Obter desempenho da sequência.
`list_campaign_events`	Listar eventos de e-mail brutos paginados para uma campanha.
`list_sequence_events`	Listar eventos de e-mail brutos paginados para uma sequência.
`get_subscriber_activity`	Obter estatísticas de e-mail do assinante, atividade e inscrições.

As ferramentas de analytics excluem por padrão aberturas/cliques de bots, scanners, pré-visualização de links e ativos rastreados detectados. Passe includeMachineEngagement: true para get_stats, get_campaign_stats, get_sequence_stats, get_ab_test_stats, get_subscriber ou get_subscriber_activity quando precisar de diagnósticos de engajamento brutos; as linhas de atividade de abertura/clique incluídas expõem os campos machine, engagementQuality e classificationReasons onde a API retorna atividade em nível de evento.

Equipe, Caixa de Entrada, Webhooks

Ferramenta	Descrição
`list_team_members`	Listar membros da equipe e convites pendentes.
`invite_team_member`	Convidar um colega como admin ou visualizador, com acesso opcional de cobrança.
`cancel_team_invitation`	Cancelar um convite de equipe pendente.
`list_conversations`	Listar conversas de resposta de assinantes com filtros de status e não lidas.
`get_conversation`	Ler uma conversa e seu histórico de mensagens.
`reply_to_conversation`	Enviar uma resposta de saída ou adicionar uma nota interna.
`update_conversation_status`	Abrir ou fechar uma conversa.
`mark_conversation_read`	Marcar todas as mensagens em uma conversa como lidas.
`list_webhooks`	Listar endpoints de webhook de saída.
`create_webhook`	Criar um webhook de saída e retornar seu segredo de assinatura único.
`update_webhook`	Atualizar nome, URL, eventos ou status do webhook.
`delete_webhook`	Excluir permanentemente um endpoint de webhook e histórico de entrega.
`test_webhook`	Enviar um evento de teste para um endpoint de webhook.
`list_webhook_deliveries`	Listar tentativas de entrega recentes para um webhook.
`replay_webhook_delivery`	Repetir uma entrega de webhook.

Geração por IA

Ferramenta	Descrição
`generate_email`	Gerar blocos de e-mail a partir de um prompt.
`generate_sequence`	Gerar uma sequência de múltiplos e-mails a partir de um objetivo.
`generate_subject_lines`	Gerar variantes de linha de assunto para teste A/B.

O conteúdo gerado é retornado como rascunho para revisão.

Recursos

O servidor também expõe recursos MCP somente leitura.

Recurso	Descrição
`sequenzy://dashboard`	Estatísticas gerais ao vivo dos últimos 7 dias.
`sequenzy://company`	Configurações atuais da empresa e localização.
`sequenzy://campaigns/recent`	Últimas 10 campanhas com status e estatísticas básicas.
`sequenzy://subscribers/recent`	Assinantes adicionados mais recentemente.
`sequenzy://subscribers/engaged`	Assinantes mais ativos ou engajados.
`sequenzy://sequences`	Todas as sequências com status.
`sequenzy://templates`	Templates com status de localização.
`sequenzy://segments`	Segmentos salvos com contagens de assinantes.
`sequenzy://tags`	Tags com contagens de uso.
`sequenzy://health`	Métricas de entregabilidade e status de saúde.
`sequenzy://app-routes`	Templates de rota do painel e abas de configurações.

Exemplos de Prompts

Add [email protected] with tags "vip" and "developer", then put them on the beta list.

Create a 4-email churn prevention sequence for users whose subscription expires soon. Leave it in draft mode.

Create a segment for subscribers who bought Stripe product prod_pro at least 3 times.

Draft a campaign about our new analytics dashboard, target the Pro users segment, and send a test to me.

How did the last campaign perform compared with the one before it?

Segurança

Use chaves de API pessoais, não segredos de equipe compartilhados.
As chaves acessam apenas empresas que seu usuário Sequenzy pode acessar.
Revogue as chaves em Configurações -> Chaves de API quando o acesso não for mais necessário.
Mantenha os prompts de aprovação do cliente habilitados para envios, agendamentos, exclusões e alterações em massa.
Prefira fluxos de trabalho de rascunho para campanhas e sequências, depois revise no Sequenzy antes do lançamento.

Solução de Problemas

`SEQUENZY_API_KEY environment variable is required`

Defina SEQUENZY_API_KEY na configuração do cliente MCP ou execute:

npx @sequenzy/setup

Chave de API Inválida

Crie uma nova chave pessoal em Configurações -> Chaves de API, atualize sua configuração MCP e reinicie o cliente.

Recursos Duplicados

Se uma chamada de ferramenta criar um nome de segmento ou domínio de envio duplicado, o servidor retorna um code estável, um description amigável ao agente, um resolution concreto e um docsUrl. Para segmentos, chame list_segments e reutilize o ID do segmento existente ou escolha um nome diferente. Para sites, chame list_websites; se o domínio não estiver listado para a empresa selecionada, ele pertence a outra empresa ou conta e deve ser removido, reatribuído ou substituído por um domínio de envio diferente.

Ferramentas Não Aparecem

Confirme se npx está disponível no ambiente que o cliente usa.
Reinicie o cliente MCP após editar a configuração.
Verifique se a configuração está no local correto específico do cliente.

Problemas de Rede ou URL da API

O servidor usa https://api.sequenzy.com por padrão. Se você substituí-lo, verifique se SEQUENZY_API_URL aponta para uma URL base da API Sequenzy acessível.

Desenvolvimento

bun install
bun test
bun run type-check
bun run build

Os esquemas de ferramentas MCP devem permanecer compatíveis com clientes restritos:

As raízes da ferramenta inputSchema devem ser esquemas type: "object" simples.
Não publique anyOf em nenhum lugar nos esquemas de ferramentas.
Não coloque oneOf, allOf, enum ou not na raiz de um esquema de ferramenta.
Aplique requisitos condicionais nos manipuladores e cubra-os com testes.

Este repositório independente espelha o pacote MCP mantido no monorepo principal do Sequenzy. Consulte AGENTS.md para regras de sincronização.

Licença

MIT

Descoberta nativa para agentes

O Sequenzy publica manifestos legíveis por máquina para redes de agentes e descoberta estilo A2A:

Endpoint MCP remoto: https://api.sequenzy.com/v1/mcp
Manifesto de capacidade do agente: agent-capability.json
Cartão de agente estilo A2A: .well-known/agent-card.json
Metadados de habilidade OpenClaw/Moltbot: openclaw/skill.json
Guia operacional OpenClaw/Moltbot: openclaw/SKILL.md

Esses arquivos descrevem o Sequenzy como uma capacidade autorizada de automação de e-mail para agentes. Eles excluem explicitamente casos de uso de raspagem, spam e divulgação fria não solicitada.