Servidor MCP de SendHQ

Qué es este servidor

El servidor MCP de SendHQ permite que un agente de IA opere un espacio de trabajo de SendHQ mediante el Model Context Protocol: enviar correo (individual, por lotes, con plantilla, respuestas, adjuntos, reintentos idempotentes), leer y buscar el correo enviado y recibido (asuntos, cuerpos y nombres de adjuntos) y sus eventos de entrega, organizar el correo en etiquetas con reglas de archivado automático, gestionar borradores y adjuntos privados, crear y publicar plantillas alojadas, agregar y verificar dominios y su DNS, configurar la recepción de correo entrante y las direcciones de entrada, inspeccionar la entregabilidad, los rebotes, las quejas y las supresiones, y consultar el uso de la cuenta, el estado de facturación, las analíticas y los metadatos de las claves de API.

Es un servidor stdio local integrado en el binario de la CLI sendhq. Su cliente MCP inicia sendhq mcp como proceso hijo y se comunica mediante JSON-RPC por stdin/stdout. Cada llamada a una herramienta se convierte en una solicitud documentada a la API REST de SendHQ en https://sendhq.cc/api/v1, autenticada con la clave de API de su espacio de trabajo, de modo que el servidor MCP tiene exactamente los permisos de esa clave y ninguno más.

• 59 herramientas en 8 grupos, generadas a partir de un único catálogo que también se publica como tools.json.
• JSON Schemas estrictos: los argumentos desconocidos, los tipos incorrectos y los campos obligatorios ausentes se rechazan localmente antes de que nada llegue a SendHQ.
• Errores estructurados con un code estable, el status HTTP, una explanation, un remedy concreto y la indicación de si reintentar puede ayudar.
• Toda herramienta que envía correo real o destruye datos lo indica en las primeras palabras de su descripción y lleva anotaciones de seguridad de MCP.
• El modo --read-only oculta todas las herramientas que envían o modifican datos.
• No se registra nada. stdout transporta solo mensajes del protocolo; la clave de API y el contenido de los mensajes nunca llegan a un log.

Usar SendHQ en Claude y ChatGPT

Sin instalación: SendHQ también ejecuta este servidor como conector alojado en https://mcp.sendhq.cc/mcp, con las mismas herramientas. Usted inicia sesión con su cuenta de SendHQ en lugar de pegar una clave.

Claude

1. Abra Settings → Connectors y busque SendHQ en el directorio, o elija Add custom connector y pegue https://mcp.sendhq.cc/mcp.
2. Haga clic en Connect, inicie sesión en SendHQ, revise el acceso y haga clic en Allow.
3. Pídale a Claude que revise su bandeja de entrada, que envíe un correo desde su dominio verificado o que le explique un rebote.

ChatGPT

1. Open Settings → Security and login and turn on Developer mode.
2. Go to chatgpt.com/plugins, click Create MCP app, name it SendHQ and enter https://mcp.sendhq.cc/mcp.
3. Sign in to SendHQ and click Allow, then pick SendHQ from the tools menu in a new chat.

Muse by Meta

In Muse, open Connectors and search for SendHQ. Click Connect, sign in to SendHQ and click Allow.

Aprobación y desconexión

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• Las herramientas que envían correo real o eliminan datos están etiquetadas como tales. Si el asistente le pregunta primero o no se configura por herramienta en el propio asistente: en Claude, elija Needs approval para esas herramientas en Settings → Connectors → SendHQ.
• El conector obtiene su propia clave de API, con el nombre del asistente (por ejemplo, “Claude (AI connector)”). Elimínela en API Keys para desconectarlo de inmediato.
• No puede crear ni revocar claves de API ni modificar la facturación. Los adjuntos se envían y se devuelven en base64; no hay acceso a archivos locales.
• Los espacios de trabajo sin pago (prueba de integración) solo pueden entregar al correo de la cuenta o a una dirección del simulador de AWS SES.

Preguntas: postmaster@sendhq.cc. Privacidad: sendhq.cc/privacy.

Instalación

Instale el binario sendhq (Linux, macOS y Windows en x86-64 y arm64). El instalador verifica el checksum de la versión y coloca el binario en ~/.local/bin de forma predeterminada.

curl -fsSL https://downloads.sendhq.cc/install.sh | sh

irm https://downloads.sendhq.cc/install.ps1 | iex

sendhq version
SENDHQ_API_KEY=re_your_key sendhq doctor

Cree una clave de API en el panel, en https://sendhq.cc/app#/keys. El servidor MCP no puede crear claves. El único comando que ejecuta el servidor es:

SENDHQ_API_KEY=re_your_key sendhq mcp

Normalmente nunca lo ejecuta a mano: lo inicia el cliente MCP. Si se ejecuta en una terminal, espera JSON-RPC por stdin.

Configurar su cliente

Claude Code

claude mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp

# read-only variant
claude mcp add sendhq-readonly --env SENDHQ_API_KEY=re_your_key -- sendhq mcp --read-only

Agregue --scope user para que esté disponible en todos los proyectos, o --scope project para escribirlo en el .mcp.json del proyecto. En un .mcp.json compartido, haga referencia a la clave desde el entorno en lugar de confirmarla en el repositorio; Claude Code expande ${VAR} en .mcp.json.

{
  "mcpServers": {
    "sendhq": {
      "command": "sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "${SENDHQ_API_KEY}"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.sendhq]
command = "sendhq"
args = ["mcp"]
env = { SENDHQ_API_KEY = "re_your_key" }

O desde la línea de comandos: codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp.

Claude Desktop

Edite claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) y reinicie la aplicación. Las aplicaciones de escritorio no heredan el PATH de su shell, así que use la ruta absoluta del binario (which sendhq).

{
  "mcpServers": {
    "sendhq": {
      "command": "/Users/you/.local/bin/sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "re_your_key"
      }
    }
  }
}

Cualquier otro cliente MCP

Configure un servidor stdio con el comando sendhq, los argumentos ["mcp"] (opcionalmente "--read-only") y las variables de entorno que se indican a continuación. El servidor admite las versiones del protocolo MCP 2024-11-05, 2025-03-26, 2025-06-18 y 2025-11-25, e implementa initialize, ping, tools/list y tools/call. Los resultados de las herramientas incluyen tanto un bloque de texto JSON como structuredContent.

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_service_health","arguments":{}}}

No existe un transporte HTTP alojado para el servidor con alcance de cuenta. Un endpoint MCP remoto con capacidad de escritura necesitaría OAuth por usuario, que SendHQ no ofrece; el binario local mantiene la clave en la máquina que ya la tiene.

Entorno y flags

La clave se envía únicamente como encabezado Authorization: Bearer a la URL base configurada. Nunca se imprime, se registra, se repite en los errores ni se incluye en los resultados de las herramientas.

Modelo de seguridad para agentes

• Envía correo real. send_email, send_batch y send_template_test entregan correo a personas reales y consumen créditos de entrega. Sus descripciones empiezan por SENDS REAL EMAIL. Llámelas solo cuando el usuario haya pedido explícitamente que se envíe ese mensaje concreto, con los destinatarios, el remitente y el contenido confirmados.
• Destructivas. delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox y remove_suppression están marcadas con destructiveHint: true y sus descripciones empiezan por DESTRUCTIVE. Confirme primero con el usuario. remove_suppression debilita un bloqueo de seguridad y solo es apropiada cuando una persona confirma que la dirección vuelve a funcionar.
• Cambian el estado. Crear o actualizar borradores, plantillas, dominios y bandejas de entrada, publicar plantillas e iniciar la verificación modifican el espacio de trabajo, pero no envían correo.
• Solo lectura. Todo lo demás es readOnlyHint: true y se puede llamar libremente.
• Este servidor nunca modifica el DNS. add_domain devuelve registros para que una persona los publique; get_domain_connect_link devuelve una URL de consentimiento que una persona debe abrir y aprobar en su proveedor de DNS.
• Este servidor nunca modifica la facturación. get_account solo lee el plan, el uso y el estado de la suscripción.
• Los espacios de trabajo sin pago (prueba de integración) solo pueden entregar al correo del propietario de la cuenta (get_account → user.email) o a una dirección del simulador de AWS SES, como success@simulator.amazonses.com, y no pueden enviar adjuntos.
• Aceptado no significa entregado. Un envío correcto devuelve un ID; las evidencias de entrega, rebote y queja llegan más tarde en list_email_events. Nunca afirme que un mensaje llegó a la bandeja de entrada ni que una persona lo leyó.
• No cambie a otra dirección From para eludir una pausa 423, y nunca vuelva a agregar destinatarios que se hayan dado de baja o que hayan presentado una queja.

Las claves de API quedan fuera del alcance

Por diseño, no hay herramientas que creen, modifiquen, roten, revoquen o eliminen claves de API. Un agente no debe emitir ni destruir credenciales. list_api_keys devuelve solo nombres, prefijos no secretos y fechas de último uso. La gestión de claves se hace en el panel, con una persona que haya iniciado sesión.

Flujos de trabajo

1. Primer envío

1. get_service_health confirma que la API es accesible (funciona sin clave).
2. get_account muestra el plan (access.tier), la cuota restante y user.email. En la prueba, ese correo es el único destinatario real permitido.
3. list_sending_identities enumera las direcciones From que puede usar. Si está vacía, complete primero el flujo de dominio.
4. Confirme con el usuario el remitente, el destinatario, el asunto y el cuerpo; después llame a send_email con una idempotency_key.
5. list_email_events con el id devuelto muestra delivery, bounce, complaint o reject en cuanto el proveedor lo notifica (normalmente entre unos segundos y unos minutos).

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "SendHQ is connected",
    "text": "It works.",
    "idempotency_key": "first-send-2026-09-26"
  }
}

2. Verificación de dominios de principio a fin

1. add_domain con name: "example.com". El resultado incluye los registros DNS (CNAME de DKIM, verificación de SES, SPF y el DMARC recomendado).
2. get_dns_provider con el domain_id detecta el proveedor de DNS autoritativo y devuelve el host relativo exacto que hay que introducir para cada registro en ese proveedor.
3. Si providers.domainConnect.available es true, get_domain_connect_link devuelve una URL de consentimiento. Entréguesela a la persona; no cambia nada hasta que la apruebe en el proveedor. En caso contrario, entréguele los registros que debe publicar. Nunca publique un segundo registro SPF: combine include:amazonses.com con el valor v=spf1 existente.
4. verify_domain vuelve a comprobar el DNS y SES. El estado pasa por pending, checking y propagating hasta verified. Consulte verify_domain o get_domain cada 30–60 segundos; el DNS puede tardar de minutos a horas.
5. Cuando status es verified, las direcciones del dominio aparecen en list_sending_identities.

3. Rebotes, quejas y supresiones

1. list_blocked_recipients devuelve todas las direcciones bloqueadas con su motivo (bounce, complaint, unsubscribe) y un recuento resumido.
2. list_suppressions devuelve las supresiones por rebote permanente y por queja; deliverability_stats ofrece las tasas de entrega, rebotes y quejas de 30 días; list_sender_reputation muestra qué direcciones From tienen el envío limitado o en pausa.
3. Un envío que contiene un destinatario suprimido falla con 422 recipient_suppressed. Quite ese destinatario y vuelva a enviar.
4. Llame a remove_suppression solo cuando una persona confirme que un buzón que rebotaba ahora funciona. Las supresiones por queja son permanentes (409 complaint_suppression_locked).

4. Recibir correo entrante

1. El dominio (a menudo un subdominio como inbound.example.com) debe estar verificado.
2. setup_inbound habilita la recepción y devuelve un registro MX. Una persona lo publica.
3. verify_inbound hasta que status sea ready.
4. create_inbox con domain_id y local_part (por ejemplo, support) crea support@inbound.example.com.
5. Consulte periódicamente list_emails con direction: "in" y unread: true (opcionalmente inbox_id). Lea un mensaje con get_email, su conversación con get_thread y los adjuntos con download_attachment, y márquelo como atendido con mark_email (read: true).
6. Responda dentro del hilo con send_email y reply_to_email_id; SendHQ establece In-Reply-To, References y el hilo.

5. Webhooks y notificaciones de eventos

Actualmente SendHQ no ofrece webhooks configurables por el cliente, por lo que no hay ninguna herramienta de webhooks. Las notificaciones del proveedor se procesan dentro de SendHQ y se exponen mediante lecturas. En su lugar, consulte periódicamente: list_email_events para el resultado de un mensaje, list_emails con status (por ejemplo, bounced) o after para los cambios recientes, list_emails con direction: "in" y unread: true para el correo entrante nuevo, y list_blocked_recipients para las supresiones nuevas. No consulte más de una vez por minuto, aproximadamente, para cada pregunta.

6. Diagnosticar un fallo de entrega

1. Localice el mensaje: list_emails con direction: "out" y to o query, o get_email si tiene el ID. status: failed significa que SendHQ o el proveedor lo rechazó en el envío; el error del correo explica el motivo.
2. list_email_events: bounce (permanente o transitorio, con el diagnóstico del proveedor), complaint, reject o delivery. Si aún no hay eventos, el proveedor no ha informado; espere y vuelva a comprobar.
3. Si la propia llamada de envío falló, lea el code del error: sender_domain_unverified → termine la verificación del dominio; recipient_suppressed → la dirección ya tuvo un rebote permanente o una queja; sender_paused → revise list_sender_reputation y corrija el origen de la lista; trial_recipient_restricted → límites de la prueba; quota_exhausted → uso en get_account.
4. get_domain comprueba que DKIM, SPF y DMARC siguen publicados; deliverability_stats muestra si el problema es de un solo mensaje o una tendencia.
5. Informe lo que muestran las evidencias. Un evento delivery significa que el servidor del destinatario aceptó el mensaje, no que llegó a la bandeja de entrada ni que se leyó.

7. Encargarse de una categoría de tareas (etiquetas)

1. create_label con name (por ejemplo, Agent/Orders) y skip_inbox: true. Eso convierte la etiqueta en una categoría: el correo recibido que la obtiene se archiva, de modo que aparece solo en la etiqueta y nunca en la bandeja de entrada de la persona.
2. Envíe el correo de la tarea con send_email (o send_batch) y labels: ["Agent/Orders"]. Las respuestas a esa conversación heredan la etiqueta automáticamente y no pasan por la bandeja de entrada.
3. Para el correo que empieza fuera de sus conversaciones, agregue una regla de archivado: create_label_rule con inbox_id (una dirección dedicada como orders@…), from, to o subject. Pase apply_to_existing: true para archivar el correo ya recibido.
4. Trabaje la categoría: list_emails con label: "Agent/Orders", direction: "in" y unread: true; lea con get_email o get_thread, responda con send_email y reply_to_email_id, y use mark_email read: true cuando lo haya atendido.
5. Mueva un mensaje suelto hacia dentro o fuera con label_email (add / remove). Agregar una etiqueta de categoría a un mensaje recibido también lo archiva.
6. Opcionalmente, set_inbox_forwarding envía una copia de todo lo que recibe una dirección de recepción a otro buzón (el destino lo confirma primero por correo).

{
  "name": "send_email",
  "arguments": {
    "from": "Orders <orders@example.com>",
    "to": [
      "customer@example.net"
    ],
    "subject": "Order 1042: confirm delivery window",
    "text": "Reply with a time that works.",
    "labels": [
      "Agent/Orders"
    ],
    "idempotency_key": "order-1042-window"
  }
}

8. Adjuntos y plantillas

Adjunte hasta 10 archivos con attachments de send_email (cada uno necesita content_base64 o un file_path local; filename toma por defecto el nombre base del archivo) en un plan de pago. Para las plantillas alojadas: create_template → update_template_draft → render_template para previsualizar con datos de ejemplo → send_template_test (envía una prueba real) → publish_template; después envíe con send_email o send_batch usando template: {key, data} y exactamente un destinatario to.

Resultados, paginación y errores

Una llamada correcta devuelve el objeto JSON de la API como structuredContent y como bloque de texto JSON. Toda herramienta list_* acepta limit (1–200, valor predeterminado 50) y offset, y agrega un objeto pagination. Siga llamando con offset: pagination.next_offset mientras has_more sea true.

{
  "data": [
    "…"
  ],
  "count": 50,
  "pagination": {
    "offset": 0,
    "limit": 50,
    "returned": 50,
    "total": 180,
    "has_more": true,
    "next_offset": 50
  }
}

Una llamada fallida devuelve isError: true con un error estructurado. Siga el remedy en lugar de reintentar a ciegas; reintente solo cuando retryable sea true.

{
  "error": {
    "code": "trial_recipient_restricted",
    "status": 402,
    "message": "The integration trial can deliver only to your account email or an AWS SES simulator address",
    "retryable": false,
    "explanation": "This workspace is on the unpaid integration trial. Trial sends can be delivered only to the account owner's email address or an AWS SES simulator address.",
    "remedy": "Send to the account email (get_account -> user.email) or a simulator address such as success@simulator.amazonses.com to test. To email anyone else, the account owner must activate a paid plan in the dashboard (Profile & Billing). Do not retry the same recipients."
  }
}

Campos de error opcionales: request_id (indíquelo al soporte), retry_after_seconds, problems (lista de infracciones del esquema para invalid_arguments) e idempotent_replayed (consulte Idempotencia).

Idempotencia

send_email y send_batch aceptan idempotency_key (máximo 200 caracteres), que se envía como encabezado Idempotency-Key. Genere una clave estable por cada mensaje lógico, por ejemplo invoice-4812-receipt.

• Un reintento debe reutilizar la misma clave Y un cuerpo de solicitud idéntico. La misma clave con cualquier cambio (destinatario, asunto, cuerpo, encabezado, datos de plantilla, incluso valores de argumentos) devuelve 409 idempotency_conflict.
• Misma clave, mismo cuerpo y el original ya terminado: SendHQ devuelve el resultado almacenado sin volver a enviar. Así se reintenta de forma segura después de un timeout o de un network_error.
• Misma clave mientras el original sigue en curso: 409 idempotency_in_progress, que se puede reintentar tras una breve espera.
• Un mensaje lógico nuevo necesita una clave nueva.
• Los fallos almacenados también se reproducen. Si el primer intento falló, reintentar con la misma clave devuelve ese mismo fallo con idempotent_replayed: true y retryable: false. Revise list_emails (direction: out) para confirmar que no salió nada, corrija la causa y después envíe con una clave nueva.
• El servidor nunca reintenta un POST por su cuenta. Solo las llamadas GET de solo lectura se reintentan automáticamente (hasta 3 intentos ante errores de red, 429 y 5xx).
• send_email con attachments en línea no admite una idempotency_key, porque ejecuta varias solicitudes. Para envíos con adjuntos seguros ante reintentos: create_draft → upload_attachment → send_email con draft_id e idempotency_key.

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <billing@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Receipt #4812",
    "text": "Thanks for your payment.",
    "idempotency_key": "receipt-4812"
  }
}

Límites de frecuencia y cuotas

SendHQ no publica un límite fijo de solicitudes por segundo para la API. Los límites con los que realmente se encuentra un agente son límites de uso, que se devuelven como 429:

• Entregas mensuales a destinatarios por plan. Cada dirección To, Cc y Bcc cuenta como una entrega. Consulte get_account → usage.recipientDeliveries frente a usage.emailQuotaMonth.
• Destinatarios diarios por dirección From exacta, según el estado de reputación de ese remitente (list_sender_reputation → dailyLimit, 2.000 de forma predeterminada en los planes de pago).
• Prueba de integración: 100 destinatarios en total, solo al correo de la cuenta o a direcciones del simulador de SES.
• Adjuntos: como máximo 10 archivos y 10 MB por mensaje; 10 GB al mes de transferencia de adjuntos ponderada por destinatario en los planes de pago.
• Por solicitud: To + Cc + Bcc hasta 100 direcciones; send_batch hasta 100 mensajes.
• Cortacircuitos de reputación: en una ventana móvil de 7 días, los rebotes o las quejas por encima del umbral limitan o pausan una dirección From (423 sender_paused). Se recupera automáticamente cuando las tasas bajan.

quota_exhausted no se puede reintentar hasta que se reinicie el periodo o cambie el plan. rate_limited se puede reintentar después de retry_after_seconds; en los envíos, reintente con la misma idempotency_key y un cuerpo idéntico.

Catálogo de errores

code es estable; ramifique su lógica en función de él y no de message.

Referencia de herramientas

Cada herramienta con su clase de seguridad, el endpoint REST al que llama, sus parámetros, la estructura de respuesta y un objeto params de tools/call de ejemplo. Los parámetros son exactos: el servidor rechaza todo lo que no esté en la lista.

Correos e hilos: send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
Etiquetas y reglas de archivado automático: list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
Borradores, adjuntos e identidades de remitente: list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
Plantillas alojadas: list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
Dominios y DNS: list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
Correo entrante: setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
Entregabilidad, rebotes y supresiones: deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
Cuenta, uso, analíticas y claves: get_account, get_analytics, list_api_keys, get_service_health

Ninguna herramienta coincide con este filtro.

Correos e hilos

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Your export is ready",
    "text": "Download it from your dashboard.",
    "idempotency_key": "export-ready-42"
  }
}

{
  "name": "send_batch",
  "arguments": {
    "emails": [
      {
        "from": "Acme <hello@example.com>",
        "to": [
          "owner@example.com"
        ],
        "template": {
          "key": "account-welcome",
          "data": {
            "first_name": "Asha"
          }
        }
      }
    ],
    "idempotency_key": "welcome-batch-2026-09-26"
  }
}

{
  "name": "list_emails",
  "arguments": {
    "direction": "in",
    "unread": true,
    "limit": 25
  }
}

{
  "name": "get_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "mark_email",
  "arguments": {
    "email_id": "em_123",
    "read": true
  }
}

{
  "name": "delete_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "list_email_events",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "get_thread",
  "arguments": {
    "thread_id": "em_123"
  }
}

Etiquetas y reglas de archivado automático

{
  "name": "list_labels",
  "arguments": {}
}

{
  "name": "get_label",
  "arguments": {
    "label_id": "Billing"
  }
}

{
  "name": "create_label",
  "arguments": {
    "name": "Agent/Orders",
    "skip_inbox": true,
    "rules": [
      {
        "from": "@stripe.com"
      }
    ]
  }
}

{
  "name": "update_label",
  "arguments": {
    "label_id": "lbl_123",
    "name": "Finance/Billing"
  }
}

{
  "name": "delete_label",
  "arguments": {
    "label_id": "lbl_123"
  }
}

{
  "name": "create_label_rule",
  "arguments": {
    "label_id": "Billing",
    "inbox_id": "inb_123",
    "skip_inbox": true
  }
}

{
  "name": "delete_label_rule",
  "arguments": {
    "label_id": "lbl_123",
    "rule_id": "lrule_123"
  }
}

{
  "name": "label_email",
  "arguments": {
    "email_id": "em_123",
    "add": [
      "Billing"
    ],
    "remove": [
      "Support"
    ]
  }
}

Borradores, adjuntos e identidades de remitente

{
  "name": "list_sending_identities",
  "arguments": {}
}

{
  "name": "create_draft",
  "arguments": {
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice"
  }
}

{
  "name": "list_drafts",
  "arguments": {}
}

{
  "name": "get_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "update_draft",
  "arguments": {
    "draft_id": "dr_123",
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice (updated)",
    "text": "Attached."
  }
}

{
  "name": "delete_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "upload_attachment",
  "arguments": {
    "draft_id": "dr_123",
    "filename": "invoice.pdf",
    "content_type": "application/pdf",
    "file_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "download_attachment",
  "arguments": {
    "attachment_id": "att_123",
    "save_to_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "delete_attachment",
  "arguments": {
    "attachment_id": "att_123"
  }
}

Plantillas alojadas

{
  "name": "list_templates",
  "arguments": {
    "lifecycle": "active"
  }
}

{
  "name": "create_template",
  "arguments": {
    "name": "Account welcome",
    "key": "account-welcome",
    "starter": "welcome"
  }
}

{
  "name": "get_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "update_template_draft",
  "arguments": {
    "template_id": "account-welcome",
    "revision": 3,
    "name": "Account welcome",
    "subject_template": "Welcome, {{first_name}}",
    "text_template": "Hi {{first_name}}",
    "variables": [
      {
        "key": "first_name",
        "type": "text",
        "required": true
      }
    ],
    "sample_data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "create_template_draft",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "render_template",
  "arguments": {
    "template_id": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "send_template_test",
  "arguments": {
    "template_id": "account-welcome",
    "to": [
      "owner@example.com"
    ]
  }
}

{
  "name": "publish_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "archive_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "restore_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

Dominios y DNS

{
  "name": "list_domains",
  "arguments": {}
}

{
  "name": "get_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "add_domain",
  "arguments": {
    "name": "example.com"
  }
}

{
  "name": "verify_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "delete_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_dns_provider",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_domain_connect_link",
  "arguments": {
    "domain_id": "dom_123"
  }
}

Correo entrante

{
  "name": "setup_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "verify_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "list_inboxes",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

{
  "name": "create_inbox",
  "arguments": {
    "domain_id": "dom_123",
    "local_part": "support",
    "name": "Support"
  }
}

{
  "name": "update_inbox",
  "arguments": {
    "inbox_id": "inb_123",
    "status": "disabled"
  }
}

{
  "name": "set_inbox_forwarding",
  "arguments": {
    "inbox_id": "inb_123",
    "forward_to": "team@example.net"
  }
}

{
  "name": "delete_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

Entregabilidad, rebotes y supresiones

{
  "name": "deliverability_stats",
  "arguments": {}
}

{
  "name": "list_sender_reputation",
  "arguments": {}
}

{
  "name": "list_suppressions",
  "arguments": {}
}

{
  "name": "remove_suppression",
  "arguments": {
    "email": "fixed-mailbox@example.net"
  }
}

{
  "name": "list_blocked_recipients",
  "arguments": {}
}

Cuenta, uso, analíticas y claves

{
  "name": "get_account",
  "arguments": {}
}

{
  "name": "get_analytics",
  "arguments": {
    "days": 30
  }
}

{
  "name": "list_api_keys",
  "arguments": {}
}

{
  "name": "get_service_health",
  "arguments": {}
}

Inventario de cobertura de la API

Cada operación de la API pública y la herramienta que la cubre. Todo lo que un usuario puede hacer en el panel y que tiene API está cubierto; las exclusiones que se indican abajo son deliberadas.

No disponible deliberadamente

Catálogo legible por máquinas: /docs/mcp/tools.json (esquemas, anotaciones, correspondencia con endpoints, exclusiones). Versión Markdown de esta página: /docs/mcp.md. Con la CLI instalada, sendhq commands --format json imprime el mismo catálogo.