Desarrolladores

Crea sobre Kaption con MCP

Kaption expone WhatsApp a apps y agentes de IA a través de un único servidor MCP. Esta página reúne todos los endpoints, documentos y repositorios que necesitas.

Dirección del servidor MCP

https://mcp.kaptionai.com/mcp

El endpoint

Un servidor MCP remoto sobre Streamable HTTP. Habla JSON-RPC 2.0 y funciona con cualquier cliente MCP que admita OAuth. Las herramientas se ejecutan en la extensión o la app de escritorio de Kaption, en la computadora del propio usuario, así que el usuario debe tener Kaption abierto.

Autenticación

OAuth 2.1 con PKCE (S256) y registro dinámico de clientes. Hay un único scope, kaption:access. Los usuarios inician sesión con su número de teléfono y un código que reciben por WhatsApp, y luego eligen cuánto dura la conexión. Los tokens de acceso caducan al cabo de una hora. Las llamadas sin token reciben HTTP 401 con un encabezado WWW-Authenticate que apunta a los metadatos del recurso protegido.

Referencia

Endpoints y documentos

Herramientas

Herramientas

El servidor en la nube expone estas herramientas. Ninguna envía un mensaje al instante: la IA puede dejar un borrador o programar un mensaje para una persona. Los chats que el usuario bloqueó en WhatsApp nunca son visibles.

  • query
  • list_contacts
  • get_contact
  • get_contact_groups
  • list_groups
  • get_group
  • export_contacts
  • download_media
  • get_analytics
  • summarize_conversation
  • manage_chat
  • manage_reminders
  • manage_lists
  • manage_labels
  • manage_notes
  • manage_scheduled_messages
  • call_recordings
Conviene saber

Límites

  • Las herramientas solo funcionan mientras el usuario tiene Kaption abierto: WhatsApp Web con la extensión, o la app de escritorio.
  • El acceso tiene un límite de frecuencia. Los mensajes masivos o no solicitados van en contra de los términos.
  • Un mensaje programado va dirigido a una persona y tiene como máximo 800 caracteres.
Desarrolladores

Seguridad

Informa de vulnerabilidades en privado a security@kaptionai.com. Por favor, no abras una issue pública.

Preguntas frecuentes

¿Hay una API REST?

La interfaz pública de Kaption es el servidor MCP. El archivo OpenAPI describe ese endpoint HTTP para que las herramientas que leen OpenAPI puedan encontrarlo; las operaciones en sí son herramientas MCP que se llaman por JSON-RPC.

¿Puedo listar las herramientas sin iniciar sesión?

No. Cada llamada, incluidas initialize y tools/list, necesita un token. Los nombres de las herramientas aparecen en esta página y en la tarjeta del servidor.

¿Qué clientes funcionan?

Claude, ChatGPT, Cursor y otros clientes que admiten servidores MCP remotos con OAuth. Los clientes que ejecutan servidores locales pueden usar el paquete npm.

Transcribe un audio ahora