Menú de la documentación

Referencia de herramientas

Cada herramienta que puede llamar un asistente conectado, agrupada de la misma forma en que el servidor las registra. Una herramienta solo se le ofrece al asistente si tu conexión tiene el alcance que necesita — no existe una herramienta de escritura que esté presente pero siempre falle; si no otorgaste contacts:write, el asistente simplemente no ve upsert_contacts en absoluto. Mira Alcances y permisos para saber qué significa cada alcance.

Destructiva en las tablas de abajo es la misma anotación de MCP que exige el propio proceso de revisión de Claude — marca una herramienta cuyo efecto no se puede deshacer trivialmente (eliminar un proyecto, sobrescribir un árbol, quitar un contacto), no "peligrosa" en algún sentido más vago. Cada herramienta de escritura sigue tomando solo los campos que esperarías; ninguna acepta un payload sin procesar por el que el modelo pudiera colar cambios arbitrarios.

Descubrimiento

HerramientaAlcanceNotas
searchcualquiera de projects:read / templates:read / contacts:readBusca proyectos, plantillas y listas de contactos por nombre. Devuelve ids opacos para fetch. Esta es la herramienta que un cliente con investigación profunda llama automáticamente.
fetchigual que searchResuelve un id de search en su contenido completo.

Diseño de correo

HerramientaAlcanceDestructivaNotas
list_projectsprojects:readId, nombre, propósito de cada proyecto.
get_emailprojects:readEl preencabezado, el árbol de bloques, el tema y los ajustes de respuestas actuales de un proyecto.
preview_emailprojects:readRenderiza a través del pipeline real de HTML enviado — el documento exacto que produciría un envío. Con widget adjunto (mira abajo).
list_block_typesprojects:readEl catálogo completo de 44 bloques, generado a partir del registro en vivo — siempre actual, nunca mantenido a mano.
list_templatesprojects:readTus plantillas guardadas, o la galería de la comunidad aprobada.
create_projectprojects:writeOpcionalmente inicializado a partir de una plantilla de propósito integrada, con un preencabezado opcional.
add_block / update_block / move_blockprojects:writeEdiciones de árbol, validadas por canPlace/campo de la misma forma que las ediciones de Mia AI propio del estudio.
remove_blockprojects:write✓Elimina un bloque y sus hijos.
set_themeprojects:writeColores de marca, fuente, escala tipográfica, estilos de botón, estilo de enlaces, espacio entre bloques, diseño de la tarjeta y modo oscuro.
rename_projectprojects:write
delete_projectprojects:write✓Permanente.
apply_templateprojects:write✓Sobrescribe todo el árbol y el tema del proyecto.
save_as_templatetemplates:writeToma una instantánea del proyecto actual como una plantilla reutilizable.
publish_landing_pageprojects:writePublica un correo como página web pública en /lp/<slug> y devuelve su URL. El asistente tiene instrucciones de enseñarte antes el correo y obtener tu aprobación, igual que al enviar.
unpublish_landing_pageprojects:writeRetira la página. La dirección sigue reservada para ti.
set_response_settingsprojects:writeDefine qué es una respuesta completa: todos los bloques contados o cualquier respuesta, qué bloques cuentan, el mensaje final y una redirección https opcional.

Audiencia

HerramientaAlcanceDestructivaNotas
list_data_sourcescontacts:readCada fuente de datos, listas de contactos incluidas. Los valores de credenciales nunca se devuelven.
list_contact_listscontacts:readListas de contactos específicamente — id, nombre, campos, número de filas.
get_contact_list_summarycontacts:readConteos, totales de supresión y el desglose de la verificación de correo, más el estado de la última verificación — sin datos de contacto individuales.
find_contactscontacts:readBúsqueda acotada (≤25 filas, paginada por cursor). sortBy: "engagementScore" devuelve primero los contactos más calientes de la lista, con su puntuación y su cambio de la semana. Cada llamada se escribe en el registro de acceso a datos personales, igual que una lectura de contacto desde el panel.
upsert_contactscontacts:writeAgrega o actualiza filas; aplica el límite de contactos de tu plan.
remove_contactcontacts:write✓Elimina permanentemente una fila.
add_suppression / remove_suppressioncontacts:writeBloquea o desbloquea una dirección en toda la cuenta, el mismo efecto que el propio enlace de cancelación de suscripción de un destinatario.

Resultados

HerramientaAlcanceDestructivaNotas
get_campaign_resultsanalytics:readAperturas/clics/respuestas/ingresos, comparación de variantes A/B, mapa de calor de clics. Solo resumido — nunca eventos individuales sin procesar por destinatario. Con widget adjunto.
get_email_insightsanalytics:readUna vista de Insights (resumen, bloques, un bloque, audiencia, tabla cruzada, envíos o interacción) como agregados, con filtros opcionales de fecha, envío, variante y lista. Las mismas cifras que la página; audiencia y tabla cruzada requieren Pro o superior. Las diferencias son observadas, no probadas.
get_form_responsesanalytics:readResúmenes por pregunta; las respuestas de texto libre son una muestra acotada y delimitada.
list_ordersanalytics:readPedidos de pago del bloque de producto.
list_campaign_sendsanalytics:readEnvíos masivos pasados, los más recientes primero.
list_schedulesanalytics:readEnvíos recurrentes configurados en un proyecto.
mark_order_fulfilledcommerce:writeMarca un pedido físico como enviado y le envía un correo al comprador.
create_schedulecampaigns:sendConfigura un nuevo envío recurrente.
set_schedule_enabledcampaigns:send✓Marcada como destructiva porque deshabilitar una programación activa detiene envíos futuros en silencio.

Envío

HerramientaAlcanceDestructivaNotas
send_test_emailcampaigns:readUna sola copia con prefijo [Test] a una dirección que tú especifiques — no toca tu audiencia real ni necesita campaigns:send.
prepare_sendcampaigns:sendDe solo lectura según la anotación — resuelve la audiencia y renderiza una vista previa, no envía nada. Devuelve un confirmationToken, y cuántos contactos se omitirán por dirección no válida o por falta de consentimiento. Con widget adjunto (tarjeta de confirmación de envío).
confirm_sendcampaigns:send✓Requiere el confirmationToken exacto que devolvió prepare_send, sin cambios, dentro de 10 minutos. Mira Seguridad para saber por qué.

Buzón de correo y tickets

HerramientaAlcanceNotas
list_mailbox_threads / get_mailbox_threadmailbox:readCorreo entrante en tu dominio verificado. Los cuerpos de mensaje se delimitan como contenido no confiable escrito por el destinatario.
reply_to_mailbox_threadmailbox:writeEnvía desde la dirección de buzón exacta a la que llegó el correo original, correctamente encadenado.
list_tickets / get_ticketmailbox:readConversaciones de tickets de soporte. El mismo delimitado de contenido no confiable.
reply_to_ticketmailbox:writeAgrega un mensaje del propietario y le envía un enlace de vuelta al destinatario por correo.

Recorridos y segmentos

HerramientaAlcanceDestructivaNotas
list_journeysjourneys:readId, nombre, activado o no, tipo de disparador y número de pasos de cada recorrido.
get_journeyjourneys:readEl flujo completo de un recorrido, con los nombres de tus correos, listas y segmentos, y todo lo que le impediría ejecutarse. Para un recorrido desactivado que puede ejecutarse, también devuelve un enableToken.
list_segmentsjourneys:readLos segmentos guardados, con su lista de contactos y sus reglas.
create_segmentjourneys:writeGuarda un segmento sobre una lista de contactos. Respeta el límite de segmentos de tu plan.
build_journeyjourneys:writeCrea un recorrido nuevo, o edita uno desactivado, a partir de una petición en lenguaje natural, con Mia AI del editor de recorridos. Consume un turno de Mia AI. El resultado siempre se guarda desactivado, y un recorrido activado nunca se modifica.
set_journey_enabledjourneys:write (+ campaigns:send para activar)✓Activar un recorrido exige el enableToken de get_journey, sin cambios, en un plazo de 10 minutos y sin ediciones intermedias. La misma idea de dos pasos que prepare_send/confirm_send. Pausarlo no requiere ninguno de los dos.

Experimentos

HerramientaAlcanceDestructivaNotas
list_experimentsanalytics:readTus experimentos A/B, del más reciente al más antiguo, tanto de envío como de recorrido: estado, variantes, métricas, el último resultado del motor de análisis, la decisión registrada si la hay y un enlace a la página de resultados. Filtra por estado, tipo, email o recorrido.
get_experiment_resultsanalytics:readEl informe de un experimento, el mismo que la exportación JSON de la página de resultados, más el resultado del motor en una línea. Al asistente se le indica que esa línea es el único veredicto, así que solo nombra un ganador cuando el motor lo hizo.
create_experiment_draftprojects:writeCrea un borrador de experimento de envío sobre un email: nombre, hipótesis, métricas y hasta el número de variantes que permite tu plan, repartidas por igual. No envía nada. La audiencia, el bloqueo y el lanzamiento se hacen en el panel, desde el enlace que devuelve. Los experimentos de recorrido se crean desde un paso de división.

Ninguna herramienta bloquea, lanza, decide ni despliega un experimento. Esos pasos siguen siendo tuyos, en el panel.

Cuenta

HerramientaAlcanceNotas
get_plan_usageninguno — siempre disponiblePlan, cuotas y uso de este mes. De solo lectura, y no es un dato de cuenta sensible de la forma en que lo son proyectos/contactos/buzón, así que está disponible sin importar qué alcances hayas otorgado.

Widgets

Tres herramientas adjuntan un widget interactivo en los anfitriones que admiten MCP Apps (Claude — Gemini no tiene capa de widgets y siempre recibe el resultado en texto plano/JSON en su lugar): preview_email (vista previa de correo en vivo de escritorio/móvil), get_campaign_results (panel de resultados), y prepare_send (la tarjeta de confirmación de envío, cuyo propio botón Confirm & Send es lo que realmente llama a confirm_send).