Herramientas

Las 88 herramientas del Conector MCP, por dominio. Las marcadas ✍️ Escritura exigen credencial con acceso completo (full); las que mutan datos del tenant piden además confirmación (confirmar=true). El resto son de lectura y funcionan con read. Todo opera solo sobre tu tenant.

En detalle: las que más vas a usar

actualizar_config_bot ✍️

Edita el borrador del Prompt Builder (merge parcial: solo los campos que mandás). No afecta al bot hasta publicar_config_bot.

Parámetro	Tipo	Descripción
cambios	objeto	{ variable: valor } con los campos del wizard a cambiar
esperado_actualizado	texto (opcional)	control de concurrencia optimista

// entrada
{ "cambios": { "tone": "cercano", "greeting": "¡Hola! Bienvenido a La Espiga 🥖" } }
// salida → confirma qué quedó en el borrador (no publicado)
{ "estado": "borrador_actualizado", "campos": ["tone", "greeting"] }

cargar_conocimiento ✍️

Crea una entrada de KB. Inmediata (no requiere publicar).

Parámetro	Tipo	Descripción
pregunta	texto	la consulta (FAQ) o la situación (protocolo)
respuesta	texto	la respuesta o la regla imperativa
tipo	"faq" | "protocol"	por defecto faq — ver FAQ vs Protocolo

{ "pregunta": "¿Hacen envíos?", "respuesta": "Sí, a todo el país en 48h.", "tipo": "faq" }

programar_seguimiento ✍️

Encola un mensaje outbound a un lead (respeta pacing anti-ban y ventana de 24h).

Parámetro	Tipo	Descripción
lead_id	texto	el lead destinatario
cuando	texto	momento del envío (ej. fecha/hora)
mensaje	texto	el contenido
confirmar	bool	true para aplicar (sin él, devuelve preview)

crear_prospecto ✍️

Crea un prospecto de venta saliente: una ficha de contacto + un lead en estado NEW para hacerle seguimiento en el funnel, en un solo paso. Pensado para prospección en frío (sin conversación previa). No le envía ningún mensaje al negocio — solo lo carga para gestionarlo. Deduplica por teléfono/email: si el contacto ya existe y tiene un lead abierto, no lo duplica (devuelve el existente).

Parámetro	Tipo	Descripción
nombre	texto	nombre del negocio o persona
telefono	texto (opcional)	teléfono o WhatsApp (se normaliza)
email	texto (opcional)	email
web	texto (opcional)	sitio web
instagram	texto (opcional)	usuario o URL de Instagram
direccion	texto (opcional)	dirección física
senal_fit	texto (opcional)	evidencia de por qué encaja como cliente
score	número (opcional)	fit 0-100 (qualification_score)
vertical	texto (opcional)	rubro (ej. dentales)
zona	texto (opcional)	comuna o ciudad
confirmar	bool	true para crear (sin él, devuelve preview)

Requiere al menos telefono o email. Los datos de contacto (web/instagram/dirección) quedan en la ficha del contacto; la señal de fit y el score, en el lead.

// entrada
{ "nombre": "Clínica Dental Sonríe", "telefono": "+56 9 5781 6940",
  "web": "https://clinicasonrie.cl", "senal_fit": "agenda 100% por WhatsApp, sin bot",
  "score": 80, "vertical": "dentales", "zona": "Providencia", "confirmar": true }
// salida → contacto + lead NEW creados (o el existente si ya estaba)
{ "ejecutado": true, "creado": true, "reusado": false,
  "contacto": { "id": "…", "nombre": "Clínica Dental Sonríe", "telefono": "56957816940" },
  "lead": { "id": "…", "estado": "NEW", "etapa": "NEW", "score": 80 } }

¿Cargás prospectos desde un script o sistema, sin un cliente MCP? Podés hacer lo mismo con una llamada HTTP normal: ver Crear prospectos por REST.

Ver el negocio

Herramienta	Qué hace
estado_conexion	Verifica la credencial y devuelve tu tenant.	Lectura
resumen_negocio	Resumen de actividad (leads, conversaciones, métricas) de N días.	Lectura
metricas_agente	Números duros: tasa de handoff, preguntas sin responder, leads por etapa, conversión, mensajes promedio.	Lectura
estado_agente	Checklist de preparación del bot (rol, KB, canal) + addons activos y avisos de coherencia (ej. objetivo agendar sin agenda conectada, addon en modo prueba, agenda activa sin objetivo de venta).	Lectura
ver_addons	Tus integraciones/addons y su estado: si están activos y su configuración con los secretos ocultos (tokens/keys se muestran como *** si están cargados).	Lectura
listar_usuarios	Miembros del equipo (id, email, rol) — usá el id para asignar leads.	Lectura
uso_del_plan	Consumo del plan del tenant.	Lectura
listar_leads	Lista leads, filtrable por etapa del funnel.	Lectura
conversaciones_atencion	Conversaciones que requieren atención humana (handoffs).	Lectura
listar_conversaciones	Todas las conversaciones recientes (con nº de mensajes), para tomar una muestra representativa.	Lectura
leer_conversacion	Historial de mensajes de una conversación.	Lectura

Addons: solo lectura por MCP

ver_addons y estado_agente te dejan ver tus integraciones y detectar incoherencias, pero activar o configurar un addon (tokens, OAuth, credenciales) se hace desde el panel — nunca por el MCP. Los secretos siempre salen enmascarados (***).

Copiloto de mejora del agente

Herramienta	Qué hace
ver_prompt_efectivo	El system prompt final que usa el bot (rol + Prompt Builder + capas + bloques v2), no el borrador del wizard.	Lectura
probar_bot	Manda un mensaje de prueba efímero y devuelve la respuesta real del bot (mismo pipeline que prod) sin crear conversación/lead/memoria ni enviar nada. Consume cuota de LLM → tope diario. Devuelve un session_id: re-pasalo para continuar el mismo hilo multi-turno (máx 20 turnos, 30 min) y reproducir bugs que solo aparecen a varios turnos.	✍️ Escritura

Loop de mejora

ver_prompt_efectivo + metricas_agente para diagnosticar → actualizar_config_bot para ajustar → probar_bot para A/B (probá 2-3 mensajes antes/después; si el problema aparece recién a varios turnos —mezcla de idiomas, sobre-indagación, handoff falso— re-pasá el session_id para continuar el mismo hilo). El prompt optimizar_agente orquesta todo esto sobre conversaciones reales.

Prompt Builder — personalidad del bot

Herramienta	Qué hace
ver_definicion_prompt_builder	Los 9 pasos del wizard, sus campos y opciones válidas.	Lectura
listar_roles_agente	Roles (cargos) válidos para el tenant.	Lectura
ver_config_bot	Config publicada hoy + si hay borrador pendiente.	Lectura
actualizar_config_bot	Edita el borrador (merge parcial). No afecta al bot aún.	✍️ Escritura
publicar_config_bot	Aplica el borrador — regenera el prompt (destructivo).	✍️ Escritura

Flujo recomendado

ver_definicion_prompt_builder → listar_roles_agente → ver_config_bot → actualizar_config_bot (borrador) → revisar con el dueño → publicar_config_bot. Publicar reconstruye el system prompt completo: confirmá siempre antes.

Conocimiento (KB)

Herramienta	Qué hace
listar_conocimiento	Lista FAQs y protocolos, con filtro y búsqueda.	Lectura
cargar_conocimiento	Crea una FAQ (faq) o un protocolo (protocol).	✍️ Escritura
editar_conocimiento	Edita una entrada existente.	✍️ Escritura
activar_desactivar_conocimiento	Activa o pausa una entrada.	✍️ Escritura
borrar_conocimiento	Elimina una entrada.	✍️ Escritura
preguntas_sin_responder	Preguntas de usuarios que el bot no supo responder.	Lectura
responder_pregunta_pendiente	Responde una pendiente y la agrega al KB.	✍️ Escritura
descartar_pregunta_pendiente	Descarta una pendiente.	✍️ Escritura

FAQ vs. Protocolo

FAQ: respuesta a una consulta (“cuando pregunten X, respondé Y”). Protocolo: regla imperativa que el bot sigue siempre (“ante un reclamo, pedí el N° de pedido y derivá”). Los protocolos tienen un tope activo — usalos para conducta, no para datos sueltos.

Fuentes y documentos

Herramienta	Qué hace
listar_fuentes_conocimiento	Fuentes conectadas (Google Sheets, documentos).	Lectura
conectar_google_sheet	Conecta una hoja de Google como fuente de KB.	✍️ Escritura
sincronizar_conocimiento	Re-sincroniza una fuente.	✍️ Escritura
desconectar_fuente	Desconecta una fuente (quita sus entradas).	✍️ Escritura
agregar_documento_conocimiento	Carga un lote de entradas como un documento.	✍️ Escritura
agregar_web_al_conocimiento	Descarga una web pública y devuelve su texto limpio para estructurarlo en FAQs (la carga real se hace con agregar_documento_conocimiento). Solo URLs públicas.	✍️ Escritura

Reglas del agente — salida

Herramienta	Qué hace
listar_reemplazos · crear_reemplazo · borrar_reemplazo	Reemplazos de palabras/patrones en la salida del bot.	Lectura / ✍️ / ✍️
listar_frases_prohibidas · crear_frase_prohibida · borrar_frase_prohibida	Frases que el bot nunca debe decir.	Lectura / ✍️ / ✍️
listar_directivas_estilo · crear_directiva_estilo · borrar_directiva_estilo	Directivas de estilo (positivas/negativas).	Lectura / ✍️ / ✍️

Memoria institucional

Herramienta	Qué hace
listar_memoria	Memoria aprendida, filtrable por estado/fuente.	Lectura
aprobar_memoria · rechazar_memoria	Aprueba o rechaza un ítem de memoria.	✍️ Escritura
editar_memoria · borrar_memoria	Edita o elimina un ítem.	✍️ Escritura
aprobar_sugerencia_kb · rechazar_sugerencia_kb	Gestiona sugerencias de KB derivadas de la memoria.	✍️ Escritura

CRM — leads, contactos y tickets

Herramienta	Qué hace
crear_prospecto	Crea un prospecto saliente: contacto + lead NEW (dedup por teléfono/email). No envía mensajes. Ficha detallada arriba.	✍️ Escritura
crear_prospectos	Crea varios prospectos de una (bulk, máx 50). Mismos campos que crear_prospecto.	✍️ Escritura
ver_lead	Detalle de un lead.	Lectura
ver_timeline_lead	Historial de eventos del lead (etapas, notas, asignaciones).	Lectura
etiquetar_lead	Agrega/quita etiquetas.	✍️ Escritura
agregar_nota_lead	Agrega una nota interna.	✍️ Escritura
cambiar_etapa_lead	Mueve el lead en el funnel.	✍️ Escritura
asignar_lead	Asigna el lead a un usuario del equipo (o lo desasigna).	✍️ Escritura
editar_lead	Edita datos de venta: valor del deal, probabilidad, score, próxima acción, nombre/email/tel.	✍️ Escritura
listar_tickets	Tickets del tenant, filtrable por estado.	Lectura
buscar_contactos · ver_contacto	Busca y ve contactos.	Lectura
etiquetar_contacto · agregar_nota_contacto	Etiqueta un contacto o le agrega una nota.	✍️ Escritura

Seguimientos (outbound)

Herramienta	Qué hace
listar_seguimientos	Seguimientos programados.	Lectura
programar_seguimiento	Programa un mensaje outbound a un lead (a futuro).	✍️ Escritura
enviar_mensaje	Envía un mensaje ahora a un contacto — por session_id (Canal API) o telefono (WhatsApp, respeta anti-ban: opt-out, ventana 24h, tope y pacing). Pide confirmar=true.	✍️ Escritura
cancelar_seguimiento	Cancela un seguimiento.	✍️ Escritura

Surveys (mystery shopping)

Herramienta	Qué hace
listar_encuestas · ver_encuesta	Encuestas del tenant.	Lectura
listar_visitas · ver_visita	Visitas (respuestas), filtrable por estado/sucursal.	Lectura
crear_encuesta	Crea una plantilla de encuesta COMPLETA en un paso (template + secciones).	✍️ Escritura
asignar_visita	Asigna una visita a un número de teléfono.	✍️ Escritura

Catálogo (servicios y recursos)

Lo que el negocio ofrece y agenda. Un servicio es lo que se reserva (ej. “Corte”); un recurso es quién/qué lo presta (profesional, box, sala). Se vinculan N–N.

Herramienta	Qué hace
ver_catalogo	Muestra servicios (nombre, duración, precio), recursos y los vínculos entre ellos.	Lectura
crear_servicio	Crea un servicio del catálogo.	✍️ Escritura
editar_servicio	Edita un servicio existente (solo los campos que pases).	✍️ Escritura
crear_recurso	Crea un recurso (profesional, box, sala…) que presta servicios.	✍️ Escritura
vincular_servicio_recurso	Vincula un servicio con un recurso que lo presta (necesario para que ese recurso pueda agendarse).	✍️ Escritura

Agenda (disponibilidad y reservas)

Define cuándo puede reservarse cada recurso. Requiere tener catálogo con al menos un servicio vinculado a un recurso.

Herramienta	Qué hace
ver_agenda	Disponibilidad del tenant: reglas de horario (por día) y excepciones (bloqueos).	Lectura
ver_reservas	Lista las reservas (con servicio, recurso y contacto), filtrable.	Lectura
crear_regla_horario	Crea una franja disponible para un recurso (dia_semana 0=lunes … 6=domingo, horas HH:MM).	✍️ Escritura
borrar_regla_horario	Elimina una regla de horario (ids con ver_agenda).	✍️ Escritura
crear_excepcion	Bloquea una fecha puntual para un recurso (feriado, vacaciones, cierre).	✍️ Escritura
borrar_excepcion	Elimina un bloqueo de fecha.	✍️ Escritura

Flujo para dejar un negocio listo para agendar

crear_servicio → crear_recurso → vincular_servicio_recurso → crear_regla_horario (una por franja/día). Sin al menos un servicio vinculado a un recurso con horario, no hay disponibilidad para reservar.

Workflows (automatizaciones)

Automatizaciones evento → condición → acciones: cuando pasa algo (un lead se escala, se crea un ticket, vence un recordatorio…), el motor ejecuta los pasos que definiste (enviar un mensaje, mover de etapa, etiquetar, avisar al equipo…). Modelo completo, paleta de triggers/acciones y ejemplos en Workflows.

Herramienta	Qué hace
listar_workflows	Lista tus workflows y su estado (borrador / activo / pausado).	Lectura
ver_instancias_workflow	Ejecuciones (instancias) de un workflow: activas, completadas, con error.	Lectura
crear_workflow	Crea un workflow estructurado: trigger_type + pasos (action / wait / branch). Queda en borrador.	✍️ Escritura
crear_workflow_desde_texto	Crea un workflow describiéndolo en lenguaje natural (ej. “cuando un lead se escala, avisá al equipo y movelo a SALES_READY”); lo compila a pasos. Queda en borrador.	✍️ Escritura
activar_workflow	Activa un workflow en borrador — recién ahí empieza a correr ante sus eventos.	✍️ Escritura

Flujo

crear_workflow (o crear_workflow_desde_texto) → revisar con listar_workflows → activar_workflow. Nace en borrador: no corre hasta activarlo. Seguí sus ejecuciones con ver_instancias_workflow.