waitlister-mcp

Servidor MCP Waitlister — @waitlister/mcp

Um servidor MCP (Model Context Protocol) que conecta assistentes de IA como Claude, Cursor e Windsurf à API do Waitlister. Crie listas de espera e gerencie assinantes por meio de linguagem natural.

Este é o pacote oficial, que substitui o waitlister-mcp (1.0.x). As configurações existentes do waitlister-mcp continuam funcionando, mas novas instalações devem usar o @waitlister/mcp — ele adiciona suporte a chave de conta, criação de listas de espera, estatísticas e exclusão, e funciona em todos os planos.

O Que Você Pode Fazer Com Isso?

Depois de conectado, você pode pedir ao seu assistente de IA coisas como:

• "Minha chave do Waitlister está funcionando e posso criar outra lista de espera?"
• "Crie uma lista de espera para meu novo produto e me dê a URL do formulário de inscrição"
• "Lance minha lista de espera com uma página de destino — tema escuro — e publique"
• "Altere o título da página para 'Junte-se a mais de 500 pessoas'"
• "Gere uma página de destino: estética ousada, voltada para desenvolvedores" (construtor de IA, 1 crédito)
• "Adicione test@gmail.com à minha lista de espera"
• "Quantos assinantes eu tenho?"
• "Consulte o assinante john@acme.com"
• "Atualize os pontos do John para 500"
• "Mostre os 10 principais assinantes por número de indicações"

Ferramentas

Páginas com IA vs. páginas padrão: após generate_landing_page, o texto da página fica dentro da página gerada — o update_landing_page rejeita campos de texto/estrutura com orientação para usar generate_landing_page + is_edit em vez disso (theme e seo ainda atualizam normalmente). As páginas geradas são salvas como rascunhos, e a conversa com a IA é transferida para o chat de IA do painel.

Pré-requisitos

• Node.js 18+
• Uma conta no Waitlister — o plano gratuito funciona
• Uma chave de API de conta (recomendado), ou uma chave de API por lista de espera (plano Growth+)

Obtendo Sua Chave

Chave de conta (recomendado — funciona em todos os planos, cobre todas as listas de espera que você possui):

1. Faça login no Waitlister
2. Vá em Configurações → Chaves de API → crie uma chave (wl_acct_…)

Chave por lista de espera (legado, plano Growth+): lista de espera → Integrações → Acesso à API. Você também precisará da chave da lista de espera nas configurações da lista.

Instalação

Usando npx (recomendado)

Nenhuma instalação necessária — basta configurar seu cliente MCP:

{
  "mcpServers": {
    "waitlister": {
      "command": "npx",
      "args": ["-y", "@waitlister/mcp"],
      "env": {
        "WAITLISTER_ACCOUNT_KEY": "wl_acct_your-key"
      }
    }
  }
}

Com uma chave de conta, você pode opcionalmente adicionar "WAITLISTER_WAITLIST_KEY": "your-waitlist-key" para definir uma lista de espera padrão — caso contrário, cada chamada de ferramenta pode direcionar qualquer lista de espera que você possui por meio do parâmetro waitlist_key (peça ao assistente para executar list_waitlists primeiro).

{
  "mcpServers": {
    "waitlister": {
      "command": "npx",
      "args": ["-y", "@waitlister/mcp"],
      "env": {
        "WAITLISTER_API_KEY": "your-api-key",
        "WAITLISTER_WAITLIST_KEY": "your-waitlist-key"
      }
    }
  }
}

Instalação global

npm install -g @waitlister/mcp

Depois configure com "command": "waitlister-mcp" e o mesmo env.

Configuração por Cliente

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) com o JSON acima.

Cursor

Vá em Configurações → MCP → Adicionar novo servidor MCP e use a mesma configuração.

Claude Code

claude mcp add waitlister --env WAITLISTER_ACCOUNT_KEY=wl_acct_your-key -- npx -y @waitlister/mcp

Variáveis de Ambiente

Notas

• Exclusividade: nomes de listas de espera e slugs de URL são exclusivos em todo o Waitlister. O create_waitlist rejeita um nome/slug já utilizado com uma mensagem informando o que alterar.
• Contadores assíncronos: inscrições e exclusões atualizam os contadores do get_stats e as posições na fila em alguns segundos, não instantaneamente.
• Restrições por plano: criar listas de espera, adicionar assinantes e estatísticas funcionam em todos os planos (limites de taxa menores nos planos gratuitos). Ler/atualizar/excluir dados de assinantes requer o plano Growth ou superior — consulte limites de taxa.
• Construído sobre o SDK oficial waitlister (erros tipados, novas tentativas automáticas com backoff).

Desenvolvimento

git clone https://github.com/ilpr/waitlister-mcp.git
cd waitlister-mcp
npm install
npm run build

Teste com o MCP Inspector:

WAITLISTER_ACCOUNT_KEY=wl_acct_your-key npm run inspect

Links

• Waitlister — crie listas de espera para os lançamentos dos seus produtos
• Documentação da API
• Protocolo MCP

Privacidade

Política completa: https://waitlister.me/privacy-policy

O que esta extensão coleta. Nada por conta própria. Ela é executada localmente na sua máquina e não possui banco de dados, telemetria ou análises. Ela armazena apenas a credencial que você insere — sua chave de API da conta Waitlister — que o Claude Desktop mantém no armazenamento seguro de credenciais do seu sistema operacional.

O que ela envia e para onde. A extensão envia as solicitações de API que você pede que ela faça, via HTTPS, para a API do Waitlister em https://waitlister.me/api/v1, autenticadas com sua chave. Isso significa os argumentos que você (ou o Claude, sob sua instrução) passa para uma ferramenta: por exemplo, um nome de lista de espera, texto da página de destino ou o endereço de e-mail de um assinante ao adicioná-lo. Nada é enviado para qualquer outro lugar. Não há análises de terceiros, rastreadores de erros ou serviços intermediários no caminho.

Como as solicitações se identificam. Como qualquer SDK, essas solicitações carregam cabeçalhos de identificação para que o Waitlister possa distinguir tráfego de agentes de tráfego comum de API e oferecer suporte adequado: o nome e a versão deste pacote (waitlister-mcp/1.4.0), a versão do SDK, a versão do Node e o nome e a versão que seu host MCP anuncia no handshake do protocolo (por exemplo, claude-ai/0.1.0). Nenhum texto de prompt, caminhos de arquivo, identificadores de máquina ou usuário. Nada extra é enviado — esses dados acompanham solicitações que você já fez.

Como esses dados são usados e retidos. Os dados que chegam à API do Waitlister são tratados de acordo com a política de privacidade do Waitlister vinculada acima — os mesmos termos que se aplicam quando você usa o painel web. Registros de listas de espera e assinantes persistem na sua conta Waitlister até que você os exclua, pelo painel ou com a ferramenta delete_subscriber. A extensão em si não retém nada após a conclusão de uma solicitação.

Compartilhamento com terceiros. O Waitlister não vende seus dados. Designs de páginas de destino solicitados por meio de generate_landing_page são produzidos pelo construtor de páginas com IA do Waitlister, que envia seu prompt de design a um provedor de modelo terceirizado; consulte a política de privacidade para a lista atual de subprocessadores.

Seus controles. Revogue a chave de API a qualquer momento no Waitlister em Configurações → Chaves de API, o que interrompe imediatamente o acesso desta extensão à sua conta. Desinstalar a extensão remove a chave armazenada da sua máquina. Solicitações de exclusão de conta e dados seguem o processo descrito na política de privacidade.

Contato. https://waitlister.me/contact

Licença

MIT — consulte LICENÇA.