mcp server

postari

Email marketing y transaccional AI-native: campañas, correos 1-a-1, contactos, flujos y métricas.

Description as published by the maintainer. Source

• version 1.0.0
• active

active — Registry entry last updated 2026-06-22.

What this server can do

36 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

account_stats(to, from)

Métricas globales de la cuenta (enviados, entregados, aperturas únicas, clics únicos, bajas, rebotes) en un rango de fechas.

activate_flow(paused, flow_id)

Pone la automatización en servicio (status active) o la pausa con paused:true. OJO: activar NO hace que envíe — para eso hace falta armarla (arm_flow). Required: flow_id.

add_subscriber_to_list(email, list_id, contact_id)

Añade un contacto (por email o contact_id) a una lista. Required: list_id.

arm_flow(confirm, flow_id, acknowledge_no_list_filter)

ARMA la automatización: a partir de aquí envía correos REALES sola. Exige confirm:"ARMAR ENVIOS" literal, haber probado el flujo antes, y que la cuenta permita envíos por agente. NO es retroactivo: solo entra quien cumpla el disparador de ahora en adelante. Required: flow_id, confirm.

create_flow(name, graph, trigger_type, trigger_config)

Crea una automatización. NACE EN BORRADOR Y DESARMADA: no envía nada hasta que se pruebe, se active y se arme a propósito. El `graph` es el mismo formato que devuelve get_flow. Required: name.

create_form(name, fields, list_id, display_mode, double_optin, thank_you_message)

Crea un formulario de captación y devuelve su URL pública y su código para embeber. Si no pasas campos, lleva uno de correo. Required: name.

create_landing(kind, name, slug, blocks, form_id, ai_prompt, html_code, iframe_url, external_url)

Crea una página de aterrizaje y devuelve su URL pública. `kind`: blocks (bloques de Postari) · code (HTML propio) · ai (desde un prompt) · iframe · external_url. Conéctale un formulario con form_id para que capte suscriptores. Required: name, slug.

create_launch(kind, name, stages, ends_at, starts_at, seed_default_stages, target_revenue_cents)

Crea un LANZAMIENTO (curso, infoproducto, evento…) con sus etapas: es la unidad que agrupa los correos de una campaña con fechas. Si no pasas `stages` y el tipo es curso/infoproducto, siembra 8 etapas estándar (lead magnet → webinar → apertura de carrito → cierre). Required: name.

create_list(name, description)

Crea una nueva lista de contactos. Required: name.

create_segment(name, definition, description)

Crea un segmento: una regla de "quién entra" que se recalcula sola. Es lo que se usa para segmentar un lanzamiento sin duplicar listas. Required: name, definition.

create_subscriber(tags, email, phone, country, metadata, last_name, first_name)

Crea o actualiza (upsert) un contacto/suscriptor. Si ya existe, lo actualiza sin duplicar. Required: email.

create_tag(name, color)

Crea una etiqueta (idempotente: si ya existe devuelve la que hay, no la duplica). Required: name.

create_template(name, blocks, subject, category, preheader, description, from_template_id)

Crea una plantilla propia de la cuenta, opcionalmente duplicando una del catálogo con from_template_id. Las del catálogo son compartidas y no se editan. Required: name.

diagnose_deliverability

Diagnóstico de ENTREGABILIDAD de la cuenta (últimos 28 días): rebotes, quejas de spam, aperturas y salud del dominio (DNS). Devuelve un veredicto (sano/a_vigilar/en_riesgo) + acciones priorizadas. Úsalo antes de un envío grande o si los correos no llegan.

get_agent_activity(limit)

Transparencia "qué hizo la IA": lista las acciones de la cuenta originadas por un agente/IA (chat Atelier, API de agente, A2A) — qué se hizo, sobre qué y cuándo. Para auditar lo que un agente ejecutó.

get_campaign_audience(campaign_id)

¿A cuánta gente le va a llegar este correo? Devuelve los destinatarios REALES aplicando el filtro guardado, ANTES de enviar: base de la lista, cuántos quita la exclusión y el total final. Required: campaign_id.

get_campaign_stats(campaign_id)

Métricas reales de una campaña (enviados, aperturas únicas/totales, clics, rebotes, bajas, ingresos). Required: campaign_id.

get_launch(launch_id)

Un lanzamiento con sus etapas y las MÉTRICAS REALES de cada una (enviados, aperturas y clics de personas únicas) más el total. Es la forma de saber cómo va un lanzamiento. Required: launch_id.

get_subscriber(email)

Busca un contacto por su correo y devuelve sus datos, estado, etiquetas e historial básico. Required: email.

launch_campaign(goal, tone, brief, blocks, cta_url, list_id, subject, cta_label, from_name, html_body, variables, confirm_send, scheduled_at)

AGÉNTICA · Lanza una campaña de correo COMPLETA desde un brief en lenguaje natural. Postari GENERA el correo (asunto + diseño con la voz y el color de marca del tenant), lo arma sobre una lista y devuelve un BORRADOR con preview (preview_html). Por defecto NO envía: para enviar de verdad, vuelve a llamar con los mismos campos + confirm_send:true (o scheduled_at para agendar). Es la forma de "dile el objetivo y Postari lo logra". Requiere scope `write` (borrador) o `send` (enviar). Required: list_id.

link_campaign_to_launch_stage(title, status, stage_id, launch_id, campaign_id, scheduled_at)

Conecta un correo YA ESCRITO a una etapa del lanzamiento (o lo desconecta con campaign_id null). Sin esto la etapa no mide nada: sus KPIs dependen de este vínculo. También sirve para cambiar título, fecha o estado de la etapa. Required: launch_id, stage_id.

list_campaigns(limit, status)

Lista las campañas/correos del tenant. Filtrable por estado (draft, scheduled, sending, sent).

list_flow_emails(flow_id)

Los correos de una automatización, cada uno con su node_id, su asunto y su URL propia para compartir con el cliente. Antes estos correos no tenían dirección: vivían enterrados en el flujo. Required: flow_id.

list_landings(limit)

Lista las páginas de aterrizaje con sus visitas, conversiones y tasa de conversión.

list_launches(limit, status)

Lista los lanzamientos de la cuenta, con cuántas etapas tiene cada uno y cuántas ya están conectadas a un correo.

list_lists

Lista todas las listas de contactos del tenant con su nombre y conteo.

send_transactional_email(subject, to_email, from_name, html_body, variables, template_id)

Envía un correo transaccional 1-a-1 (cotización, recibo, bienvenida, recordatorio) a UNA dirección, usando una plantilla y variables. Síncrono. Requiere scope `send`. Required: to_email.

set_campaign_audience(campaign_id, exclude_tags, include_tags, exclude_lists, tag_on_delivery, exclude_campaigns)

Define A QUIÉN se le manda un correo y a quién NO: excluir por etiqueta, por lista entera o por haber recibido otra campaña. Devuelve el número REAL de destinatarios para confirmar antes de enviar. Si alguna referencia no existe, falla con 400 en vez de guardar a medias. Required: campaign_id.

tag_subscribers(tag, emails, operation, contact_ids)

Añade o quita una etiqueta a varios contactos (por emails o contact_ids). Required: tag.

test_flow(flow_id, to_email)

Prueba una automatización enviándola de verdad a UN miembro de la cuenta (por defecto el dueño). Es OBLIGATORIO antes de armar. No se puede usar para mandar correo a terceros: to_email tiene que ser de un miembro. Required: flow_id.

trigger_flow(email, flow_id, contact_id, trigger_data)

Mete un contacto (por email o contact_id) en un flujo automático para que reciba esa secuencia. Required: flow_id.

update_flow(name, armed, graph, status, flow_id, trigger_config)

Edita una automatización: nombre, disparador, pasos (graph) o estado. NO sirve para armar (eso es arm_flow, que exige confirmación); sí para DESARMAR con armed:false. Required: flow_id.

update_flow_email(label, blocks, flow_id, node_id, subject, preheader)

Edita UN correo de una automatización (asunto, preheader, bloques o etiqueta) sin tocar el resto del flujo. Más seguro que reescribir el graph entero. Required: flow_id, node_id.

update_form(name, fields, form_id, list_id, is_active, double_optin, redirect_url, thank_you_message)

Edita un formulario: título, campos, lista donde caen las altas, doble opt-in, mensaje de gracias o activarlo/desactivarlo. Required: form_id.

update_landing(name, slug, blocks, form_id, ai_prompt, html_code, is_active, landing_id)

Edita una página de aterrizaje: contenido, slug, formulario conectado o activarla/desactivarla. Cambiar el slug rompe la URL que ya se haya compartido (la respuesta avisa). Required: landing_id.

update_subscriber(tags, email, phone, country, last_name, first_name)

Actualiza datos de un contacto existente (nombre, país, teléfono, etiquetas). Required: email.

Last successful function declaration observed on 2026-08-13. Source: https://postari.io/api/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://postari.io/api/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/wilmendezofficial/postari
• Website — https://postari.io
• Remote endpoint (streamable-http) — https://postari.io/api/mcp