MCP — interfaz programática

Además de REST, GetMyBot ofrece una interfaz MCP (Model Context Protocol) diseñada para agentes e IA que invocan herramientas en lugar de llamar endpoints manualmente. REST sigue siendo la interfaz principal; MCP es una alternativa cómoda para escenarios agénticos. Los nombres de herramientas, recursos y prompts que aparecen a continuación coinciden con lo que publica el servidor.

Dirección y autorización

MCP está disponible en el endpoint /mcp (transporte Streamable HTTP, método POST). La autorización usa el mismo token personal que para REST: cabecera Authorization: Bearer mbp_…. No necesitas crear tokens adicionales: un único PAT funciona tanto para REST como para MCP. Cada herramienta requiere el mismo scope que el endpoint REST correspondiente; un token con scope * tiene acceso completo. Si el scope es insuficiente, la llamada se rechaza (fail-closed), igual que en REST.

Conexión con Claude Code / Cursor

Añade GetMyBot como servidor MCP remoto. Ejemplo de configuración (mcpServers) — sustituye tu dominio y token:

{
  "mcpServers": {
    "mybot": {
      "url": "https://tu-dominio/mcp",
      "headers": {
        "Authorization": "Bearer mbp_TU_TOKEN"
      }
    }
  }
}

Claude Code: coloca este bloque en .mcp.json del proyecto o añade el servidor con el comando claude mcp add. Cursor: añade el mismo bloque en los ajustes MCP (Settings → MCP → Add server). Tras conectar, el cliente recibirá automáticamente la lista de herramientas, recursos y prompts.

Herramientas por dominio

El servidor publica 100 herramientas — cobertura completa del REST accesible por PAT. A continuación: la herramienta y el scope requerido. Nombres en formato verbo_sustantivo (snake_case).

Bots (bots)

  • list_bots — bots:read
  • get_bot — bots:read
  • validate_bot_token — bots:write
  • connect_bot — bots:write
  • update_bot — bots:write
  • delete_bot — bots:write
  • sync_bot — bots:write
  • change_bot_token — bots:write
  • transfer_bot — bots:write
  • get_bot_settings — settings:read
  • update_bot_settings — settings:write

Canales y plantillas de WhatsApp (bots)

El soporte multicanal (Telegram + WhatsApp + VK) también está disponible por MCP. Los canales y las plantillas están protegidos por los scopes compartidos bots:read / bots:write — no hay un scope de canal aparte.

  • list_channels — bots:read — listar los canales de un bot (plataforma tg/wa/vk, external_id, name, enabled, callback_url).
  • connect_channel — bots:write — conectar un canal de WhatsApp o VK (platform + credenciales).
  • delete_channel — bots:write — desconectar un canal.
  • list_wa_templates — bots:read — el catálogo de plantillas de WhatsApp del canal (name, language, status, category, body).
  • sync_wa_templates — bots:write — resincronizar el catálogo de plantillas desde Meta.
  • create_wa_template — bots:write — crear una plantilla de WhatsApp y enviarla a Meta para revisión.
  • update_wa_template — bots:write — editar una plantilla (en estado APPROVED/REJECTED/PAUSED).
  • delete_wa_template — bots:write — eliminar una plantilla.

Los canales de Telegram se conectan mediante connect_bot, no mediante connect_channel — este último solo maneja wa y vk. Categorías de plantillas: MARKETING / UTILITY / AUTHENTICATION. create_wa_template envía el borrador a Meta para revisión de inmediato; el estado cambia de forma asíncrona — vuelve a leerlo con list_wa_templates (actualizando el catálogo con sync_wa_templates si hace falta).

Subir un encabezado multimedia de plantilla (imagen/vídeo/documento) por MCP aún no está soportado — usa la interfaz web o REST POST /api/bots/{botID}/channels/{channelID}/templates/media.

Reacciones (reactions)

  • list_reactions — reactions:read
  • get_reaction — reactions:read
  • create_reaction — reactions:write
  • update_reaction — reactions:write
  • delete_reaction — reactions:write
  • import_reactions — reactions:write
  • test_formula — reactions:write
  • reorder_reaction — reactions:write
  • get_reaction_links — reactions:read
  • list_reaction_folders — reactions:read
  • create_reaction_folder — reactions:write
  • update_reaction_folder — reactions:write
  • delete_reaction_folder — reactions:write
  • add_reaction_to_folder — reactions:write
  • remove_reaction_from_folder — reactions:write
  • add_reactions_to_folder — reactions:write

La importación mediante import_reactions crea reacciones pero omite los medios: en el contexto MCP no existe verificación premium ni receptor Telegram para archivos. Si el bundle SamBot incluye imágenes, vídeos o documentos, usa la importación REST completa (POST /api/bots/{botID}/reactions/import), que transfiere también los medios.

Difusiones (broadcasts)

  • start_broadcast — broadcasts:write (opt. paid, opt. segmento por etiquetas)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

Etiquetas (labels)

  • list_labels — labels:read
  • create_label — labels:write
  • delete_label — labels:write
  • set_label_favorite — labels:write

Colecciones y registros (collections)

  • list_collections — collections:read
  • create_collection — collections:write
  • update_collection — collections:write
  • delete_collection — collections:write
  • list_records — collections:read
  • create_record — collections:write
  • update_record — collections:write
  • delete_record — collections:write

Escenarios (flows)

  • list_flows — flows:read
  • get_flow — flows:read
  • create_flow — flows:write
  • update_flow — flows:write
  • delete_flow — flows:write

Integraciones, conexiones y credenciales (integrations)

  • list_integrations — integrations:read
  • get_integration_sheets — integrations:read
  • get_integration_status — integrations:read
  • create_integration — integrations:write
  • update_integration — integrations:write
  • delete_integration — integrations:write
  • rotate_integration_token — integrations:write
  • list_connections — integrations:read
  • create_connection — integrations:write
  • test_connection — integrations:write
  • update_connection — integrations:write
  • delete_connection — integrations:write
  • list_credentials — integrations:read
  • create_credential — integrations:write
  • update_credential — integrations:write
  • delete_credential — integrations:write

Medios (media)

  • upload_media — media:write
  • get_media — media:write

Plantillas (templates)

  • list_templates — templates:read
  • delete_template — templates:write
  • create_template_from_bot — templates:write
  • apply_template — templates:write

Suscriptores, chats y diálogos — lectura (subscribers)

  • list_subscribers — subscribers:read (paginación offset/limit, filtros por etiquetas)
  • list_chats — subscribers:read
  • list_dialogs — subscribers:read
  • read_dialog — subscribers:read
  • send_dialog_message — subscribers:write
  • send_dialog_reaction — subscribers:write
  • transcribe_dialog_message — subscribers:write

Estadísticas y analítica (stats)

  • get_stats — stats:read
  • get_stats_summary — stats:read
  • get_stats_recent — stats:read
  • get_stats_log — stats:read
  • get_reaction_health — stats:read
  • get_analytics — stats:read
  • get_analytics_chats — stats:read
  • get_funnel — stats:read

Facturación — lectura (billing)

  • get_balance — billing:read
  • list_tariffs — billing:read
  • get_transactions — billing:read

Envío de mensajes

  • send_message — broadcasts:write — envía un mensaje en nombre del bot; el consumo de saldo se registra automáticamente según el propietario del token.

Recursos

Además de las herramientas, el servidor expone recursos que puedes leer para no tener que adivinar la estructura:

  • mybot://openapi.yaml — especificación OpenAPI completa (la misma que se sirve en /openapi.yaml).
  • mybot://reference — referencia compacta: lista de herramientas con sus scopes y convenciones (URL base, paginación, formato de errores, límites).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — esquemas JSON de configuraciones. Lo más valioso para generar correctamente reacciones (disparador, condiciones, chats, acciones), escenarios y colecciones.
  • mybot://bots — lista dinámica de tus bots (contexto rápido sin invocar una herramienta).

Prompts

Escenarios predefinidos (slash-comandos en el cliente MCP):

  • setup_autoresponder — construye un bot de respuesta automática (argumentos: bot, tema/conjunto de preguntas).
  • segment_broadcast — difusión segmentada por etiquetas (argumentos: bot, etiquetas, reacción/texto).
  • diagnose_reaction — analiza por qué una reacción no se activa (lee la reacción, reaction-health y el orden).
  • import_from_sambot — ejecuta la importación de un bundle SamBot y verifica el resultado.
  • weekly_report — resumen de estadísticas y analítica del bot para un período.

Cuándo usar MCP y cuándo REST

  • Si estás construyendo una integración, sincronización, script o panel propio, usa REST.
  • Si estás conectando GetMyBot a un asistente o agente de IA que admite MCP, usa /mcp.

Ambas interfaces funcionan con el mismo token y se rigen por los mismos permisos del propietario. Si no encuentras una herramienta para tu tarea, el endpoint REST correspondiente siempre está disponible en la referencia interactiva.

Qué sigue