{"protocolVersion":"0.3.0","name":"Postari","description":"Email marketing y correo transaccional, AI-native. Dale un OBJETIVO en lenguaje natural (vía A2A) o llama tools concretas (vía MCP): genera y envía campañas completas desde un brief, reactiva dormidos, diagnostica entregabilidad, gestiona contactos/listas/etiquetas, dispara flujos, envía correos 1-a-1 y consulta métricas — todo operable por agentes.","url":"https://postari.io/api/a2a","preferredTransport":"JSONRPC","additionalInterfaces":[{"transport":"JSONRPC","url":"https://postari.io/api/a2a"},{"transport":"mcp-streamable-http","url":"https://postari.io/api/mcp"}],"version":"1.0.0","provider":{"organization":"Postari","url":"https://postari.io"},"iconUrl":"https://postari.io/brand/postari-logo.png","documentationUrl":"https://postari.io/desarrolladores","privacyPolicyUrl":"https://postari.io/privacidad","termsOfServiceUrl":"https://postari.io/terminos","capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"API key del tenant: Authorization: Bearer ef_live_xxx (scopes read/write/send/admin). También OAuth 2.1 + PKCE para conexión 1-clic (ver /.well-known/oauth-authorization-server)."}},"security":[{"bearer":[]}],"skills":[{"id":"send_transactional_email","name":"send_transactional_email","description":"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`.","tags":["write","sensitive"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_subscriber","name":"create_subscriber","description":"Crea o actualiza (upsert) un contacto/suscriptor. Si ya existe, lo actualiza sin duplicar.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"get_subscriber","name":"get_subscriber","description":"Busca un contacto por su correo y devuelve sus datos, estado, etiquetas e historial básico.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"update_subscriber","name":"update_subscriber","description":"Actualiza datos de un contacto existente (nombre, país, teléfono, etiquetas).","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"list_lists","name":"list_lists","description":"Lista todas las listas de contactos del tenant con su nombre y conteo.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_list","name":"create_list","description":"Crea una nueva lista de contactos.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"add_subscriber_to_list","name":"add_subscriber_to_list","description":"Añade un contacto (por email o contact_id) a una lista.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"tag_subscribers","name":"tag_subscribers","description":"Añade o quita una etiqueta a varios contactos (por emails o contact_ids).","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"trigger_flow","name":"trigger_flow","description":"Mete un contacto (por email o contact_id) en un flujo automático para que reciba esa secuencia.","tags":["write","sensitive"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"account_stats","name":"account_stats","description":"Métricas globales de la cuenta (enviados, entregados, aperturas únicas, clics únicos, bajas, rebotes) en un rango de fechas.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"list_campaigns","name":"list_campaigns","description":"Lista las campañas/correos del tenant. Filtrable por estado (draft, scheduled, sending, sent).","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"get_campaign_stats","name":"get_campaign_stats","description":"Métricas reales de una campaña (enviados, aperturas únicas/totales, clics, rebotes, bajas, ingresos).","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"launch_campaign","name":"launch_campaign","description":"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).","tags":["write","sensitive"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"diagnose_deliverability","name":"diagnose_deliverability","description":"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.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"get_agent_activity","name":"get_agent_activity","description":"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ó.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_launch","name":"create_launch","description":"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).","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"list_launches","name":"list_launches","description":"Lista los lanzamientos de la cuenta, con cuántas etapas tiene cada uno y cuántas ya están conectadas a un correo.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"get_launch","name":"get_launch","description":"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.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"link_campaign_to_launch_stage","name":"link_campaign_to_launch_stage","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_flow","name":"create_flow","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"update_flow","name":"update_flow","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"test_flow","name":"test_flow","description":"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.","tags":["write","sensitive"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"activate_flow","name":"activate_flow","description":"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).","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"arm_flow","name":"arm_flow","description":"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.","tags":["write","sensitive"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"list_flow_emails","name":"list_flow_emails","description":"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.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"update_flow_email","name":"update_flow_email","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_form","name":"create_form","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"update_form","name":"update_form","description":"Edita un formulario: título, campos, lista donde caen las altas, doble opt-in, mensaje de gracias o activarlo/desactivarlo.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_segment","name":"create_segment","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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_template","name":"create_template","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_tag","name":"create_tag","description":"Crea una etiqueta (idempotente: si ya existe devuelve la que hay, no la duplica).","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"create_landing","name":"create_landing","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"list_landings","name":"list_landings","description":"Lista las páginas de aterrizaje con sus visitas, conversiones y tasa de conversión.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"update_landing","name":"update_landing","description":"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).","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"set_campaign_audience","name":"set_campaign_audience","description":"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.","tags":["write"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"get_campaign_audience","name":"get_campaign_audience","description":"¿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.","tags":["read"],"inputModes":["application/json"],"outputModes":["application/json"]}]}