Whooshly

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

Whooshly MCP

Dale a tu asistente de IA un kit de herramientas para enlaces de campaña. Whooshly expone un servidor alojado de Model Context Protocol para que Claude, ChatGPT y cualquier cliente MCP puedan crear enlaces cortos, códigos QR dinámicos, plantillas UTM, páginas vCard alojadas y páginas de aterrizaje con captura de clientes potenciales – y leer estadísticas reales de clics/escaneos – directamente desde una conversación.

"Acorta esta URL de lanzamiento, haz un QR para el folleto y guarda una plantilla UTM para la campaña de social de pago" → tres herramientas, un mensaje, enlaces que realmente te pertenecen.

• 🔗 Enlaces cortos en whooshly.co con seguimiento de clics en vivo
• 🟧 Códigos QR dinámicos devueltos como PNG escaneables, directamente en el chat
• 🏷️ Plantillas UTM reutilizables en todas tus campañas
• 📇 vCard alojada tarjetas de presentación digitales
• 📊 Estadísticas reales – totales exactos de clics/escaneos y series diarias por enlace
• 💸 Paga una vez. Desbloquea el kit de herramientas principal por un precio único – sin suscripción. Ver precios →

El servidor está alojado – no hay nada que ejecutar para clientes basados en URL. Este paquete npm es un pequeño puente stdio para clientes que aún no hablan MCP remoto (por ejemplo, Claude Desktop) y para conveniencia de npx.

---

1. Obtén un token de agente

Cada herramienta actúa sobre tu cuenta de Whooshly, así que necesitas un token:

1. Inicia sesión en app.whooshly.co
2. Abre Agentes → Nuevo token
3. Copia el token (se muestra una sola vez)

Las lecturas y escrituras requieren el desbloqueo Core de pago único; get_billing_status funciona en cualquier cuenta para que un agente pueda verificar antes de actuar.

---

2. Conectar

Claude.ai / Claude (web, escritorio, móvil) – por URL, sin instalación

Añade un Conector personalizado apuntando al servidor remoto. Claude ejecuta el flujo OAuth en el navegador; aprueba y las herramientas aparecerán.

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

Configuración → Conectores → Añadir conector personalizado → pega la URL.

ChatGPT – por URL

Añade un conector / servidor MCP personalizado con la misma URL:

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

Claude Code – un comando

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

Luego autentícate con /mcp dentro de Claude Code, o pasa un encabezado de token:

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

Claude Desktop (o cualquier cliente stdio) – a través de este puente

Para clientes que solo hablan stdio, usa este paquete. Añádelo a tu claude_desktop_config.json:

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

Eso es todo – reinicia el cliente y las herramientas de Whooshly estarán disponibles.

---

Herramientas

Herramienta	Qué hace	Acceso
get_billing_status	Verifica si la cuenta tiene desbloqueado Core / Pro	cualquiera
create_link	Crea un enlace corto → id, slug, URL corta	Core
list_links	Lista tus enlaces, más recientes primero (paginado por cursor)	Core
get_link_stats	Totales exactos de clics/escaneos + series diarias para un enlace	Core
create_qr	Crea un código QR dinámico, devuelto como PNG escaneable	Core
get_qr	Vuelve a obtener un código QR guardado como PNG	Core
create_utm	Guarda una plantilla UTM reutilizable	Core
list_utm	Lista plantillas UTM guardadas	Core
create_vcard	Crea una tarjeta de presentación digital alojada (vCard)	Core
create_page	Crea una página de aterrizaje en tu subdominio a partir de bloques de contenido	Core
update_page	Edita los bloques, tema o slug de una página – nunca elimina	Core
list_pages	Lista tus páginas de aterrizaje con conteos de clientes potenciales	Core
get_page	Contenido de una página, conteo de clientes potenciales y resumen de entrega de webhook	Core
search	Busca tus enlaces por slug/destino (investigación profunda)	Core
fetch	Obtén detalles completos de un enlace por id (investigación profunda)	Core

Todas las herramientas de lectura están anotadas como readOnlyHint; las herramientas de escritura solo pueden crear o editar – un agente nunca puede eliminar nada, nunca leer los datos personales de tus clientes potenciales (solo conteos), y nunca ver o cambiar un webhook de clientes potenciales. Cada herramienta opera solo en tu propia cuenta (openWorldHint: false).

---

Ejemplos de prompts

Una vez conectado, prueba:

• "Acorta https://example.com/2026-summer-launch con el slug summer26 y muéstrame el código QR."
• "Crea una plantilla UTM llamada paid-social con fuente instagram, medio cpc, campaña summer-launch."
• "¿Cuántos clics recibió mi enlace summer26 esta semana?"
• "Haz una vCard para Jane Doe, Head of Growth en Acme, jane@acme.com."

---

Configuración

Variable de entorno	Predeterminado	Propósito
WHOOSHLY_TOKEN	–	Requerido para el puente stdio. Tu token de agente.
WHOOSHLY_MCP_URL	https://app.whooshly.co/api/mcp	Sobrescribe el endpoint (autoalojado / staging).

WHOOSHLY_API_TOKEN se acepta como alias de WHOOSHLY_TOKEN.

---

Cómo funciona el puente

whooshly-mcp lee JSON-RPC delimitado por líneas desde stdin, envía cada mensaje al servidor alojado con tu token de portador y escribe la respuesta correlacionada en stdout. Tiene cero dependencias npm (solo funciones integradas de Node 18+), por lo que es pequeño y fácil de auditar – todo el puente es un solo archivo: bin/whooshly-mcp.mjs.

El trabajo pesado – autenticación, límites de velocidad, verificaciones de derechos, renderizado de QR, estadísticas – todo ocurre en el servidor en Whooshly. El puente es un adaptador de transporte, nada más.

---

Enlaces

• Sitio web: https://whooshly.co
• Servidor MCP / guía de conexión: https://whooshly.co/mcp
• App / panel: https://app.whooshly.co
• Endpoint MCP: https://app.whooshly.co/api/mcp

Licencia

MIT © Whooshly