Instant Reply MCP Server

Conecta asistentes de IA con conversaciones, contactos, plantillas de WhatsApp, recorridos y diagnósticos de entrega de Instagram, WhatsApp y Messenger a través de Instant Reply.

Ver en instantreply.coPrueba este MCPPatrocinado

Documentación

Servidor MCP para tu bandeja de entrada de yourAI.

Claude Code, Cursor, Windsurf, Zed y Claude Desktop obtienen acceso directo a tus DMs de Instagram, chats de WhatsApp y bandeja de entrada de Messenger: leer conversaciones, redactar respuestas, gestionar el ciclo de vida de plantillas y depurar entregas de journeys a través de 34 herramientas, 11 prompts y dos recursos. Ejecuta un solo comando npx y pide a tu agente que se conecte: se empareja solo mediante un enlace de configuración firmado, la misma concesión de autorización de dispositivo gh auth login que utiliza, sin necesidad de visitar el panel ni copiar claves API.

config de mcp · elige uno

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

¿Prefieres no instalar? Claude.ai: Configuración → Conectores → Añadir conector personalizado → pega https://api.instantreply.co/mcp → inicia sesión. ChatGPT: añádelo como conector con el modo desarrollador activado. La prueba gratuita da acceso completo. ¿Aún no tienes clave? Añade el bloque sin clave, reinicia el cliente y pide que se conecte a InstantReply. Te dará un código y un enlace. ¿Ya estás emparejado? Usa los comandos de barra como /audit_template_cost o /utility_rewrite_loop.

Instalar · sin clave

Cualquier agente que pueda ejecutar npx puede hacer esto.

Sin visitar el panel, sin copiar claves. El servidor solicita un código de dispositivo de la misma manera que gh auth login o una app de smart-TV (RFC 8628, concesión de autorización de dispositivo), te muestra un enlace y recoge la clave en el momento en que la apruebas en un navegador.

01
Añade el bloque
Colócalo en la config de MCP de tu cliente. Sin clave, sin instalación global.
```
"instantreply": {
  "command": "npx",
  "args": ["-y", "@instantreply.co/mcp"]
}
```
Copiar

Pide que se conecte

Tu agente llama a start_setup y recibe un código y un enlace. Abre el enlace, regístrate o inicia sesión (aplica captcha y consentimiento, igual que en el sitio) y aprueba.

{
  "instructions": "Tell the user to open this link and approve: https://www.instantreply.co/pair/ABCD-2345",
  "code": "ABCD-2345",
  "link": "https://www.instantreply.co/pair/ABCD-2345",
  "expires_in_seconds": 600,
  "device_code": "kx9F2q... (opaque, single use)",
  "poll_interval_seconds": 5,
  "next_step": "Call check_setup with this device_code once approved."
}

Copiar

03
Reconecta y luego pregunta
check_setup confirma la aprobación y guarda la clave en ~/.instantreply/config.json. Reinicia el cliente una vez; cada ejecución de npx posterior omitirá la configuración.
```
"Find unanswered DMs from today,
 draft a reply for each,
 send only after I confirm."
```
Copiar

El enlace de configuración caduca en 10 minutos y el código es de un solo uso. ¿Prefieres gestionar una clave tú mismo, para CI, Docker o una máquina compartida? Genera una desde Configuración → Claves API y establece INSTANTREPLY_API_KEY en su lugar. Lee la especificación en RFC 8628.

Herramientas · 34

Anotadas para agentes seguros.

Cada herramienta anuncia readOnlyHint y destructiveHint. Los agentes compatibles preguntan antes de escribir.

get_connection_guide cómo conectar cada canal, sin necesidad de clavelectura
list_conversations listar conversaciones de la bandeja de entradalectura
get_conversation obtener una conversación con el último mensajelectura
list_messages paginar mensajes en una conversaciónlectura
send_message entregar una respuesta salienteescritura
assign_conversation derivar a un compañeroescritura
close_conversation marcar como resueltodestructiva
list_contacts obtener contactos y etapa del leadlectura
get_contact obtener un contactoelectura
update_contact actualizar nombre, email, etapa del leadescritura
list_channels listar plataformas conectadaslectura
set_channel_ai_replies activar o desactivar auto-respuestas de IA en DMs para un canalescritura
list_comments listar comentarios de publicaciones de Instagram/Facebooklectura
get_comment obtener un comentario rastreadoelectura
reply_to_comment publicar una respuesta pública bajo un comentarioescritura
set_comment_ai_replies activar o desactivar auto-respuestas de IA en comentarios a nivel de organizaciónescritura
get_analytics_summary estadísticas del panel por rango de fechaslectura
get_usage uso de API y margen del planlectura
list_templates estados de plantillas, categorías, componenteslectura
get_template obtener una plantilla por IDlectura
validate_template verificar ajuste de categoría y coaching UTILITYlectura
validate_template_draft prevalidar nuevas ideas de plantillaslectura
submit_template enviar una plantilla a Meta para aprobaciónescritura
submit_stored_template enviar un borrador existenteescritura
delete_template eliminar plantillas obsoletas de Metadestructiva
send_whatsapp_template activar un envío de WhatsApp aprobadoescritura
trigger_journey inscribir un teléfono en un journeyescritura
trigger_journey_batch inscripción masiva de hasta 100 destinatariosescritura
validate_journey_trigger prueba en seco de teléfono, journey, metadatoslectura
check_journey_status consultar estado de entrega de inscripciónlectura
list_journey_history historial reciente de inscripciones y envíoslectura
explain_delivery_failure explicación en lenguaje sencillo de un envío fallidolectura
get_developer_onboarding lista de verificación de integración: qué está hecho, qué siguelectura
get_developer_capabilities mapa de alcance de la clave API actuallectura
get_developer_limits límites de tasa y margen de cuotalectura
recommend_plan ajuste del plan según canales, volumen y tamaño del equipoelectura
ask_barq delegar una tarea a Barq, el agente de la aplicacionescritura
list_pending_approvals acciones que Barq espera que apruebeslectura
decide_approval aprobar o rechazar una acción pendiente de Barqescritura

Prompts · 11

Comandos de barra para el trabajo que ya haces.

Los clientes MCP exponen estos prompts como comandos reutilizables. Combínalos con los paquetes de habilidades descargables de InstantReply para que el agente conozca el bucle de aprobación, las reglas de reescritura Utility, las jugadas de crecimiento del propietario, los manuales de integración y las salvaguardas de acciones destructivas.

/draft_reply

Redacta una respuesta con la voz del equipo a partir de las últimas tres respuestas.

/summarize_conversation

Tres frases. Objetivo del cliente, estado actual, qué lo desbloquea.

/find_urgent_unanswered

Clasifica las conversaciones abiertas por probabilidad de abandono.

/weekly_inbox_digest

Logros, regresiones, deltas de tiempo de respuesta. Listo para pegar.

/suggest_macros

Detecta respuestas repetidas que valga la pena convertir en respuestas rápidas.

/escalation_note

Nota interna de traspaso. Riesgo primero, contexto después.

/audit_template_cost

Revisa cada plantilla pendiente: marca frases MARKETING, estima ahorros si se reformulan como UTILITY.

/utility_rewrite_loop

Reescribe, envía, consulta e informa sobre plantillas que califican legítimamente como UTILITY.

/journey_recommendation

Convierte eventos de producto en nombres de disparadores, variables, journeys y verificaciones de entrega.

/image_to_whatsapp_template_brief

Usa una imagen o recurso de producto para proponer briefs de plantillas de WhatsApp compatibles.

/debug_last_failure

Explica el último fallo de entrega en lenguaje sencillo y sugiere el siguiente paso.

Habilidades del agente

Descarga los manuales operativos.

Instala el servidor MCP para herramientas en vivo y luego añade estas habilidades para enseñar al agente a ejecutar los flujos de trabajo del negocio: auditorías de crecimiento, políticas de WhatsApp, creatividad de plantillas e integración para desarrolladores.

Operador de WhatsAppEjecuta aprobación de plantillas, reescrituras Utility, consultas, limpieza, envíos y depuración de entregas.Descargar →
Crecimiento del propietario del negocioEncuentra leads perdidos, ausencias, fugas de soporte, bucles de reseñas y la siguiente automatización útil.Descargar →
Mejores prácticas de WhatsAppRevisa plantillas, opt-ins, journeys, categorías, riesgos de calidad y bucles de aprobación.Descargar →
Integración de APIGuía a los desarrolladores a través de alcances, webhooks, reintentos, idempotencia, journeys y seguimiento de entregas.Descargar →
Estudio creativoConvierte ofertas, eventos de cliente e imágenes en briefs de plantillas de WhatsApp seguros por categoría.Descargar →

Clientes

Coloca el bloque. Elige tu editor.

Claude Code ~/.claude/mcp.json Guía de configuración →
Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json Guía de configuración →
Cursor ~/.cursor/mcp_servers.json Guía de configuración →
Windsurf ~/.codeium/windsurf/mcp_config.json Guía de configuración →
Zed Zed → Settings → Assistant → Context Servers Guía de configuración →
Acciones de ChatGPT Custom GPT → Actions → Import OpenAPI Guía de configuración →
Claude.ai (remoto) Settings → Connectors → Add custom connector → https://api.instantreply.co/mcp
Cualquier host MCP stdio transport · npx -y @instantreply.co/mcp

Flujos de WhatsApp · conversacionales

Pregunta en lugar de hacer clic.

El servidor MCP expone las mismas APIs de ciclo de vida de plantillas y depuración de entregas como herramientas conversacionales. Puedes gestionar el flujo completo (validar, reformular, enviar, depurar) sin abrir Meta Business Manager ni leer códigos de error.

Coaching UTILITY de plantillas

Pregunta: "Revisa mis plantillas pendientes y dime cuáles califican como UTILITY." La herramienta validate_template devuelve frases de marketing marcadas y reescrituras seguras por categoría. Las plantillas Utility suelen ser más baratas que las Marketing cuando el mensaje es realmente transaccional.

Enviar a Meta

Una vez que el coaching esté claro, pregunta: "Corrige las frases marcadas y envía." La herramienta submit_template envía la plantilla corregida a Meta y devuelve el estado de aprobación.

Explicar un fallo de entrega

Pregunta: "¿Por qué falló el último mensaje de campaña para el contacto X?" La herramienta explain_delivery_failure devuelve qué ocurrió, si la culpa es nuestra o de Meta, y si un reintento es seguro.

Lista de verificación de incorporación para desarrolladores

Pregunta: "¿Qué pasos de integración siguen incompletos?" La herramienta get_developer_onboarding devuelve una lista de verificación de qué pasos están hechos y cuáles no: conectar canal, validar primera plantilla, registrar webhook.

Permisos · alcances

La clave controla lo que el agente puede hacer.

Cada herramienta MCP se asigna a un alcance de clave API. Las herramientas de lectura requieren conversations:read. Las herramientas de escritura requieren messages:send. Las herramientas de plantillas requieren templates:write para validar y templates:submit para enviar.

Usa una clave de solo lectura para sesiones de agente que solo deban observar. Usa una clave de alcance completo para agentes que envíen mensajes o envíen plantillas. Ambos tipos de clave funcionan con la misma configuración del servidor: solo cambia el valor de la clave.

El emparejamiento sin clave otorga un conjunto de alcances inicial: conversaciones (lectura y escritura), contactos (lectura y escritura), envío de mensajes y analíticas. El envío de plantillas necesita templates:write y templates:submit, que no están en ese conjunto inicial: genera una clave dedicada desde el panel para ese flujo.

Cada herramienta anuncia readOnlyHint y destructiveHint para que los clientes MCP compatibles pidan confirmación antes de cualquier acción de escritura.

# Read-only agent: observe and debug
IR_API_KEY=ir_live_...  # scopes: conversations:read

# Full agent: validate, submit, send
IR_API_KEY=ir_live_...  # scopes: conversations:read,
                        #   messages:send,
                        #   templates:write,
                        #   templates:submit

Preguntas frecuentes

Lo que realmente preguntan agentes y desarrolladores.

¿Necesito una clave API antes de poder usar este servidor MCP?

No. Añade el bloque de configuración sin variables de entorno y pide a tu agente que se conecte. Llama a start_setup, que devuelve un código corto y un enlace usando el mismo flujo de concesión de autorización de dispositivo OAuth 2.0 que usa gh auth login (RFC 8628). Aprueba en un navegador y luego check_setup recoge la clave automáticamente y la guarda en ~/.instantreply/config.json. Reinicia la conexión MCP una vez y se carga el conjunto completo de herramientas.

¿Cuántas herramientas, prompts y recursos expone el servidor?

34 herramientas una vez emparejado: 33 herramientas autenticadas que cubren conversaciones, contactos, plantillas, journeys y depuración de entregas, más get_connection_guide, que no necesita clave y está siempre activa. También hay 11 prompts (comandos de barra como /audit_template_cost) y 2 tipos de recursos: conversación y contacto. Cada herramienta declara readOnlyHint y destructiveHint para que un cliente MCP compatible pueda preguntar antes de escribir o eliminar cualquier cosa.

¿Qué planes incluyen el servidor MCP?

El plan gratuito obtiene herramientas MCP de solo lectura. Creator no incluye MCP. Cada plan Developer (Dev Hobby, Dev Pro, Dev Scale) y cada plan Business de pago (Starter, Growth, Pro) incluye el conjunto completo de herramientas, con enrutamiento MCP prioritario en Dev Scale y Pro.

¿Cuál es la diferencia entre una clave de solo lectura y una de alcance completo?

Una clave de solo lectura (conversations:read) puede listar y leer conversaciones, contactos, analíticas, plantillas y uso: nada de lo que hace cambia datos. Enviar un mensaje requiere messages:send. Validar y enviar plantillas requiere templates:write y templates:submit. El emparejamiento sin clave otorga un conjunto de alcances inicial (conversaciones, contactos, envío de mensajes, analíticas); el envío de plantillas necesita una clave dedicada generada desde el panel.

¿Funciona con ChatGPT?

Sí, de dos maneras. Añade la URL del conector remoto (https://api.instantreply.co/mcp) en los conectores de ChatGPT con el modo desarrollador activado e inicia sesión, o importa la especificación OpenAPI como una acción de Custom GPT mediante REST API Actions. El servidor stdio local es para clientes de terminal como Claude Code, Cursor, Windsurf y Zed.

¿Puedo conectarme sin instalar nada? Sí. En Claude.ai ve a Configuración → Conectores → Añadir conector personalizado, pega https://api.instantreply.co/mcp, e inicia sesión en InstantReply. Aprueba la pantalla de consentimiento, que muestra quién está preguntando y te permite revocar el acceso en cualquier momento en Configuración → Claves de API. ChatGPT funciona de la misma manera a través de conectores en modo desarrollador. En Cursor o Claude Code ejecuta: claude mcp add --transport http instantreply https://api.instantreply.co/mcp. Los nuevos espacios de trabajo comienzan con una prueba gratuita con acceso completo, sin necesidad de tarjeta.

¿El agente enviará un mensaje o eliminará algo sin preguntarme primero?

Cada herramienta de escritura y destructiva — send_message, submit_template, delete_template y el resto — anuncia destructiveHint: true en sus metadatos de herramienta MCP. Un cliente compatible solicita confirmación antes de ejecutarla. El servidor ejecuta la llamada cuando el cliente la envía; no envía automáticamente nada en silencio por su cuenta.