Herramientas del servidor MCP de Omnifox: referencia completa
Las 72 herramientas que expone @omnifox/mcp-server, agrupadas por módulo y con lo que hace cada una.
Mira este paso en el video · MCP: que una IA opere Omnifox
Esta es la lista completa de herramientas que el servidor MCP de Omnifox pone a disposición del asistente. Los nombres son los que verás en el registro de tu cliente de IA. En la versión 0.4.0 son 72.
Dos reglas transversales: todos los ids son enteros positivos, nunca UUID; y donde se pide un contacto también se acepta un selector tipo:valor (email:[email protected], phone:+593987654321, external:abc).
Contactos (11)
| Herramienta | Qué hace |
|---|---|
get_contact |
Trae un contacto por id o por selector. |
create_contact |
Crea un contacto. display_name es el único campo obligatorio. |
update_contact |
Actualiza solo los campos que envías. |
delete_contact |
Borra el contacto y todo lo que cuelga de él. Irreversible. |
list_contacts |
Lista contactos, los más activos primero. |
search_contacts |
Búsqueda libre por nombre, correo y teléfono (mínimo 2 caracteres). |
add_contact_tags |
Agrega etiquetas por nombre; crea las que no existan. |
remove_contact_tags |
Quita etiquetas por nombre. |
create_or_update_contact |
Alta idempotente: busca por las claves que indiques y crea si no hay coincidencia. |
merge_contacts |
Fusiona un contacto dentro de otro. Sobrevive el principal. |
list_contact_channels |
Lista las identidades de canal del contacto. |
Mensajería (5)
| Herramienta | Qué hace |
|---|---|
send_message |
Envía a un contacto. Reutiliza su conversación abierta o abre una. Tipos: text, attachment, quick_reply, whatsapp_template, email. |
send_conversation_message |
Envía dentro de una conversación cuyo id ya conoces. Con type: note deja una nota interna. |
get_message |
Trae un mensaje con su estado de entrega. |
list_messages |
Lista los mensajes de una conversación, del más antiguo al más nuevo. |
retry_message |
Reintenta la entrega de un mensaje fallido. |
Los adjuntos viajan como URL pública: Omnifox la descarga. El servidor MCP no sube archivos.
Conversaciones (9)
| Herramienta | Qué hace |
|---|---|
list_conversations |
Lista conversaciones; filtra por open, pending, resolved, closed o snoozed. |
get_conversation |
Trae una conversación con su contacto, canal, estado y asignación. |
get_conversation_sending_window |
Dice si todavía se puede mandar texto libre o si hace falta plantilla. |
assign_conversation |
Asigna a usuario, equipo o agente de IA, o desasigna. |
assign_contact_conversation |
Asigna la conversación abierta del contacto cuando no tienes su id. |
update_conversation_status |
Reabre, resuelve o cierra, con etiqueta de resolución y notas. |
update_contact_conversation_status |
Lo mismo, partiendo del contacto. |
snooze_conversation |
Pospone la conversación para que vuelva más tarde. |
list_conversation_notes |
Lista las notas internas del hilo. |
create_comment |
Agrega una nota interna a una conversación. |
Espacio de trabajo (13)
list_users, get_user, set_user_status, list_custom_fields, get_custom_field, create_custom_field, list_channels, list_snippets, list_templates, list_tags, create_tag, update_tag, delete_tag.
Sirven para descubrir ids antes de actuar: list_channels y list_users son casi siempre la primera llamada útil.
Agenda y citas (13)
list_calendars, list_services, list_resources, list_sites, list_free_slots, book_appointment, list_appointments, reschedule_appointment, cancel_appointment, list_enrollments, enroll_contact, mark_attendance, cancel_enrollment.
Regla de oro: siempre llama a list_free_slots antes de ofrecer o reservar un horario, y pasa el starts_at tal cual lo devolvió.
Catálogo y pedidos (10)
search_products, get_product, create_product, update_product, list_orders, get_order, create_order, set_order_status, record_order_payment, get_catalog_settings.
Los importes no se envían: el servidor cotiza cada línea con el catálogo y los impuestos del espacio de trabajo.
Flujos, difusiones, webhooks y reportes (11)
list_workflows, trigger_workflow, set_workflow_active, list_broadcasts, create_broadcast, cancel_broadcast, register_webhook, list_webhooks, list_workspaces, get_report.
get_report acepta cuatro informes: overview, conversations, agents y heatmap, con rangos today, yesterday, 7d, 30d, 90d, this_month y last_month (por defecto, los últimos 30 días).
Consejos
- Las respuestas vienen sin el envoltorio
{success, data}y con los listados aplanados a{items, page, last_page, per_page, total}: es menos ruido para el modelo. - En WhatsApp, fuera de la ventana de 24 horas solo se entrega una plantilla aprobada. Consulta
list_templatesy envía consend_messageusandotype: whatsapp_template.
Artículos relacionados
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.