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

| Herramienta | Alcance | Notas | | --- | --- | --- | | search | cualquiera de projects:read / templates:read / contacts:read | Busca 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. | | fetch | igual que search | Resuelve un id de search en su contenido completo. |

Diseño de correo

| Herramienta | Alcance | Destructiva | Notas | | --- | --- | :-: | --- | | list_projects | projects:read | | Id, nombre, propósito de cada proyecto. | | get_email | projects:read | | El árbol de bloques y el tema actuales de un proyecto. | | preview_email | projects:read | | Renderiza 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_types | projects:read | | El catálogo completo de 44 bloques, generado a partir del registro en vivo — siempre actual, nunca mantenido a mano. | | list_templates | projects:read | | Tus plantillas guardadas, o la galería de la comunidad aprobada. | | create_project | projects:write | | Opcionalmente inicializado a partir de una plantilla de propósito integrada. | | add_block / update_block / move_block | projects:write | | Ediciones de árbol, validadas por canPlace/campo de la misma forma que las ediciones del copiloto propio del estudio. | | remove_block | projects:write | ✓ | Elimina un bloque y sus hijos. | | set_theme | projects:write | | Colores de marca, fuente, radio de botón. | | rename_project | projects:write | | | | delete_project | projects:write | ✓ | Permanente. | | apply_template | projects:write | ✓ | Sobrescribe todo el árbol y el tema del proyecto. | | save_as_template | templates:write | | Toma una instantánea del proyecto actual como una plantilla reutilizable. |

Audiencia

| Herramienta | Alcance | Destructiva | Notas | | --- | --- | :-: | --- | | list_data_sources | contacts:read | | Cada fuente de datos, listas de contactos incluidas. Los valores de credenciales nunca se devuelven. | | list_contact_lists | contacts:read | | Listas de contactos específicamente — id, nombre, campos, número de filas. | | get_contact_list_summary | contacts:read | | Conteos y totales de supresión — sin datos de contacto individuales. | | find_contacts | contacts:read | | Búsqueda acotada (≤25 filas, paginada por cursor). Cada llamada se escribe en el registro de acceso a datos personales, igual que una lectura de contacto desde el panel. | | upsert_contacts | contacts:write | | Agrega o actualiza filas; aplica el límite de contactos de tu plan. | | remove_contact | contacts:write | ✓ | Elimina permanentemente una fila. | | add_suppression / remove_suppression | contacts:write | | Bloquea 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

| Herramienta | Alcance | Destructiva | Notas | | --- | --- | :-: | --- | | get_campaign_results | analytics:read | | Aperturas/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_form_responses | analytics:read | | Resúmenes por pregunta; las respuestas de texto libre son una muestra acotada y delimitada. | | list_orders | analytics:read | | Pedidos de pago del bloque de producto. | | list_campaign_sends | analytics:read | | Envíos masivos pasados, los más recientes primero. | | list_schedules | analytics:read | | Envíos recurrentes configurados en un proyecto. | | mark_order_fulfilled | commerce:write | | Marca un pedido físico como enviado y le envía un correo al comprador. | | create_schedule | campaigns:send | | Configura un nuevo envío recurrente. | | set_schedule_enabled | campaigns:send | ✓ | Marcada como destructiva porque deshabilitar una programación activa detiene envíos futuros en silencio. |

Envío

| Herramienta | Alcance | Destructiva | Notas | | --- | --- | :-: | --- | | send_test_email | campaigns:read | | Una sola copia con prefijo [Test] a una dirección que tú especifiques — no toca tu audiencia real ni necesita campaigns:send. | | prepare_send | campaigns:send | | De solo lectura según la anotación — resuelve la audiencia y renderiza una vista previa, no envía nada. Devuelve un confirmationToken. Con widget adjunto (tarjeta de confirmación de envío). | | confirm_send | campaigns: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

| Herramienta | Alcance | Notas | | --- | --- | --- | | list_mailbox_threads / get_mailbox_thread | mailbox:read | Correo entrante en tu dominio verificado. Los cuerpos de mensaje se delimitan como contenido no confiable escrito por el destinatario. | | reply_to_mailbox_thread | mailbox:write | Envía desde la dirección de buzón exacta a la que llegó el correo original, correctamente encadenado. | | list_tickets / get_ticket | mailbox:read | Conversaciones de tickets de soporte. El mismo delimitado de contenido no confiable. | | reply_to_ticket | mailbox:write | Agrega un mensaje del propietario y le envía un enlace de vuelta al destinatario por correo. |

Cuenta

| Herramienta | Alcance | Notas | | --- | --- | --- | | get_plan_usage | ninguno — siempre disponible | Plan, 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).