Sequenzy MCP Server
oficialHerramienta de Email Marketing para SaaS
Documentación
Servidor MCP de Sequenzy
Servidor MCP oficial para Sequenzy, la plataforma de email marketing impulsada por IA.
Conecta Sequenzy a Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw y otros clientes MCP para que tu asistente de IA pueda gestionar operaciones de email con herramientas estructuradas en lugar de llamadas API manuales.
Qué Puedes Hacer
- Gestionar suscriptores, etiquetas, listas y segmentos dinámicos.
- Sincronizar segmentos con audiencias personalizadas de Meta para retargeting en Facebook e Instagram.
- Gestionar productos y adjuntar archivos de entrega digital para automatizaciones de compra.
- Redactar, actualizar, programar e inspeccionar campañas.
- Crear y editar secuencias de email, incluyendo automatizaciones activadas por eventos y por entrada a segmentos.
- Cancelar, pausar, reanudar, duplicar o eliminar campañas e inscribir contactos en secuencias.
- Gestionar plantillas de email transaccional y enviar emails transaccionales individuales.
- Crear, editar, publicar, despublicar y eliminar páginas de destino.
- Conectar y verificar dominios personalizados para páginas de destino publicadas.
- Gestionar invitaciones de equipo, conversaciones de bandeja de entrada y endpoints de webhook salientes.
- Generar copia de email, líneas de asunto y secuencias de múltiples pasos.
- Inspeccionar analíticas, actividad de suscriptores, salud de entregabilidad y URLs del panel.
- Configurar información de producto de la empresa, sitios web del remitente y ejemplos de integración para frameworks comunes.
Cada herramienta MCP publicada incluye anotaciones explícitas de readOnlyHint, destructiveHint y openWorldHint para que los clientes compatibles puedan mostrar prestaciones precisas de uso de herramientas. Las herramientas también publican definiciones de outputSchema y devuelven structuredContent, proporcionando a clientes y modelos formas de resultado legibles por máquina para llamadas posteriores.
Configuración Rápida
La ruta de configuración más sencilla es el asistente de Sequenzy:
npx @sequenzy/setup
El asistente abre el flujo de inicio de sesión en el navegador, crea una clave API personal, detecta los clientes de IA soportados y los configura automáticamente cuando es posible.
MCP Remoto Alojado
Para clientes que soportan MCP HTTP Transmisible, usa el endpoint alojado de Sequenzy en lugar de ejecutar un proceso stdio local:
https://api.sequenzy.com/v1/mcp
Los clientes remotos deben autenticarse con el flujo OAuth de Sequenzy cuando esté soportado. Los clientes locales y de automatización aún pueden usar el paquete stdio a continuación con SEQUENZY_API_KEY.
Archivos de descubrimiento legibles por máquina:
- Manifiesto del servidor MCP:
server.json - Tarjeta de agente:
.well-known/agent-card.json - Manifiesto de capacidad del agente:
agent-capability.json - Metadatos de habilidad de OpenClaw:
openclaw/skill.json
Configuración Manual
Todos los clientes MCP stdio usan el mismo comando:
- Comando:
npx - Args:
-y @sequenzy/mcp - Env requerida:
SEQUENZY_API_KEY=seq_user_your_key_here
Variables de entorno opcionales:
SEQUENZY_API_URL- URL base de la API de Sequenzy. Por defectohttps://api.sequenzy.com.SEQUENZY_APP_URL- URL base del panel de Sequenzy usada por los ayudantes de URL de la app. Por defectohttps://sequenzy.com.
Claude Desktop
Añade esto a tu configuración de Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sequenzy": {
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Reinicia Claude Desktop después de editar la configuración.
Claude Code
claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- npx -y @sequenzy/mcp
En Windows nativo, envuelve npx con cmd /c:
claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- cmd /c npx -y @sequenzy/mcp
Para una configuración de proyecto compartida, usa .mcp.json:
{
"mcpServers": {
"sequenzy": {
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Codex
codex mcp add sequenzy --env SEQUENZY_API_KEY=seq_user_your_key_here -- npx -y @sequenzy/mcp
codex mcp list
Configuración manual de Codex en ~/.codex/config.toml:
[mcp_servers.sequenzy]
command = "npx"
args = ["-y", "@sequenzy/mcp"]
[mcp_servers.sequenzy.env]
SEQUENZY_API_KEY = "seq_user_your_key_here"
Cursor
Añade esto a ~/.cursor/mcp.json:
{
"mcpServers": {
"sequenzy": {
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Windsurf
Usa la misma forma JSON que Cursor.
- macOS:
~/Library/Application Support/Windsurf/mcp.json - Windows:
%APPDATA%\Windsurf\mcp.json
VS Code Copilot
VS Code usa un objeto servers:
{
"servers": {
"sequenzy": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Otros Clientes MCP
Para OpenClaw, Hermes y otros clientes compatibles con MCP, apunta el cliente a npx -y @sequenzy/mcp y establece SEQUENZY_API_KEY.
Obtener una Clave API
- Abre el panel de Sequenzy.
- Ve a Configuración -> Claves API.
- Crea una clave personal.
- Añade la clave a la configuración de tu cliente MCP.
Las claves personales comienzan con seq_user_. Puedes revocarlas en cualquier momento en el panel.
Herramientas
Este servidor expone actualmente 120 herramientas MCP.
Cuenta, Empresas, Configuración
| Herramienta | Descripción |
|---|---|
get_account | Obtener información de la cuenta, empresas disponibles y la empresa actual. |
select_company | Establecer la empresa activa para futuras llamadas a herramientas. |
get_app_urls | Construir URLs del panel para campañas, páginas de destino, secuencias, emails, configuración, dominios y detalles de emails enviados. |
create_company | Crear una nueva empresa o marca. |
get_company | Leer detalles de la empresa, información del producto, colores de marca, contexto de escritura de IA y configuraciones de localización. |
update_company | Editar información del producto y contexto de marca que la IA usa para emails generados. |
create_api_key | Crear una clave API para una empresa. |
list_websites | Listar sitios web y dominios de remitente configurados. |
add_website | Añadir un sitio web de remitente. El procesamiento puede tardar unos 30 segundos. |
check_website | Verificar si un sitio web está procesado y listo. |
get_integration_guide | Obtener ejemplos de integración específicos del framework. |
Suscriptores
| Herramienta | Descripción |
|---|---|
add_subscriber | Añadir un suscriptor con atributos, etiquetas, estado, modo de suscripción e IDs de lista opcionales. |
update_subscriber | Actualizar atributos, añadir etiquetas o eliminar etiquetas. |
remove_subscriber | Dar de baja a un suscriptor o eliminarlo definitivamente. |
get_subscriber | Obtener detalles del suscriptor por email o ID externo. |
search_subscribers | Buscar por consulta, etiquetas, lista, estado, segmento o paginación. |
Productos y Entrega Digital
| Herramienta | Descripción |
|---|---|
list_products | Listar productos sincronizados desde Stripe, Shopify, WooCommerce, datos manuales o de la API de Comercio. |
upsert_products | Crear o actualizar hasta 100 productos de la API de Comercio identificados por tu ID de producto. |
delete_product | Eliminar un producto previamente enviado a través de la API de Comercio. |
attach_product_file | Adjuntar un archivo de entrega alojado o subido localmente a un producto. |
remove_product_file | Eliminar un archivo de entrega de producto adjunto. |
sync_products | Poner en cola una sincronización del catálogo de productos de Stripe. |
Después de adjuntar un archivo de entrega de producto, los eventos de compra coincidentes incluyen download.url y download.name, por lo que los emails activados por compra pueden usar etiquetas de fusión como {{event.download.url}}.
Listas, Etiquetas, Segmentos
| Herramienta | Descripción |
|---|---|
list_tags | Listar todas las etiquetas. |
create_tag | Crear una definición de etiqueta con un color opcional. |
update_tag | Actualizar el color de una etiqueta. |
delete_tag | Eliminar una etiqueta y quitarla de los suscriptores. |
list_lists | Listar listas de suscriptores. |
create_list | Crear una lista de suscriptores. |
update_list | Renombrar o describir una lista de suscriptores. |
delete_list | Eliminar una lista de suscriptores. |
add_subscribers_to_list | Añadir hasta 500 suscriptores a una lista desde un array de emails. |
remove_subscribers_from_list | Eliminar hasta 500 suscriptores de una lista. |
list_segments | Listar segmentos guardados y recuentos. |
create_segment | Crear segmentos guardados a partir de filtros o grupos anidados AND/OR. |
update_segment | Actualizar nombre del segmento, filtros, grupo raíz u operador de unión. |
delete_segment | Eliminar un segmento guardado. |
get_segment_count | Previsualizar el recuento de suscriptores activos para un segmento. |
Para exportaciones de suscriptores, search_subscribers acepta listId, listName exacto o list (ID primero, luego nombre exacto). Si se omite limit, la herramienta obtiene todos los suscriptores coincidentes usando páginas de API de 100 filas.
Para la población masiva de listas, usa add_subscribers_to_list; el endpoint de la API subyacente es POST /api/v1/lists/{listId}/subscribers sin el sufijo /bulk:
{
"emails": ["[email protected]", "[email protected]"],
"duplicateStrategy": "skip",
"enrollInSequences": false,
"optInMode": "default"
}
Envía como máximo 500 emails por solicitud. Los límites de tasa estándar de la API aún se aplican: 100 solicitudes por minuto por clave API y 20 solicitudes por segundo de ráfaga. Para importaciones CLI basadas en CSV, las cabeceras de email aceptadas incluyen email, e-mail, email address y mail; si no existe una cabecera reconocida, la CLI lee la primera columna.
Los filtros de segmento soportan atributos, eventos, pertenencia a segmentos guardados, eventos de interacción, reglas de compra de productos de Stripe y reglas de compra de productos de comercio. Usa filterJoinOperator: "or" para segmentos de coincidencia con cualquiera, o pasa un grupo v2 root para lógica anidada.
Cada campo de filtro de segmento valida sus propios operadores:
status,segment:is,is_nottag:contains,not_contains,is_empty,is_not_emptyemail:contains,not_containsemailProvider,list:is,is_not,is_empty,is_not_emptyfirstName,lastName:contains,not_contains,is_empty,is_not_emptyadded:less_than,more_thanattribute:is,is_not,is_empty,is_not_empty,gte,lte,gt,lt,contains,not_containsevent, campos de interacción de email:is,is_not,at_least,less_than_countemailBounced: también soportais_temporary_bounce,is_permanent_bouncestripeProduct:is,is_not,at_least,less_than_countstripeCurrentProduct,stripeTrialProduct:is,is_not,gte,lte,gt,ltcommerceProduct:is,is_not,at_least,less_than_count
Ejemplos de filtro de producto de Stripe:
{ "field": "stripeProduct", "operator": "is", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "is_not", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "at_least", "value": "prod_pro:3" }
{ "field": "stripeProduct", "operator": "less_than_count", "value": "prod_pro:3" }
Los filtros de productos de comercio coinciden con productos comprados a través de pedidos de comercio. Los valores pueden ser provider:productId para IDs con ámbito de proveedor (shopify, woocommerce o api), un ID de producto simple para coincidir con cualquier proveedor, o provider:productId:count para operadores de umbral:
{ "field": "commerceProduct", "operator": "is", "value": "api:starter-kit" }
{ "field": "commerceProduct", "operator": "at_least", "value": "shopify:42:2" }
Los campos de interacción como emailSent, emailDelivered, emailOpened, emailClicked, emailBounced y emailComplained aceptan ventanas móviles como 7d, 30d, 90d, 180d, all, valores de umbral como 5:30d o un ámbito de campaña como campaign:cmp_123.
Sincronizaciones de Audiencia (Meta Ads)
| Herramienta | Descripción |
|---|---|
list_audience_syncs | Lista las sincronizaciones de segmento a audiencia con programación y último estado de sincronización. |
list_ad_accounts | Lista las cuentas publicitarias de Meta disponibles para sincronizar. |
create_audience_sync | Envía un segmento a una audiencia personalizada de Meta según una programación. |
update_audience_sync | Cambia la frecuencia de sincronización (hourly, daily, weekly) o pausa/reanuda. |
delete_audience_sync | Elimina una asignación de sincronización; la audiencia de Meta en sí se conserva. |
sync_audience_now | Activa una carga inmediata fuera de la programación regular. |
Requiere que la integración de Meta Ads esté conectada en el panel de Sequenzy (Configuración -> Integraciones). create_audience_sync acepta un segmento existente (segmentId) o una plantilla predefinida (predefinedSegmentId, por ejemplo zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged) - el segmento de plantilla se crea automáticamente en el primer uso, y la primera carga se ejecuta inmediatamente.
Las audiencias son solo de adición: los suscriptores que posteriormente abandonan el segmento permanecen en la audiencia de Meta. Meta requiere más de 100 personas coincidentes antes de que una audiencia pueda usarse para la entrega de anuncios.
Plantillas
| Herramienta | Descripción |
|---|---|
list_templates | Lista plantillas con estado de localización. |
get_template | Lee detalles de plantilla, contenido y variantes localizadas. |
create_template | Crea plantillas desde HTML o bloques de Sequenzy. |
update_template | Actualiza metadatos de plantilla, etiquetas, HTML o bloques. |
delete_template | Elimina una plantilla. |
Pruebas A/B
| Herramienta | Descripción |
|---|---|
list_ab_tests | Lista pruebas A/B y variantes, opcionalmente acotadas por secuencia. |
get_ab_test | Obtiene variantes, contenido y estado de localización. |
get_ab_test_stats | Obtiene estadísticas agregadas y por variante. |
restart_ab_test | Reinicia una prueba A/B detenida o completada. |
update_ab_test_variant | Actualiza el asunto, texto de vista previa, HTML o bloques de una variante en borrador. |
create_ab_test | Crea una prueba A/B de campaña o secuencia. |
add_ab_test_variant | Añade una variante a una prueba A/B existente. |
delete_ab_test_variant | Elimina una variante de prueba A/B en borrador. |
delete_ab_test | Elimina una prueba A/B. |
Usa get_ab_test para descubrir IDs de variante antes de editar. Las actualizaciones de variante aceptan html o blocks, no ambos.
Campañas
| Herramienta | Descripción |
|---|---|
list_campaigns | Lista campañas, opcionalmente filtradas por estado. |
get_campaign | Obtiene detalles y estadísticas de campaña. |
get_email_send | Inspecciona un registro de detalle de correo electrónico enviado. |
create_campaign | Crea una campaña en borrador desde HTML, bloques, una plantilla o datos de campaña. |
update_campaign | Actualiza una campaña en borrador, incluyendo datos de campaña y listas calculadas. |
schedule_campaign | Programa un borrador o reprograma una campaña programada existente. |
send_test_email | Envía un correo electrónico de prueba a una dirección. |
cancel_campaign | Cancela una campaña programada o en envío. |
pause_campaign | Pausa una campaña en envío. |
resume_campaign | Reanuda una campaña pausada, opcionalmente distribuyendo la entrega en el tiempo. |
delete_campaign | Elimina una campaña. |
duplicate_campaign | Duplica una campaña en un nuevo borrador. |
resend_campaign_to_non_openers | Crea un reenvío en borrador para los miembros de la audiencia original que no abrieron una campaña enviada. |
Páginas de Destino
| Herramienta | Descripción |
|---|---|
list_landing_pages | Lista páginas de destino con estado, métricas, contenido y URLs. |
get_landing_page | Obtiene detalles de página de destino, contenido del constructor, métricas y URLs públicas. |
create_landing_page | Crea una página de destino en borrador desde contenido de plantilla predeterminada o JSON. |
update_landing_page | Edita el nombre, slug o contenido completo compatible con el editor de una página de destino. |
publish_landing_page | Publica una página de destino, opcionalmente guardando ediciones primero. |
unpublish_landing_page | Devuelve una página de destino a estado de borrador, opcionalmente guardando ediciones primero. |
delete_landing_page | Elimina una página de destino no publicada. |
connect_landing_page_domain | Conecta un dominio personalizado de página de destino y devuelve detalles de configuración DNS. |
update_landing_page_domain_settings | Reemplaza o verifica la configuración del dominio personalizado de la página de destino. |
El contenido de la página de destino utiliza el esquema JSON compatible con el editor de Sequenzy con version, template, seo, theme y blocks. Los dominios personalizados de página de destino requieren un registro CNAME que apunte a pages.sequenzydns.com; llama a update_landing_page_domain_settings con verify: true después de que los cambios de DNS se propaguen.
Secuencias
| Herramienta | Descripción |
|---|---|
list_sequences | Lista secuencias de correo electrónico y estado de automatización. |
get_sequence | Obtiene detalles de secuencia, incluyendo paso nodeId, emailId vinculado, asunto, texto de vista previa y bloques. |
create_sequence | Crea secuencias generadas por IA o con pasos explícitos. |
update_sequence | Actualiza configuración de secuencia, comportamiento de inscripción, pasos existentes, lógica de rama o inserta pasos lineales. |
insert_sequence_step | Inserta un nuevo paso de correo electrónico, opcionalmente con un nodo de retraso antes. |
enable_sequence | Activa una secuencia. |
disable_sequence | Congela una secuencia, bloqueando nuevas inscripciones y reteniendo a los destinatarios actuales. |
pause_sequence_enrollments | Detiene nuevas inscripciones para una secuencia activa mientras los destinatarios actuales continúan. |
resume_sequence_enrollments | Reabre nuevas inscripciones para una secuencia activa sin cambiar a los destinatarios actuales. |
enroll_subscribers_in_sequence | Inscribe hasta 500 suscriptores por correo electrónico, ID de suscriptor o ambos, opcionalmente en un nodo objetivo. |
cancel_sequence_enrollments | Detiene inscripciones activas o en espera por valores de campo de suscriptor o evento de entrada. |
delete_sequence | Elimina una secuencia. |
La creación de secuencias admite:
trigger: "segment_entered"mássegmentIdpara automatizaciones de entrada de segmento guardado.trigger: "event_received"más etiquetas de combinación{{event.*}}en asuntos o contenido del cuerpo.trigger: "inactivity"máseventName,inactiveDaysyinactivityBaselineopcional (sequence_created_atosubscriber_created_at).goalpara contenido de correo electrónico generado por IA.stepsexplícito conblocksde Sequenzy.stepsexplícito con HTML, que Sequenzy convierte en bloques editables.- Esperas fijas mediante
delay/delayMs, o esperas de campo de fecha dinámica mediantewaitUntilpara recordatorios de renovación, seguimientos de citas, avisos de vencimiento de prueba y otras fechas específicas de eventos. - Pasos de acción de descuento que exponen etiquetas de combinación como
{{discount.code}}y{{discount.percentOff}}. enrollmentMode: "matching_field"yenrollmentFieldPathpara automatizaciones de eventos específicos de producto, variante, pedido o suscripción.
Las actualizaciones de secuencia admiten insertSteps para añadir nuevos pasos lineales después de un nodeId devuelto por get_sequence. Omite afterNodeId solo al añadir al final de una secuencia con exactamente una cola lineal. insertSteps admite pasos añadibles que no requieren registros complementarios, como correo electrónico, retraso, acciones de etiqueta/lista, actualizaciones de atributos, descuentos, condiciones, pasos de espera de evento y webhooks. Usa branch para ramas if/else de múltiples rutas; proporciona branch o insertSteps, no ambos. Las condiciones de rama admiten comprobaciones de presencia y ausencia de etiquetas con has_tag y does_not_have_tag, además de listas, segmentos guardados, eventos, enlaces clicados y comparaciones de campos. Los arrays emails y steps solo editan pasos de correo electrónico existentes por nodeId, emailId u orden de array; usa insertSteps para crear nuevos pasos e incluye un delay, delayMs o waitUntil a nivel de paso cuando el correo electrónico insertado necesite un temporizador. waitUntil acepta un campo de fecha del evento desencadenante más offset opcional, direction (before o after) y missingAction (continue o exit). Para secuencias activas, pasa confirmStructuralChange: true con insertSteps o branch solo después de confirmar el impacto en el flujo en vivo.
Ejecuta cancel_sequence_enrollments con dryRun: true antes de aplicar la cancelación masiva.
Estilo de Bloques de Correo Electrónico
Las herramientas que aceptan blocks persisten el estilo visual por bloque bajo el objeto styles de un bloque:
{
"type": "card",
"title": "Your update",
"content": "Everything is ready.",
"variant": "default",
"styles": {
"backgroundColor": "#f8fafc",
"backgroundOpacity": 85,
"borderColor": "#cbd5e1",
"borderWidth": 1,
"borderRadius": 12
}
}
Para compatibilidad con prompts de agentes más antiguos, también se aceptan claves de estilo de nivel superior como backgroundColor, backgroundOpacity, borderColor, borderWidth y borderRadius, y se guardan bajo styles.
Correo electrónico transaccional
| Herramienta | Descripción |
|---|---|
list_transactional_emails | Listar plantillas transaccionales y slugs de API. |
get_transactional_email | Leer un correo transaccional por ID o slug. |
create_transactional_email | Crear una plantilla de correo transaccional. |
update_transactional_email | Actualizar metadatos transaccionales o contenido del cuerpo. |
send_email | Enviar un único correo transaccional por plantilla o HTML. |
Las variables send_email admiten arrays anidados para bloques repetidos, como { "event": { "items": [...] } }.
Analíticas
| Herramienta | Descripción |
|---|---|
get_stats | Obtener estadísticas generales de 7d, 30d o 90d. |
get_campaign_stats | Obtener rendimiento detallado de la campaña. |
get_sequence_stats | Obtener rendimiento de la secuencia. |
list_campaign_events | Listar eventos de correo sin procesar paginados para una campaña. |
list_sequence_events | Listar eventos de correo sin procesar paginados para una secuencia. |
get_subscriber_activity | Obtener estadísticas de correo del suscriptor, actividad e inscripciones. |
Las herramientas de analíticas excluyen por defecto las aperturas/clics de bots, escáneres, vistas previas de enlaces y activos rastreados detectados. Pase includeMachineEngagement: true a get_stats, get_campaign_stats, get_sequence_stats, get_ab_test_stats, get_subscriber o get_subscriber_activity cuando necesite diagnósticos de interacción sin procesar; las filas de actividad de apertura/clic incluidas exponen los campos machine, engagementQuality y classificationReasons donde la API devuelve actividad a nivel de evento.
Equipo, Bandeja de entrada, Webhooks
| Herramienta | Descripción |
|---|---|
list_team_members | Listar miembros del equipo e invitaciones pendientes. |
invite_team_member | Invitar a un compañero como administrador o visualizador, con acceso de facturación opcional. |
cancel_team_invitation | Cancelar una invitación de equipo pendiente. |
list_conversations | Listar conversaciones de respuesta de suscriptores con filtros de estado y no leídos. |
get_conversation | Leer una conversación y su historial de mensajes. |
reply_to_conversation | Enviar una respuesta saliente o añadir una nota interna. |
update_conversation_status | Abrir o cerrar una conversación. |
mark_conversation_read | Marcar todos los mensajes de una conversación como leídos. |
list_webhooks | Listar endpoints de webhook salientes. |
create_webhook | Crear un webhook saliente y devolver su secreto de firma de un solo uso. |
update_webhook | Actualizar nombre, URL, eventos o estado del webhook. |
delete_webhook | Eliminar permanentemente un endpoint de webhook y su historial de entregas. |
test_webhook | Enviar un evento de prueba a un endpoint de webhook. |
list_webhook_deliveries | Listar intentos de entrega recientes para un webhook. |
replay_webhook_delivery | Reenviar una entrega de webhook. |
Generación con IA
| Herramienta | Descripción |
|---|---|
generate_email | Generar bloques de correo a partir de un prompt. |
generate_sequence | Generar una secuencia de múltiples correos a partir de un objetivo. |
generate_subject_lines | Generar variantes de asunto para pruebas A/B. |
El contenido generado se devuelve como contenido de borrador para su revisión.
Recursos
El servidor también expone recursos MCP de solo lectura.
| Recurso | Descripción |
|---|---|
sequenzy://dashboard | Estadísticas generales en vivo de los últimos 7 días. |
sequenzy://company | Configuración actual de la empresa y localización. |
sequenzy://campaigns/recent | Últimas 10 campañas con estado y estadísticas básicas. |
sequenzy://subscribers/recent | Suscriptores añadidos más recientemente. |
sequenzy://subscribers/engaged | Suscriptores más activos o comprometidos. |
sequenzy://sequences | Todas las secuencias con estado. |
sequenzy://templates | Plantillas con estado de localización. |
sequenzy://segments | Segmentos guardados con recuentos de suscriptores. |
sequenzy://tags | Etiquetas con recuentos de uso. |
sequenzy://health | Métricas de entregabilidad y estado de salud. |
sequenzy://app-routes | Plantillas de ruta del panel y pestañas de configuración. |
Ejemplos de Prompts
Add [email protected] with tags "vip" and "developer", then put them on the beta list.
Create a 4-email churn prevention sequence for users whose subscription expires soon. Leave it in draft mode.
Create a segment for subscribers who bought Stripe product prod_pro at least 3 times.
Draft a campaign about our new analytics dashboard, target the Pro users segment, and send a test to me.
How did the last campaign perform compared with the one before it?
Seguridad
- Use claves API personales, no secretos de equipo compartidos.
- Las claves solo acceden a las empresas a las que su usuario de Sequenzy puede acceder.
- Revocar las claves desde Configuración -> Claves API cuando el acceso ya no sea necesario.
- Mantener habilitados los prompts de aprobación del cliente para envíos, programaciones, eliminaciones y cambios masivos.
- Preferir flujos de trabajo de borrador para campañas y secuencias, luego revisar en Sequenzy antes del lanzamiento.
Solución de problemas
SEQUENZY_API_KEY environment variable is required
Establezca SEQUENZY_API_KEY en la configuración del cliente MCP, o ejecute:
npx @sequenzy/setup
Clave API no válida
Cree una nueva clave personal en Configuración -> Claves API, actualice su configuración MCP y reinicie el cliente.
Recursos duplicados
Si una llamada de herramienta fuera a crear un nombre de segmento o dominio de envío duplicado, el servidor devuelve un code estable, un description amigable para el agente, un resolution concreto y un docsUrl. Para segmentos, llame a list_segments y reutilice el ID de segmento existente o elija un nombre diferente. Para sitios web, llame a list_websites; si el dominio no está listado para la empresa seleccionada, pertenece a otra empresa o cuenta y debe ser eliminado, reasignado o reemplazado por un dominio de envío diferente.
Las herramientas no aparecen
- Confirme que
npxesté disponible en el entorno que utiliza el cliente. - Reinicie el cliente MCP después de editar la configuración.
- Verifique que la configuración esté en la ubicación correcta específica del cliente.
Problemas de red o URL de API
El servidor utiliza https://api.sequenzy.com por defecto. Si lo anula, verifique que SEQUENZY_API_URL apunte a una URL base de API de Sequenzy accesible.
Desarrollo
bun install
bun test
bun run type-check
bun run build
Los esquemas de herramientas MCP deben permanecer compatibles con clientes estrictos:
- Las raíces de
inputSchemade herramientas deben ser esquemastype: "object"planos. - No publique
anyOfen ningún lugar de los esquemas de herramientas. - No coloque
oneOf,allOf,enumonoten la raíz de un esquema de herramienta. - Aplique requisitos condicionales en los manejadores y cúbralos con pruebas.
Este repositorio independiente refleja el paquete MCP mantenido en el monorepo principal de Sequenzy. Consulte AGENTS.md para las reglas de sincronización.
Licencia
MIT
Descubrimiento nativo para agentes
Sequenzy publica manifiestos legibles por máquina para redes de agentes y descubrimiento estilo A2A:
- Endpoint MCP remoto:
https://api.sequenzy.com/v1/mcp - Manifiesto de capacidad del agente:
agent-capability.json - Tarjeta de agente estilo A2A:
.well-known/agent-card.json - Metadatos de habilidad OpenClaw/Moltbot:
openclaw/skill.json - Guía operativa OpenClaw/Moltbot:
openclaw/SKILL.md
Estos archivos describen a Sequenzy como una capacidad autorizada de automatización de correo electrónico para agentes. Excluyen explícitamente los casos de uso de scraping, spam y difusión en frío no solicitada.