# MailerSend — how to use (mcp.ai)

Connect your MailerSend account and use 23 tools for transactional email straight from your AI agent. Connect with your own API key. MailerSend is a transactional email service designed for developers to integrate email sending capabilities into their applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mailersend?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mailersend_create_domain`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mailersend`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mailersend/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mailersend/create/domain` — Tool to add a new sending domain to MailerSend. Use when you need to register and configure a domain before sending emails.
  - body: { name: string, return_path_subdomain?: string, custom_tracking_subdomain?: string, inbound_routing_subdomain?: string }
- `POST https://api.mcp.ai/api/mailersend/create/smtp/user` — Tool to create a new SMTP user. Use after domain setup to obtain SMTP credentials.
  - body: { name: string, enabled?: boolean, domain_id: string }
- `POST https://api.mcp.ai/api/mailersend/create/token` — Creates a new API token with specified scopes (permissions) for a domain. The token allows programmatic access to MailerSend API endpoints based on granted scopes. WARNING: The token value is only dis
  - body: { name: string, scopes: string[], domain_id: string }
- `POST https://api.mcp.ai/api/mailersend/create/webhook` — Tool to create a new webhook for a MailerSend domain. Use after you have a domain ID and need to receive event notifications like sent, delivered, opened, etc.
  - body: { url: string, name: string, events: string[], enabled?: boolean, version?: integer, domain_id: string }
- `POST https://api.mcp.ai/api/mailersend/delete/webhook` — Tool to delete an existing webhook. Use when the webhook is no longer needed. Returns empty response on successful deletion (HTTP 204).
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/mailersend/get/api/quota` — Tool to retrieve current API usage quota. Use when monitoring API rate limits to avoid exceeding allowed calls.
- `POST https://api.mcp.ai/api/mailersend/get/domain` — Tool to retrieve detailed information about a specific sending domain in MailerSend. Returns domain verification status (DKIM, SPF, MX, tracking), settings (click/open tracking, paused status), and me
  - body: { domain_id: string }
- `POST https://api.mcp.ai/api/mailersend/get/domain/recipients` — Tool to list recipients for a domain. Use after obtaining the domain ID to view recipients with optional pagination.
  - body: { page?: integer, limit?: integer, domain_id: string }
- `POST https://api.mcp.ai/api/mailersend/get/domains` — Retrieve a paginated list of all sending domains configured in your MailerSend account. Use this to: - View all domains available for sending emails - Check domain verification and DNS status - Filter
  - body: { page?: integer, limit?: integer, verified?: boolean }
- `POST https://api.mcp.ai/api/mailersend/get/general/resources` — Tool to retrieve general API resources and information. Use when you need an overview of all MailerSend endpoints before constructing specific calls.
- `POST https://api.mcp.ai/api/mailersend/get/identities` — Retrieves a paginated list of sender identities configured in your MailerSend account. Sender identities are the email addresses or domains authorized to send emails through MailerSend. Each identity 
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/mailersend/get/messages` — Tool to retrieve a paginated list of sent messages. Use after sending emails to view message logs.
  - body: { page?: integer, limit?: integer, date_to?: string, date_from?: string }
- `POST https://api.mcp.ai/api/mailersend/get/recipients` — Tool to retrieve a list of email recipients. Use when you need to list and filter recipients by list ID or search term.
  - body: { page?: integer, limit?: integer, search?: string, list_id?: string }
- `POST https://api.mcp.ai/api/mailersend/get/sms/activity` — Tool to retrieve SMS activity logs. Use when you need to fetch delivery status and logs of sent SMS messages.
  - body: { page?: integer, limit?: integer, status?: string[], date_to?: integer, date_from?: integer, sms_number_id?: string }
- `POST https://api.mcp.ai/api/mailersend/get/sms/inbounds` — Retrieve inbound SMS route configurations. Inbound routes define rules for forwarding incoming SMS messages to webhook URLs based on message content filters. Use this action when you need to: - List a
  - body: { page?: integer, limit?: integer, enabled?: boolean, sms_number_id?: string }
- `POST https://api.mcp.ai/api/mailersend/get/sms/messages` — Retrieves a paginated list of SMS messages sent through the MailerSend API. Returns message details including sender, recipients, content, status, and timestamps. Use this to review sent SMS messages 
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/mailersend/get/sms/numbers` — Tool to retrieve a paginated list of SMS phone numbers. Use after purchasing numbers to fetch available SMS numbers.
  - body: { page?: integer, limit?: integer, paused?: boolean }
- `POST https://api.mcp.ai/api/mailersend/get/sms/recipients` — Tool to retrieve a list of SMS recipients. Use when you need to list and paginate SMS recipients, optionally filtering by SMS number ID and/or recipient status.
  - body: { page?: integer, limit?: integer, status?: string, sms_number_id?: string }
- `POST https://api.mcp.ai/api/mailersend/get/smtp/users` — Tool to retrieve a list of SMTP users. Use when you need to list and paginate SMTP users.
  - body: { page?: integer, limit?: integer, domain_id: string }
- `POST https://api.mcp.ai/api/mailersend/get/templates` — Retrieves a paginated list of email templates from your MailerSend account. Use this tool when you need to: - List all available email templates - Filter templates by domain ID - Browse templates with
  - body: { page?: integer, limit?: integer, domain_id?: string }
- `POST https://api.mcp.ai/api/mailersend/get/tokens` — Retrieves a paginated list of API tokens associated with your MailerSend account. Returns token details including ID, name, status, creation date, and assigned scopes/permissions. Requires 'tokens_ful
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/mailersend/get/users` — Tool to retrieve a list of users associated with your account. Use after authenticating with a valid API token.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/mailersend/get/webhooks` — Tool to retrieve a list of webhooks. Use when you need to list and paginate all configured webhooks, optionally filtering by domain.
  - body: { page?: integer, limit?: integer, domain_id?: string }

## Example prompts
- "What can I do in MailerSend?"
- "Show me a summary of my MailerSend account"

## More
- Page: https://mcp.ai/mailersend
- Agent spec (llms.txt): https://mcp.ai/mailersend/llms.txt
- Postman collection: https://mcp.ai/mailersend/postman.json