MCP server
Irisend's REST API is also exposed as a remote MCP server at /mcp, so a coding agent can send mail, check on it, and diagnose a bounce without glue code.
Connect
The fastest way in is the dashboard: open /mcp, choose a client, pick exactly which permissions to grant from the scope catalogue below (or a preset — send-only, read-only, or full setup), and get a one-time connection key plus ready-to-paste config.
Under the hood it authenticates the same way as the REST API — a Bearer token — but a connection key made this way carries its own explicit scopes (emails:send, domains:write, audiences:read, and so on) instead of the REST API's coarse full_access/sending_access split, and only ever works at /mcp — it is rejected everywhere else on the REST API. A regular full_access key still works here too (every scope); a sending_access key maps to just emails:send.
claude mcp add --transport http irisend https://api.irisend.com/mcp \
--header "Authorization: Bearer ir_xxxx"Any other MCP client that supports Streamable HTTP takes the same URL and header in its own config format:
{
"mcpServers": {
"irisend": {
"type": "http",
"url": "https://api.irisend.com/mcp",
"headers": { "Authorization": "Bearer ir_xxxx" }
}
}
}Tools
Every tool is team-scoped and runs through the exact same guardrails (quota, domain verification, suppression checks) as the matching REST endpoint — a tool call can never bypass them. A failed call comes back as a tool error carrying the same name/message pair as the REST API's own errors (see Errors). explain_bounce's successful result is plain human-readable prose, not JSON — every other tool returns a JSON-stringified object.
| Tool | What it does |
|---|---|
| send_email | Send an email. Goes through the same validation, quota, domain-verification, and suppression handling as POST /emails. Requires the emails:send scope. |
| list_emails | List this team's emails, newest first. Requires emails:read. |
| get_email | Retrieve one email by id, including its full event timeline. Requires emails:read. |
| explain_bounce | Translate an email's bounce, complaint, failure, or suppression event into a plain-language explanation and a fix. Requires emails:read. |
| list_domains | List this team's sending domains. Requires domains:read. |
| get_domain | Retrieve one domain by id or name — status, DNS records, reputation. Requires domains:read. |
| check_domain_health | 0-100 health score for a domain from bounce/complaint reputation and a live DNS check. Requires domains:read. |
| create_domain | Register a sending domain and get back the DNS records to publish. Requires domains:write. |
| verify_domain | Check a domain's DNS now and (re)start automatic verification. Requires domains:write. |
| list_received_emails | List inbound email this team has received. Requires inbound:read. |
| get_received_email | Retrieve one received email with attachments. Requires inbound:read. |
| list_audiences | List this team's contact audiences. Requires audiences:read. |
| create_audience | Create a new, empty audience. Requires audiences:write. |
| list_contacts | List every contact in one audience. Requires audiences:read. |
| add_contact | Add or update a contact in an audience. Requires audiences:write. |
| list_templates | List this team's email templates. Requires templates:read. |
| get_template | Retrieve one template's current content. Requires templates:read. |
| list_suppressions | List addresses this team can never send to. Requires suppressions:read. |
| add_suppression | Block an address from receiving further email. Requires suppressions:write. |