# MailSlurp — MCP server on mcp.ai
> Connect your MailSlurp account and use 14 tools for email straight from your AI agent. Connect with your own API key. MailSlurp provides programmable email and SMS inboxes, sending, testing, webhooks, and deliverability tools through a REST API.

By: mcp.ai · official
Page: https://mcp.ai/mailslurp

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_mailslurp?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/mailslurp/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/mailslurp/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/mailslurp/skill.md
Postman collection (v2.1): https://mcp.ai/mailslurp/postman.json

## Tools
- mailslurp_create_inbox(name?: string, tags?: string[], prefix?: string, domain_id?: string, favourite?: boolean, expires_at?: string, expires_in?: integer, inbox_type?: string, description?: string, domain_name?: string, email_address?: string, virtual_inbox?: boolean, use_domain_pool?: boolean, use_short_address?: boolean) — Create a MailSlurp HTTP or SMTP inbox. HTTP inboxes are the default and can send and receive; SMTP inboxes are receive-only.
- mailslurp_delete_inbox(inbox_id: string) — Permanently delete one MailSlurp inbox by UUID, including its email address and all emails it contains. This destructive action cannot be undone.
- mailslurp_get_account_info() — Return the connected MailSlurp account identity, state, account type, subscription type, and creation time. Use this to check account availability before attempting quota- or plan-sensitive operations
- mailslurp_get_email(email_id: string) — Get one fully hydrated received email by UUID, including parsed headers, body content, recipients, and attachment IDs. Fetching hydrated content may mark the email as read.
- mailslurp_get_inbox(inbox_id: string) — Get one MailSlurp inbox by UUID, including its email address, type, labels, and lifecycle state.
- mailslurp_list_contact_groups(size?: integer, sort?: string, since?: string, before?: string, next_cursor?: string) — List saved MailSlurp contact groups with optional creation-time filters. Returns one page and a continuation cursor.
- mailslurp_list_contacts(size?: integer, sort?: string, since?: string, before?: string, search?: string, next_cursor?: string) — List saved MailSlurp contacts with optional search and creation-time filters. Returns one page and a continuation cursor.
- mailslurp_list_domains() — List custom domains configured for the connected MailSlurp account, including identifiers, domain type, and DNS verification state.
- mailslurp_list_emails(size?: integer, sort?: string, since?: string, before?: string, inbox_id?: string, favourited?: boolean, next_cursor?: string, unread_only?: boolean, search_filter?: string, plus_address_id?: string) — List received emails across the account or one selected inbox with unread, exact-search, favorite, plus-address, and time filters. Returns one page and a continuation cursor.
- mailslurp_list_inboxes(tag?: string, size?: integer, sort?: string, since?: string, before?: string, search?: string, domain_id?: string, favourite?: boolean, inbox_type?: string, next_cursor?: string) — List MailSlurp inboxes with optional search, tag, type, domain, favorite, and creation-time filters. Returns one page and a continuation cursor.
- mailslurp_list_sent_emails(size?: integer, sort?: string, since?: string, before?: string, inbox_id?: string, next_cursor?: string, search_filter?: string) — List sent-email records, optionally filtered by source inbox, exact identifier/address search, and creation time. Returns one page and a continuation cursor.
- mailslurp_list_templates(size?: integer, sort?: string, since?: string, before?: string, next_cursor?: string) — List saved MailSlurp email templates with optional creation-time filters. Returns one page and a continuation cursor without large template bodies.
- mailslurp_send_email(cc?: string[], to?: string[], bcc?: string[], body?: string, is_html?: boolean, subject?: string, inbox_id: string, reply_to?: string, contact_ids?: string[], template_id?: string, attachment_ids?: string[], use_inbox_name?: boolean, contact_group_id?: string, add_tracking_pixel?: boolean, template_variables?: object, filter_bounced_recipients?: boolean) — Send an email from a specific MailSlurp inbox to addresses, saved contacts, or one contact group. Supports plain text or HTML, uploaded attachment IDs, and saved templates. The legacy endpoint confirm
- mailslurp_update_inbox(name?: string, tags?: string[], inbox_id: string, favourite?: boolean, expires_at?: string, description?: string) — Update an inbox's name, description, tags, expiration, or favorite status. Provide at least one field to update. The inbox email address cannot be changed.

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

## Links
Docs: https://mcp.ai/docs/mcps/mailslurp
Website: https://mcp.ai/mcps/mailslurp