waitlister-mcp

Servidor MCP de Waitlister — @waitlister/mcp

Un servidor MCP (Model Context Protocol) que conecta asistentes de IA como Claude, Cursor y Windsurf a la API de Waitlister. Crea listas de espera y gestiona suscriptores mediante lenguaje natural.

Este es el paquete oficial, que sustituye a waitlister-mcp (1.0.x). Las configuraciones existentes de waitlister-mcp siguen funcionando, pero las nuevas instalaciones deben usar @waitlister/mcp: añade soporte para claves de cuenta, creación de listas de espera, estadísticas y eliminación, y funciona en todos los planes.

¿Qué Puedes Hacer Con Esto?

Una vez conectado, puedes pedirle a tu asistente de IA cosas como:

• "¿Mi clave de Waitlister funciona y puedo crear otra lista de espera?"
• "Crea una lista de espera para mi nuevo producto y dame la URL del formulario de registro"
• "Lanza mi lista de espera con una página de aterrizaje — tema oscuro — y publícala"
• "Cambia el titular de la página a 'Únete a más de 500 personas'"
• "Genera una página de aterrizaje: audaz, estética de herramientas para desarrolladores" (constructor de IA, 1 crédito)
• "Añade test@gmail.com a mi lista de espera"
• "¿Cuántos suscriptores tengo?"
• "Busca al suscriptor john@acme.com"
• "Actualiza los puntos de John a 500"
• "Muéstrame los 10 mejores suscriptores por número de referidos"

Herramientas

Páginas con IA frente a páginas estándar: después de generate_landing_page, el texto de la página vive dentro de la página generada — update_landing_page rechaza los campos de texto/estructura con orientación para usar generate_landing_page + is_edit en su lugar (theme y seo aún se actualizan normalmente). Las páginas generadas se guardan como borradores, y la conversación de IA se traslada al chat de IA del panel.

Requisitos Previos

• Node.js 18+
• Una cuenta de Waitlister — el plan gratuito funciona
• Una clave API de cuenta (recomendada), o una clave API por lista de espera (plan Growth+)

Cómo Obtener Tu Clave

Clave de cuenta (recomendada — funciona en todos los planes, cubre todas tus listas de espera):

1. Inicia sesión en Waitlister
2. Ve a Configuración → Claves API → crea una clave (wl_acct_…)

Clave por lista de espera (heredada, plan Growth+): lista de espera → Integraciones → Acceso API. También necesitarás la clave de lista de espera desde la configuración de la lista.

Instalación

Usando npx (recomendado)

No se necesita instalación — solo configura tu cliente MCP:

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

Con una clave de cuenta puedes añadir opcionalmente "WAITLISTER_WAITLIST_KEY": "your-waitlist-key" para establecer una lista de espera predeterminada — de lo contrario, cada llamada de herramienta puede apuntar a cualquier lista de espera que poseas mediante su parámetro waitlist_key (pide al asistente que ejecute list_waitlists primero).

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

Instalación global

npm install -g @waitlister/mcp

Luego configura con "command": "waitlister-mcp" y el mismo env.

Configuración por Cliente

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows) con el JSON anterior.

Cursor

Ve a Configuración → MCP → Añadir nuevo servidor MCP y usa la misma configuración.

Claude Code

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

Variables de Entorno

Notas

• Unicidad: los nombres de listas de espera y los slugs de URL son únicos en todo Waitlister. create_waitlist rechaza un nombre/slug ya ocupado con un mensaje que te indica qué cambiar.
• Contadores asíncronos: los registros y eliminaciones actualizan los contadores de get_stats y las posiciones en la cola en unos segundos, no instantáneamente.
• Restricciones por plan: crear listas de espera, añadir suscriptores y estadísticas funcionan en todos los planes (límites de velocidad más bajos en planes gratuitos). Leer/actualizar/eliminar datos de suscriptores requiere Growth o superior — consulta los límites de velocidad.
• Construido sobre el SDK oficial waitlister (errores tipados, reintentos automáticos con retroceso).

Desarrollo

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

Prueba con el Inspector MCP:

WAITLISTER_ACCOUNT_KEY=wl_acct_your-key npm run inspect

Enlaces

• Waitlister — crea listas de espera para los lanzamientos de tus productos
• Documentación de la API
• Protocolo MCP

Privacidad

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

Qué recopila esta extensión. Nada por sí sola. Se ejecuta localmente en tu máquina y no tiene base de datos, ni telemetría, ni análisis. Solo almacena la credencial que introduces — tu clave API de cuenta de Waitlister — que Claude Desktop guarda en el almacenamiento seguro de credenciales de tu sistema operativo.

Qué envía y adónde. La extensión envía las solicitudes de API que le pides que haga, a través de HTTPS, a la API de Waitlister en https://waitlister.me/api/v1, autenticadas con tu clave. Eso significa los argumentos que tú (o Claude, por tu instrucción) pasas a una herramienta: por ejemplo, un nombre de lista de espera, texto de página de aterrizaje o la dirección de correo de un suscriptor cuando añades uno. No se envía nada a ningún otro lugar. No hay análisis de terceros, rastreadores de errores ni servicios intermediarios en la ruta.

Cómo se identifican las solicitudes. Como cualquier SDK, esas solicitudes llevan encabezados de identificación para que Waitlister pueda distinguir el tráfico de agentes del tráfico normal de API y darle soporte adecuado: el nombre y versión de este paquete (waitlister-mcp/1.4.0), la versión del SDK, la versión de Node, y el nombre y versión que tu host MCP anuncia en el protocolo de enlace (por ejemplo, claude-ai/0.1.0). Sin texto de mensajes, sin rutas de archivos, sin identificadores de máquina o usuario. No se envía nada extra — estos viajan junto con las solicitudes que ya hiciste.

Cómo se usan y retienen esos datos. Los datos que llegan a la API de Waitlister se manejan según la política de privacidad de Waitlister enlazada arriba — los mismos términos que se aplican cuando usas el panel web. Los registros de listas de espera y suscriptores persisten en tu cuenta de Waitlister hasta que los elimines, desde el panel o con la herramienta delete_subscriber. La extensión en sí no retiene nada después de que una solicitud se completa.

Compartición con terceros. Waitlister no vende tus datos. Los diseños de páginas de aterrizaje solicitados a través de generate_landing_page son producidos por el constructor de páginas con IA de Waitlister, que pasa tu mensaje de diseño a un proveedor de modelos de terceros; consulta la política de privacidad para la lista actual de subprocesadores.

Tus controles. Revoca la clave API en cualquier momento en Waitlister bajo Configuración → Claves API, lo que detiene inmediatamente que esta extensión acceda a tu cuenta. Desinstalar la extensión elimina la clave almacenada de tu máquina. Las solicitudes de eliminación de cuenta y datos siguen el proceso de la política de privacidad.

Contacto. https://waitlister.me/contact

Licencia

MIT — consulta LICENCIA.