SadaSend

npx add-mcp 'https://mcp.sadasend.com'

Comienza aquí

Cuatro conceptos fundamentales que vale la pena leer antes que cualquier otra cosa.

• Inicio rápido: instala, configura una clave, envía. Menos de diez líneas.
• Salvaguardas: alcances, listas de permitidos de destinatarios, restricciones de IP CIDR, fechas de expiración y modo de aprobación.
• Procedencia de Agente y Canal: seguimiento nativo para Claude, Cursor y bots backend personalizados sin cambios de código.
• Configuración de dominio: los cuatro registros DNS (SPF, DKIM, DMARC, MX) y para qué sirve cada uno.
• Etiquetado de Campañas UTM: inyección nativa de parámetros UTM en enlaces de correo con preservación de anclas y consultas.

Cuatro formas de conectarse

SadaSend proporciona cuatro protocolos de ingreso de primera clase según el origen de tus correos:

• SDK de Cliente Oficiales [EN VIVO]: Bibliotecas de cliente sin dependencias (sadasend en npm y PyPI) están en vivo con resultados de unión discriminada, auto-idempotencia y salvaguardas aplicadas por el servidor. Instala mediante npm install sadasend o pip install sadasend. Consulta la guía de SDK.

• Protocolo de Contexto de Modelo (MCP) [EN VIVO Y DESTACADO]: Herramientas nativas para asistentes de codificación con IA y agentes autónomos (Google Antigravity, Cursor, Cline, Claude Desktop, Windsurf, Claude Code CLI, OpenCode y ChatGPT/Codex). Alojado en https://mcp.sadasend.com con HTTP/SSE transmisible y 12 herramientas completas de correo. Aprende más en la guía de MCP.

• API RESTful: JSON limpio y predecible sobre HTTPS para aplicaciones web, microservicios y backends sin servidor (https://api.sadasend.com/emails). Explora la referencia de API.

• Relé SMTP: Relé de integración sin código para WordPress, WooCommerce, Supabase Auth, Laravel y clientes de correo estándar (smtp.sadasend.com:587). Lee la guía de relé SMTP.

URL base y autenticación

Cada solicitud se autentica con un token de portador. Las claves están limitadas por entorno y tienen sus propios límites, listas de permitidos de IP, fechas de expiración y etiquetas de persona.

POST https://api.sadasend.com/v1/emails
Authorization: Bearer sada_live_sk_…
Idempotency-Key: 6f1c2a80-…
X-SadaSend-Agent: SupportBot
X-SadaSend-Source: agent
Content-Type: application/json

{
  "from": "notifications@yourdomain.com",
  "to": "user@example.com",
  "cc": ["team@example.com"],
  "bcc": ["archive@yourdomain.com"],
  "subject": "Your receipt",
  "html": "<p>Thank you for your order.</p>",
  "agent_name": "SupportBot",
  "source": "agent"
}

Modos y prefijos de claves de API

El prefijo de la clave te indica su modo antes de que la solicitud llegue a la red:

• En vivo (sada\_live\_sk\_…\): Envío normal de producción. Despacha correos directamente a los buzones receptores.

• Aprobación (sada\_agent\_sk\_…\): Modo humano en el circuito para agentes de IA autónomos. Cada envío se retiene en pending_approval hasta que se revise y apruebe en tu panel de control.

• Prueba (sada\_test\_sk\_…\): Modo de integración y CI. Valida esquemas y plantillas sin enviar correos reales.

Procedencia de Canal y Agente

Cada correo aceptado por SadaSend se etiqueta automáticamente con su canal de ingreso (mcp, sdk, api, smtp), fuente de persona de envío (agent, backend, automation, system) e identificador de agente opcional.

La procedencia brinda a tu equipo una observabilidad completa de la entregabilidad. Puedes filtrar el registro de Actividad de Correo por nombre de agente, inspeccionar tarjetas de origen en el panel de detalles del correo y revisar la salud de entregabilidad del agente y las tasas de rebote en los análisis de tu panel de control.

// Ingress channels supported
"channel": "mcp" | "sdk" | "api" | "smtp"

// Sending persona sources
"source": "agent" | "backend" | "automation" | "system"

// Agent identifier (up to 128 characters)
"agent_name": "Claude 3.7 Assistant"

Límites de velocidad y encabezados de cuota

Cada respuesta de API emite encabezados estándar de límite de velocidad y cuota, lo que permite a los clientes y SDK rastrear las asignaciones en tiempo real:

Encabezado	Descripción
X-RateLimit-Limit	Volumen máximo de destinatarios permitido en la ventana de límite de velocidad activa de la clave.
X-RateLimit-Remaining	Capacidad restante de destinatarios en la ventana de límite de velocidad activa.
X-RateLimit-Reset	Segundos hasta que se restablezca el depósito actual de límite de velocidad.
Retry-After	Segundos a esperar antes de reintentar cuando se limita con HTTP 429.
X-Quota-Limit	Cuota total mensual de correos incluida en tu plan de cuenta actual.
X-Quota-Used	Número de correos enviados durante el período de facturación mensual actual.
X-Quota-Reset	Marca de tiempo ISO 8601 cuando se restablece la cuota mensual de correos de tu plan de cuenta.
X-Quota-Overage	Número de correos enviados que exceden la cuota del plan (facturados a la tarifa estándar de excedente).

El dominio de espacio aislado de incorporación

Cada cuenta nueva puede enviar inmediatamente desde onboarding.sadasend.com sin configurar registros DNS primero.

Para proteger la reputación compartida entre todos los clientes, el espacio aislado tiene un límite de por vida de 100 mensajes por cuenta. Agregar y verificar tu propio dominio de envío personalizado elimina este límite por completo.

Errores

Los errores devuelven un código legible por máquina y un mensaje legible por humanos. Ambos siempre están presentes.

{
  "error": "recipient_not_allowlisted",
  "message": "Key allowlist is [@example.com]. Recipient is outside it.",
  "docs": "https://www.sadasend.com/docs/errors#recipient_not_allowlisted"
}