Instant Reply MCP

Conecta agentes de IA a las bandejas de entrada de Instagram, WhatsApp Business y Messenger, sujeto al acceso del espacio de trabajo y a los límites del plan.

GitHubPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://api.instantreply.co/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP Instant Reply para agentes de IA de WhatsApp, Instagram y Messenger

Instant Reply MCP conecta Claude, ChatGPT, Cursor, Claude Code o cualquier agente compatible con MCP a una bandeja de entrada social real. El agente puede vincular un espacio de trabajo en el navegador, responder preguntas con Barq, auditar conversaciones, calificar clientes potenciales, validar plantillas de WhatsApp y operar flujos de trabajo aprobados.

No se requiere clave API para la primera ejecución. Instálalo, dile a tu agente que se conecte a Instant Reply y sigue el enlace de vinculación del navegador.

npm MCP Registry License

Instalación para un agente de IA

Claude Code, Claude Desktop, Cursor, Windsurf o Zed

Agrega este servidor a la configuración MCP del cliente y reinicia o vuelve a conectar:

{
  "mcpServers": {
    "instantreply": {
      "command": "npx",
      "args": ["-y", "@instantreply.co/mcp"]
    }
  }
}

Si ya tienes una clave API de Instant Reply, pásala como variable de entorno:

{
  "mcpServers": {
    "instantreply": {
      "command": "npx",
      "args": ["-y", "@instantreply.co/mcp"],
      "env": { "INSTANTREPLY_API_KEY": "ir_live_..." }
    }
  }
}

ChatGPT y otros clientes MCP remotos

Usa la URL del conector remoto:

https://api.instantreply.co/mcp

El servidor remoto anuncia OAuth 2.1 con PKCE. Un usuario aprueba el acceso en la página de consentimiento de Instant Reply; el cliente no necesita una clave API copiada manualmente.

Dile a tu agente qué hacer

Después de la instalación, envía una solicitud en lenguaje natural como:

Connect InstantReply for my business. Use the developer persona, pair my Instagram and WhatsApp accounts if eligible, and then tell me what is ready and what Meta still requires.

Para una conexión existente:

Audit my conversations from the last 30 days. Identify high-intent leads, explain the signals, draft a compliant follow-up for each segment, estimate WhatsApp costs, and ask me before sending anything.

El agente debe seguir esta secuencia de configuración:

  1. Llama a get_connection_guide antes de recomendar un canal o una ruta de configuración.
  2. Si no hay clave disponible, llama a start_setup con el canal y la persona solicitados: creator, business, developer o agency.
  3. Muestra al usuario la URL de vinculación y el código corto. Nunca pidas al usuario que pegue un secreto en el chat.
  4. Llama a check_setup hasta que se complete la aprobación del navegador y luego vuelve a conectar con la clave almacenada.
  5. Llama a get_developer_capabilities, get_developer_onboarding y get_developer_limits para que la respuesta refleje el espacio de trabajo, el plan, los alcances y los canales conectados.
  6. Valida plantillas, recorridos y elegibilidad de destinatarios antes de cualquier envío. Solicita confirmación explícita antes de una acción destructiva o facturable.
  7. Usa recommend_plan cuando el usuario esté eligiendo un plan; explica la opción más económica y cualquier dependencia de aprobación de Meta.

La clave de vinculación del dispositivo se guarda localmente en ~/.instantreply/config.json. Establece INSTANTREPLY_API_KEY explícitamente para CI, Docker, máquinas compartidas o implementaciones deterministas.

Lo que el agente puede hacer

  • Trabajo de bandeja de entrada: lista e inspecciona conversaciones, mensajes, contactos, canales, análisis y uso.
  • Asistencia de Barq: haz preguntas sobre productos y espacios de trabajo con ask_barq; usa herramientas de aprobación para flujos de trabajo basados en terminal.
  • Inteligencia de clientes potenciales: audita conversaciones recientes, encuentra señales de compra, segmenta contactos, redacta seguimientos personalizados y estima el costo de la campaña.
  • Operaciones de WhatsApp: valida, crea, envía, inspecciona y elimina plantillas; valida recorridos; activa recorridos individuales o por lotes; inspecciona fallos de entrega.
  • Operaciones de desarrollo: inspecciona capacidades, requisitos de incorporación, límites, idoneidad del plan y orientación para la resolución de problemas.
  • Seguridad: las herramientas que cambian el estado están marcadas como destructivas para que un cliente cuidadoso pueda solicitar confirmación primero.

El paquete actualmente expone 34 herramientas, 11 indicaciones reutilizables y recursos de conversación/contacto. El esquema exacto de las herramientas es la fuente de verdad; las descripciones están escritas para que los agentes elijan la herramienta correcta sin adivinar.

Requisitos de canal y Meta

La disponibilidad de Instagram, Messenger y WhatsApp depende del plan del espacio de trabajo, los alcances, los activos conectados y el estado de aprobación de Meta. Las funciones de la API de WhatsApp Business pueden requerir verificación comercial de Meta, una cuenta comercial de WhatsApp conectada, plantillas aprobadas y configuración de facturación de Meta. El agente debe llamar a get_connection_guide e inspeccionar la preparación en lugar de prometer que cada función de WhatsApp está disponible de inmediato.

Instant Reply usa flujos de trabajo oficiales conectados a Meta. No uses el servidor MCP para enviar mensajes no solicitados, eludir el consentimiento o evadir las reglas de plantillas y ventanas de mensajería de Meta.

Planes y acceso

No codifiques los derechos del plan en un indicador de agente. Los precios, la elegibilidad de WhatsApp, los alcances de API, las cuotas y el estado de prueba pueden cambiar. Usa recommend_plan, get_developer_capabilities y get_developer_limits, luego enlaza al usuario con precios actuales.

Cada plan de pago actualmente comienza con una prueba de 10 días sin tarjeta. Las tarifas de conversación de Meta, los requisitos de aprobación y las limitaciones de canales conectados son independientes de los precios de suscripción de Instant Reply.

Variables de entorno

VariablePredeterminadoPropósito
INSTANTREPLY_API_KEYningunoOmite la vinculación del navegador y autentica directamente
INSTANTREPLY_API_URLhttps://api.instantreply.coApunta al cliente a otro entorno

Desarrollo

npm install
npm run build   # compile dist/
npm test        # run the MCP test suite
npm run dev     # watch mode

Antes de publicar, ejecuta npm test, npm run build y valida server.json con las herramientas oficiales del Registro MCP. Mantén package.json, package-lock.json, server.json, el README y la copia MCP del backend incluida en la misma versión de lanzamiento.

Enlaces

Licencia

MIT