# Herramientas disponibles

> Qué puede hacer la IA en tu cuenta de MINDO a través del servidor MCP.

Cuando conectas MINDO a Claude o ChatGPT, la IA recibe estas herramientas. No hace falta que las nombres: la IA elige cuál usar según lo que pidas. Todas trabajan sobre tu cuenta, con los permisos de tu rol.

## Cuenta y reportes

| Herramienta | Qué hace |
| --- | --- |
| `get_account_overview` | Estado de la cuenta: número de WhatsApp conectado, calidad, límites diarios, medio de pago en Meta y pasos pendientes. |
| `list_campaigns` | Lista las campañas con su estado y contadores básicos. |
| `get_campaign_stats` | Embudo de una campaña: enviados, entregados, leídos y respondieron, con sus tasas. |
| `get_campaigns_report` | Reporte de todas las campañas de los últimos N días, con totales y serie diaria. |

## Plantillas

| Herramienta | Qué hace |
| --- | --- |
| `list_templates` | Lista las plantillas con su texto, variables y estado de aprobación de Meta. |
| `create_template` | Crea una plantilla y la manda a aprobación de Meta. **Pide confirmación.** |

## Contactos y segmentos

| Herramienta | Qué hace |
| --- | --- |
| `search_contacts` | Busca contactos por nombre o teléfono. |
| `list_contact_fields` | Lista los campos personalizados (sirven para variables y filtros). |
| `import_contacts` | Importa hasta 500 contactos por vez y, si quieres, los suma a un segmento fijo. **Pide confirmación.** |
| `list_segments` | Lista los segmentos con la cantidad de contactos. |
| `create_segment` | Crea un segmento fijo o dinámico (con filtros). |

## Campañas

| Herramienta | Qué hace |
| --- | --- |
| `create_campaign_draft` | Crea una campaña en borrador con plantilla y segmento. No envía nada. |
| `update_campaign_draft` | Cambia el nombre, la plantilla o el segmento de un borrador. |
| `preview_campaign` | Vista previa: destinatarios, contactos con problemas, costo estimado en USD y cómo llega el mensaje. |
| `send_campaign` | Envía o programa una campaña. **Pide confirmación.** |
| `pause_campaign` | Pausa una campaña en curso o programada. |
| `resume_campaign` | Reanuda una campaña pausada. |
| `cancel_campaign` | Cancela una campaña para siempre: los mensajes pendientes no salen. **Pide confirmación.** |

## Agentes IA

Disponibles en el plan **Escala**. Mira [Agentes IA](/guias/agentes/introduccion).

| Herramienta | Qué hace |
| --- | --- |
| `list_agents` | Lista los agentes IA, en qué canales atienden y cómo les fue en los últimos 30 días. |
| `get_agent` | Detalle de un agente: objetivo, tono, modelo, fuentes de conocimiento y su estado de lectura. |
| `create_agent` | Crea un agente con su objetivo. Si le das la web del negocio, lee el sitio y el catálogo. Con `modelo` eliges el modelo de IA (por defecto, el estándar: ~1 crédito IA por respuesta). Con `avanzado`, lo crea en [modo avanzado](/avanzados/introduccion). No lo activa. |
| `update_agent` | Cambia el nombre, el objetivo, el tono, cuándo deriva, las instrucciones, el modo (responde solo o sugiere) o los [límites](/avanzados/limites). |
| `add_agent_knowledge` | Suma una web, una página, un feed de productos o un texto como conocimiento. |
| `test_agent` | Muestra qué respondería el agente a los mensajes de un cliente. No le escribe a nadie. |
| `activate_agent` | Pone al agente a atender WhatsApp o Instagram. **Pide confirmación.** |
| `deactivate_agent` | Hace que el agente deje de atender solo. |

## Agentes avanzados

Disponibles en el plan **Escala**. Mira [Agentes avanzados](/avanzados/introduccion).

| Herramienta | Qué hace |
| --- | --- |
| `configure_advanced_agent` | Pasa un agente al modo avanzado y configura su prompt, variables, motivos de derivación, herramientas propias, modelo y [límites](/avanzados/limites). Queda en el borrador. |
| `list_agent_tools` | Lista las herramientas propias: si están listas, qué versión está aprobada y qué agentes las usan. |
| `get_agent_tool` | Detalle de una herramienta: código o URL, entradas en JSON, permisos, dominios, ajustes y versiones. |
| `create_agent_tool` | Crea una herramienta de código o HTTP con sus entradas, permisos, dominios y reglas de lectura. |
| `update_agent_tool` | Cambia una herramienta. Los cambios de código, permisos o dominios vuelven a revisión. |
| `test_agent_tool` | Ejecuta la herramienta contra tu sistema, opcionalmente con una conversación real. No le escribe a nadie. |
| `submit_agent_tool` | Envía el código a [revisión](/avanzados/revision) del equipo de MINDO. |
| `list_credentials` | Lista tus [credenciales](/avanzados/credenciales) por su clave, sin los valores. Las nuevas se cargan solo desde la app. |
| `add_agent_test_case` | Suma un caso de prueba: una conversación y lo que tiene que pasar, o una conversación simulada con un cliente de IA. Acepta repeticiones, herramientas simuladas, canal y datos de prueba. |
| `run_agent_tests` | Corre los casos de prueba con el borrador y muestra qué falló. |
| `publish_agent` | Publica el borrador como una versión nueva, después de correr los casos obligatorios. **Pide confirmación.** |

<Note>
  La IA nunca te pide una key, un token o una contraseña por el chat. Las credenciales se cargan en **Ajustes › Credenciales** y las herramientas las usan por su clave.
</Note>

## Automatizaciones

Disponibles desde el plan **Crecimiento**. Mira [Automatizaciones](/guias/automatizaciones/introduccion).

| Herramienta | Qué hace |
| --- | --- |
| `list_automations` | Lista las automatizaciones con su estado, disparadores y ejecuciones de los últimos 30 días. |
| `get_automation_reference` | Qué datos lleva cada paso y disparador, qué salidas tiene cada uno, y tus agentes, clasificadores, equipo y los modelos de IA que puedes elegir (`modelosIA`). |
| `get_automation` | El borrador de una automatización: pasos, conexiones y los errores que impiden publicarla. |
| `save_automation` | Crea una automatización o reemplaza su borrador con el flujo completo. No responde a nadie hasta publicarla. |
| `simulate_automation` | Simula una conversación con un cliente inventado y muestra el recorrido. No le escribe a nadie. |
| `publish_automation` | Publica el borrador y activa la automatización. **Pide confirmación.** |
| `pause_automation` | Pausa una automatización activa y corta las ejecuciones en curso. |

## Reportes de métricas

Los reportes de la pantalla [Métricas](/guias/metricas). Cada persona tiene los suyos.

| Herramienta | Qué hace |
| --- | --- |
| `list_metric_widgets` | El catálogo de widgets: qué muestra cada uno, cómo se calcula y si pide configuración. También los reportes armados (presets). |
| `list_metrics_reports` | Tus reportes, con sus widgets, y cuál es el predeterminado. |
| `get_metrics_report` | Los datos de cada widget de un reporte para el período que elijas, comparados con el período anterior. |
| `create_metrics_report` | Crea un reporte desde un preset o con los widgets que pidas, y puede dejarlo como predeterminado. |
| `update_metrics_report` | Cambia el nombre, lo marca como predeterminado, suma o quita widgets y cambia las audiencias del widget **Personas en audiencias**. |
| `delete_metrics_report` | Elimina un reporte. Tiene que quedar al menos uno. **Pide confirmación.** |

## Casos y motivos

Los [casos](/guias/chat/casos): cada consulta de un cliente, con su motivo, su puntaje comercial y su resultado. Configurar los motivos y las señales pide el permiso **Configurar los motivos de los casos**.

| Herramienta | Qué hace |
| --- | --- |
| `list_case_reasons` | Los motivos y submotivos, con sus horas de cierre, si llevan puntaje y cuántos casos tuvo cada uno en los últimos 30 días. |
| `create_case_reason` | Crea un motivo o un submotivo, con su descripción para Jev, sus horas sin mensajes para cerrar el caso y si lleva puntaje. |
| `update_case_reason` | Cambia el nombre, la descripción, las horas, el puntaje o el orden de un motivo, o lo archiva. |
| `delete_case_reason` | Borra un motivo. Si ya tiene casos, lo archiva para no perder el historial. |
| `test_case_reasons` | Prueba qué motivo le pondría Jev a unos mensajes de ejemplo o a una conversación, sin guardar nada. |
| `get_case_settings` / `update_case_settings` | Los ajustes: horas para cerrar, clasificación automática, confianza mínima, cierre cuando el agente IA cumple su objetivo, moneda y los cortes de caliente y tibio. |
| `list_cases` / `get_case` | Los casos con filtros (estado, motivo, sin motivo o por revisar, resultado, puntaje mínimo, conversación, anuncio y fechas) y el detalle de uno con su historial. |
| `set_case_reason` | Cambia el motivo de un caso. Queda en el historial y Jev ya no lo cambia. |
| `classify_case` | Jev clasifica un caso ahora. Usa una clasificación del mes. |
| `set_case_status` | Resuelve (cierra) o reabre un caso. |
| `list_score_signals` | Las señales del puntaje: las preguntas de sí o no y sus pesos. |
| `create_score_signal` / `update_score_signal` / `delete_score_signal` | Crea, cambia, activa o desactiva y borra señales. |
| `test_case_score` | Prueba el puntaje (con las señales guardadas o un borrador) sobre unos mensajes de ejemplo. |
| `score_case` | Jev calcula ahora el puntaje de un caso. Usa una clasificación del mes. |
| `set_case_outcome` | Marca un caso como venta (con monto y moneda) o perdido, o le quita el resultado. |
| `case_report_by_ad` | Por anuncio: casos, comerciales, puntaje promedio, leads calientes, ventas, monto vendido y casos que resolvió solo el agente IA. |

## Cómo funciona la confirmación

Las herramientas marcadas con **Pide confirmación** trabajan en dos pasos:

1. La primera vez, la IA **no ejecuta nada**: te muestra un resumen de lo que va a hacer (por ejemplo, a cuántos contactos sale la campaña y cuánto cuesta).
2. Solo cuando le respondes que sí, vuelve a llamar la herramienta y la acción se realiza. Si pasan 30 minutos, el resumen vence y hay que pedirlo de nuevo.

<Note>
  Si tu rol es **Miembro**, la IA puede usar solo lo que te permiten tus grupos. Sin grupos, las herramientas de consulta, pero no las que crean, envían o cancelan.
</Note>

<Tip>
  ¿Quieres integrar MINDO con tu propio sistema en lugar de con un asistente de IA? Usa la [API](/api/introduccion), disponible en el plan Escala.
</Tip>