Herramientas MCP
El servidor MCP expone herramientas agrupadas por área del producto. La lista de abajo es la referencia de lectura; la lista autoritativa es la que el servidor devuelve a tu cliente (tools/list) — varía según tu perfil y las funciones habilitadas en la empresa.
Una herramienta fuera de tu perfil simplemente no aparece: no existe llamada que eluda el permiso.
Conversaciones
| Herramienta | Qué hace |
|---|---|
list_open_conversations | Conversaciones esperando respuesta / abiertas, con filtros por tag, no leídas y fecha |
list_archived_conversations | Conversaciones archivadas |
list_finished_conversations | Conversaciones finalizadas |
search_inbox | Búsqueda en conversaciones, contactos y mensajes |
get_conversation_details | Datos de la conversación: canal, cola, agente, tags, estado |
get_conversation_history | Historial de mensajes de la conversación |
take_conversation | Asume la conversación para el usuario |
transfer_conversation | Transfiere a otra cola o agente, con recado |
finish_conversation | Finaliza la atención; las conversaciones de anuncio exigen classification |
reopen_conversation | Reabre una conversación finalizada |
update_conversation | Marca leída/no leída, archiva, silencia, fija |
update_conversation_tags | Aplica y quita tags |
list_transfer_targets | Colas y agentes a los que transferir |
recalculate_cx_score | Recalcula el CX Score de una conversación finalizada |
Mensajes y multimedia
| Herramienta | Qué hace |
|---|---|
send_message | Envía texto en la conversación |
send_template | Envía una plantilla aprobada (con variables) |
send_media | Envía multimedia (base64, hasta 2 MB) |
get_message_media | Recupera la multimedia de un mensaje |
list_conversation_media | Lista la multimedia de la conversación |
update_message | Edita el contenido de un mensaje |
react_to_message | Reacciona a un mensaje |
cancel_scheduled_message | Cancela una plantilla programada |
list_starred_messages | Mensajes marcados con estrella |
list_templates | Plantillas aprobadas del canal de la conversación |
start_conversation | Inicia una conversación nueva (canal + identificador) |
Contactos y notas
| Herramienta | Qué hace |
|---|---|
search_contacts | Busca contactos |
get_contact | Ficha del contacto |
create_contact / update_contact / delete_contact | CRUD de contacto |
import_contacts | Importa contactos en lote a partir de CSV |
find_contact_matches | Busca contactos duplicados antes de crear |
list_contact_owners / transfer_contact_owner | Responsables y transferencia de responsable |
convert_conversation_to_contact | Convierte la conversación en contacto del CRM |
unlink_conversation_contact | Desvincula la conversación del contacto |
rename_conversation_contact | Renombra el contacto desde la conversación |
add_contact_note / list_contact_notes | Notas internas sobre el contacto |
CRM (cuentas y oportunidades)
| Herramienta | Qué hace |
|---|---|
search_accounts, get_account, create_account, update_account, delete_account | CRUD de cuenta |
list_account_owners, transfer_account_owner | Responsables y transferencia |
search_opportunities, get_opportunity, create_opportunity, update_opportunity, delete_opportunity | CRUD de oportunidad |
transfer_opportunity_owner | Transferencia de responsable |
list_opportunity_stages, create_opportunity_stage, update_opportunity_stage, delete_opportunity_stage, reorder_opportunity_stages | Ciclo y etapas del embudo |
Campañas
| Herramienta | Qué hace |
|---|---|
list_campaigns / get_campaign | Lista y detalle |
create_campaign / update_campaign / update_campaign_details | Montaje y edición |
delete_campaign | Elimina (respetando el estado) |
dispatch_campaign | Envía un borrador |
cancel_campaign | Cancela una campaña programada |
mark_campaign_winner | Marca la variante ganadora del A/B |
get_campaign_dashboard | Métricas de la campaña |
list_campaign_channels / list_campaign_templates | Canales y plantillas disponibles |
list_campaign_audience_reports / preview_campaign_audience_report | Reportes elegibles como público |
upload_campaign_audience_csv | Envía el público por CSV |
Reportes y listas de visualización
| Herramienta | Qué hace |
|---|---|
list_reports, run_report | Lista y ejecuta reportes |
describe_report_type | Tipos y campos disponibles |
create_report, update_report, delete_report | CRUD de reporte |
get_report_config, save_report_config | Lectura y grabación de la configuración (columnas, grupos, filtros) |
get_report_shares, share_report | Compartir |
describe_view_fields | Campos, operadores y columnas válidas por pantalla |
list_views, create_view, update_view, delete_view | Listas de visualización |
run_view | Ejecuta una lista de visualización |
Configuración y plataforma
| Herramienta | Qué hace |
|---|---|
whoami | Usuario, empresa, perfil y funciones habilitadas |
list_users, create_user, list_roles | Usuarios y perfiles |
create_role, update_role | Perfiles de acceso |
list_channels | Canales conectados |
list_custom_fields, create_custom_field, update_custom_field, delete_custom_field | Campos personalizados |
list_agent_workspaces, update_agent_workspace | Agentes de IA por canal |
get_company_features, update_company_features | Funciones de la empresa |
get_entity_labels, update_entity_labels | Nombres de las entidades |
Errores y qué hacer
Los rechazos vienen con una pista de corrección en texto, además del código. Algunos ejemplos:
| Código | Pista |
|---|---|
session_assigned_to_other | La conversación es de otra persona — llama a take_conversation antes |
session_expired_template_required | Ventana de 24 h cerrada — usa list_templates y send_template |
session_closed | Conversación finalizada — usa reopen_conversation |
unknown_tag | La tag no existe — verifícala con el listado de tags |
too_many_rows | Divide en lotes de hasta 5.000 contactos |
validation_error | Los campos con problema vienen en el detalle del error |
El catálogo de códigos es el mismo que usa la API interna — el asistente recibe la instrucción, no solo el fallo.