Hooka MCP server

Servidor MCP para Hooka — controla el outreach por DM en TikTok desde tu LLM (Claude Desktop, Cursor, VS Code, ChatGPT). Es un wrapper fino sobre la API pública v1 de Hooka: cada tool se traduce a una llamada a api.hooka.to/v1 con tu API key. No reimplementa lógica ni almacena credenciales.

1. Consigue una API key

Crea/copia una API key en el panel de developers del dashboard de Hooka, o vía POST /v1/api_keys. Empieza por hk_live_… (producción) o hk_test_….

2. Conéctalo a tu cliente

Publicado en npm como hooka-mcp — no hay que clonar ni compilar nada: npx lo descarga y arranca solo.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "hooka": {
      "command": "npx",
      "args": ["-y", "hooka-mcp"],
      "env": { "HOOKA_API_KEY": "hk_live_xxxxx" }
    }
  }
}

Cursor — Settings → MCP → Add, mismo command/args/env. (HOOKA_API_BASE opcional, por defecto https://api.hooka.to.)

Desde el código (desarrollo)

cd apps/mcp && npm install && npm run build
# luego command: "node", args: ["<ruta>/apps/mcp/dist/stdio.js"]

Tools

• Senders: list_senders, get_sender, create_sender (devuelve QR a escanear), refresh_sender_connection, delete_sender.
• Campañas: list_campaigns, get_campaign, create_campaign, add_targets, list_targets, start_campaign, pause_campaign, resume_campaign.
• Inbox: list_conversations, get_messages, send_reply.
• Supresión: list_suppressions, add_suppressions, remove_suppression.
• Otros: list_events, list_webhook_endpoints, create_webhook_endpoint, get_workspace (whoami).

Prompts: launch_campaign, triage_inbox, connect_account. Resources: hooka://event-types, hooka://api-reference.

⚠️ Seguridad

start_campaign, resume_campaign y send_reply envían DMs reales a personas en TikTok y consumen cupo de plan (acciones irreversibles). Están marcadas como destructiveHint para que el cliente pida confirmación humana — revisa siempre antes de confirmar. La conexión de cuentas es por QR (el agente muestra el QR; tú lo escaneas con la app de TikTok).

Estado

MVP — transporte stdio (local). El transporte remoto (Streamable HTTP en mcp.hooka.to + OAuth) y la publicación en el MCP Registry oficial son Fase 3 (ver docs/GROWTH-MCP-GEO-PLAN.md).