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.

Aug 19, 2026

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_templates y envía con send_message usando type: whatsapp_template.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp