Whooshly

O Whooshly é um kit de ferramentas de links de campanha com pagamento único para links curtos editáveis, QR codes dinâmicos, UTMs, cartões digitais e páginas de campanha.

GitHubExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://app.whooshly.co/api/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Whooshly MCP

Dê ao seu assistente de IA um kit de ferramentas de links de campanha. Whooshly expõe um servidor Model Context Protocol hospedado para que Claude, ChatGPT e qualquer cliente MCP possam criar links curtos, QR codes dinâmicos, modelos de UTM, páginas hospedadas de vCard e landing pages com captura de leads – e ler de volta análises reais de cliques/escaneamentos – diretamente de uma conversa.

"Encurte esta URL de lançamento, crie um QR para o panfleto e salve um modelo de UTM para a campanha de social pago" → três ferramentas, uma mensagem, links que você realmente possui.

🔗 Links curtos em whooshly.co com rastreamento de cliques em tempo real
🟧 QR codes dinâmicos retornados como PNGs escaneáveis, direto no chat
🏷️ Modelos de UTM reutilizáveis em várias campanhas
📇 vCard hospedado – cartões de visita digitais
📊 Análises reais – totais exatos de cliques/escaneamentos e séries diárias por link
💸 Pague uma vez. Desbloqueie o kit de ferramentas principal por um preço único – sem assinatura. Veja os preços →

O servidor é hospedado – não há nada para executar para clientes baseados em URL. Este pacote npm é uma pequena ponte stdio para clientes que ainda não falam MCP remoto (ex.: Claude Desktop) e para conveniência do npx.

1. Obtenha um token de agente

Cada ferramenta age na sua conta Whooshly, então você precisa de um token:

Entre em app.whooshly.co
Abra Agentes → Novo token
Copie o token (exibido uma única vez)

Leituras e gravações exigem o desbloqueio único Core; get_billing_status funciona em qualquer conta para que um agente possa verificar antes de agir.

2. Conecte-se

Claude.ai / Claude (web, desktop, mobile) – por URL, sem instalação

Adicione um Conector Personalizado apontando para o servidor remoto. O Claude executa o fluxo OAuth no navegador; aprove e as ferramentas aparecerão.

https://app.whooshly.co/api/mcp

Configurações → Conectores → Adicionar conector personalizado → cole a URL.

ChatGPT – por URL

Adicione um conector / servidor MCP personalizado com a mesma URL:

https://app.whooshly.co/api/mcp

Claude Code – um comando

claude mcp add whooshly --transport http https://app.whooshly.co/api/mcp

Depois, autentique-se com /mcp dentro do Claude Code, ou passe um cabeçalho de token:

claude mcp add whooshly --transport http https://app.whooshly.co/api/mcp \
  --header "Authorization: Bearer $WHOOSHLY_TOKEN"

Claude Desktop (ou qualquer cliente stdio) – via esta ponte

Para clientes que só falam stdio, use este pacote. Adicione-o ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "whooshly": {
      "command": "npx",
      "args": ["-y", "whooshly-mcp"],
      "env": {
        "WHOOSHLY_TOKEN": "your-agent-token"
      }
    }
  }
}

É isso – reinicie o cliente e as ferramentas Whooshly estarão disponíveis.

Ferramentas

Ferramenta	O que faz	Acesso
`get_billing_status`	Verifica se a conta desbloqueou Core / Pro	qualquer
`create_link`	Cria um link curto → id, slug, URL curta	Core
`list_links`	Lista seus links, mais recentes primeiro (paginação por cursor)	Core
`get_link_stats`	Totais exatos de cliques/escaneamentos + série diária de um link	Core
`create_qr`	Cria um QR code dinâmico, retornado como PNG escaneável	Core
`get_qr`	Busca novamente um QR code salvo como PNG	Core
`create_utm`	Salva um modelo de UTM reutilizável	Core
`list_utm`	Lista modelos de UTM salvos	Core
`create_vcard`	Cria uma página hospedada de cartão de visita digital (vCard)	Core
`create_page`	Cria uma landing page no seu subdomínio a partir de blocos de conteúdo	Core
`update_page`	Edita blocos, tema ou slug de uma página – nunca exclui	Core
`list_pages`	Lista suas landing pages com contagens de leads	Core
`get_page`	Conteúdo de uma página, contagem de leads e resumo de entrega via webhook	Core
`search`	Pesquisa seus links por slug/destino (pesquisa aprofundada)	Core
`fetch`	Busca detalhes completos de um link por id (pesquisa aprofundada)	Core

Todas as ferramentas de leitura são anotadas como readOnlyHint; ferramentas de escrita só podem criar ou editar – um agente nunca pode excluir nada, nunca ler os dados pessoais dos seus leads (apenas contagens) e nunca ver ou alterar um webhook de lead. Cada ferramenta opera apenas na sua própria conta (openWorldHint: false).

Exemplos de prompts

Depois de conectado, experimente:

"Encurte https://example.com/2026-summer-launch com o slug summer26 e me mostre o QR code."
"Crie um modelo de UTM chamado paid-social com fonte instagram, mídia cpc, campanha summer-launch."
"Quantos cliques meu link summer26 teve esta semana?"
"Crie um vCard para Jane Doe, Head de Crescimento na Acme, jane@acme.com."

Configuração

Variável de ambiente	Padrão	Finalidade
`WHOOSHLY_TOKEN`	–	Obrigatória para a ponte stdio. Seu token de agente.
`WHOOSHLY_MCP_URL`	`https://app.whooshly.co/api/mcp`	Substitui o endpoint (self-host / staging).

WHOOSHLY_API_TOKEN é aceito como um alias para WHOOSHLY_TOKEN.

Como a ponte funciona

whooshly-mcp lê JSON-RPC delimitado por nova linha do stdin, envia cada mensagem via POST para o servidor hospedado com seu token de portador e escreve a resposta correlacionada no stdout. Ela tem zero dependências npm (apenas recursos nativos do Node 18+), então é pequena e fácil de auditar – a ponte inteira é um único arquivo: bin/whooshly-mcp.mjs.

O trabalho pesado – autenticação, limites de taxa, verificações de permissão, renderização de QR, análises – tudo acontece no lado do servidor em Whooshly. A ponte é um adaptador de transporte, nada mais.