Postari

Official13 tools

by wilmendezofficial

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

Create and manage email campaigns, transactional emails, and contact workflows.

Captured live from the server via tools/list.

send_transactional_email

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`.

Parameters (6)

to_emailstringrequired
Correo del destinatario.
template_idstring
ID de la plantilla en Postari (opcional si mandas subject+html_body).
subjectstring
Asunto (opcional si la plantilla lo trae).
html_bodystring
HTML libre (opcional, alternativa a template_id).
variablesobject
Variables mustache {{var}} para rellenar la plantilla. Ej: {"first_name":"María"}.
from_namestring
Nombre del remitente (opcional).

create_subscriber

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

Parameters (7)

emailstringrequired
Correo del contacto (requerido).
first_namestring
last_namestring
countrystring
Código ISO de país, ej "CO".
phonestring
tagsarray
Etiquetas a aplicar.
metadataobject
Campos personalizados.

get_subscriber

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

Parameters (1)

emailstringrequired
Correo a buscar.

update_subscriber

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

Parameters (6)

emailstringrequired
first_namestring
last_namestring
countrystring
phonestring
tagsarray

list_lists

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

No parameters.

create_list

Crea una nueva lista de contactos.

Parameters (2)

namestringrequired
Nombre de la lista.
descriptionstring

add_subscriber_to_list

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

Parameters (3)

list_idstringrequired
ID de la lista.
emailstring
contact_idstring

tag_subscribers

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

Parameters (4)

tagstringrequired
Nombre de la etiqueta.
operationstring
add (default) o remove.
emailsarray
contact_idsarray

trigger_flow

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

Parameters (4)

flow_idstringrequired
ID del flujo.
emailstring
contact_idstring
trigger_dataobject

account_stats

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

Parameters (2)

fromstring
Fecha inicio YYYY-MM-DD (opcional).
tostring
Fecha fin YYYY-MM-DD (opcional).

list_campaigns

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

Parameters (2)

statusstring
Filtro de estado (opcional).
limitnumber
1-500, default 20.

get_campaign_stats

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

Parameters (1)

campaign_idstringrequired
ID de la campaña.

launch_campaign

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).

Parameters (13)

briefstring
Qué comunicar, en lenguaje natural. Ej: "Black Friday 30% OFF en todos los cursos, tono urgente, cierra el viernes". Postari escribe el correo.
list_idstringrequired
UUID de la lista destino (usa list_lists para verlas).
goalstring
Objetivo opcional: ventas, reactivación, anuncio, evento…
tonestring
Tono opcional: cálido, urgente, divertido, profesional…
cta_urlstring
URL del botón principal (opcional).
cta_labelstring
Texto del botón (opcional).
subjectstring
Asunto exacto (opcional · si lo das, no se genera).
blocksarray
Bloques de contenido propios (opcional · alternativa a brief).
html_bodystring
HTML libre (opcional · alternativa a brief/blocks).
from_namestring
Nombre del remitente (opcional).
scheduled_atstring
ISO8601 para agendar el envío (opcional · requiere confirm_send).
variablesobject
Variables mustache {{var}} (opcional).
confirm_sendboolean
false (default) = solo borrador + preview, no envía. true = ENVÍA de verdad a la lista (requiere scope send + que el tenant tenga habilitados los envíos por agente).

Install

Tools (13)

send_transactional_emailcreate_subscriberget_subscriberupdate_subscriberlist_listscreate_listadd_subscriber_to_listtag_subscribers

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://postari.io/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "postari": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://postari.io/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.