Mailrith Email Marketing
REMOTE · API.MAILRITH.COM · 2 COMPONENTS · SCANNED SEP 20
Manage Subscribers, Broadcasts, Sequences, Automations, and reporting in Mailrith.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security91
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability85
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 5947 tokens (~104/item across 57 items; 55 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety96
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 6 of 7 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "broadcasts_get_send_progress" implies "send" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Partial
- An AI judge read all 57 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Mailrith Email Marketing MCP server?
Mailrith Email Marketing is a hosted endpoint at https://api.mailrith.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · api.mailrith.com
claude mcp add --transport http com-mailrith-mailrith 'https://api.mailrith.com/mcp'
{
"mcpServers": {
"com-mailrith-mailrith": {
"url": "https://api.mailrith.com/mcp"
}
}
} {
"servers": {
"com-mailrith-mailrith": {
"type": "http",
"url": "https://api.mailrith.com/mcp"
}
}
} [mcp_servers.com-mailrith-mailrith] url = "https://api.mailrith.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-mailrith-mailrith": {
"type": "remote",
"url": "https://api.mailrith.com/mcp",
"enabled": true
}
}
} openclaw mcp add com-mailrith-mailrith --url 'https://api.mailrith.com/mcp' --transport streamable-http
mcp_servers:
com-mailrith-mailrith:
url: "https://api.mailrith.com/mcp" {
"McpServers": {
"com-mailrith-mailrith": {
"Transport": "http",
"Url": "https://api.mailrith.com/mcp"
}
}
} assistant mcp add com-mailrith-mailrith -t streamable-http -u 'https://api.mailrith.com/mcp'
{
"mcpServers": {
"com-mailrith-mailrith": {
"type": "http",
"url": "https://api.mailrith.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 0
- DNSSEC: fail → pass ▲ security
- 5 Sept 26 0
- Server version: 1.1.0 → 1.1.1 functional
- 31 Aug 26 +1
- Stability: 0.97 → pass security
- 30 Aug 26 −1
- Stability: pass → 0.97 functional
- 29 Aug 26 +1
- Stability: 0.97 → pass security
- 27 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 26 Aug 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 25 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Probed https://api.mailrith.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mailrith.com | CN=WE1,O=Google Trust Services,C=US | 17 Sept 2026 | 16 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | da4b1af87cc48e7f0ef66a7755ddb4b7 |
| SANs: mailrith.com, *.mailrith.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC secure
Validation of api.mailrith.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| mailrith.com. | present | 2371 | 13 | Verified |
| api.mailrith.com. | Verified address RRset verified with the apex keys |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer realm="mailrith", error="invalid_token", error_description="Authentication is required before calling Mailrith tools.", resource_metadata="https://api.mailrith.com/.well-known/oauth-protected-resource/mcp", scope="analytics:read live_actions:write subscribers:read subscribers:write subscribers:import subscribers:export segments:read segments:write tags:read tags:write forms:read forms:write form_submissions:read landing_pages:read landing_pages:write landing_page_submissions:read broadcasts:read broadcasts:write sequences:read sequences:write magic_links:read magic_links:write automations:read automations:write workspace:read email_delivery_connections:read email_delivery_connections:write email_templates:read email_templates:write custom_fields:read custom_fields:write webhooks:read webhooks:write"
Bearer realm="mailrith", error="invalid_token", error_description="Authentication is required before calling Mailrith tools.", resource_metadata="https://api.mailrith.com/.well-known/oauth-protected-resource/mcp", scope="analytics:read live_actions:write subscribers:read subscribers:write subscribers:import subscribers:export segments:read segments:write tags:read tags:write forms:read forms:write form_submissions:read landing_pages:read landing_pages:write landing_page_submissions:read broadcasts:read broadcasts:write sequences:read sequences:write magic_links:read magic_links:write automations:read automations:write workspace:read email_delivery_connections:read email_delivery_connections:write email_templates:read email_templates:write custom_fields:read custom_fields:write webhooks:read webhooks:write"Protected resource metadata
| Document | https://api.mailrith.com/.well-known/oauth-protected-resource/mcp |
|---|---|
| Retrieved | Yes |
| Resource | https://api.mailrith.com/mcp |
| Authorisation server | https://api.mailrith.com |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.mailrith.com/mcp | Verified | 200 | |
| http (plaintext) | http://api.mailrith.com/mcp | HTTPS enforced | 301 | https://api.mailrith.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
analytics_create_report Create or reuse an analytics report ~129
Runs from compact rollups. Ranges through 31 days complete inline; longer ranges are queued. Results expire after 24 hours and never exceed 100 rows. Effect: workspace-change. Retry with the same idempotency_key. Permission: analytics:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | – | – | – |
No examples provided.
analytics_get_report Get an analytics report ~98
Returns one unexpired bounded analytics report by identifier. Permission: analytics:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum aggregate row count, from 1 to 50. |
| report_id | string | yes | Stable analytics report identifier. |
| starting_after | string | – | Opaque next_cursor returned by the previous report page. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_create Create an automation ~105
Creates an automation in the authenticated workspace. Effect: workspace-change. Retry with the same idempotency_key. Permission: automations:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_get Get an automation ~50
Returns one automation from the authenticated workspace. Permission: automations:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| automation_id | string | yes | The automation identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_list List automations ~98
Returns automations in the authenticated workspace. Permission: automations:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of automations to return. |
| search | string | – | Filter Automations by name or status. |
| starting_after | string | – | Use the opaque cursor from the previous page to request the next page. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_preflight Check automation readiness ~57
Checks the saved Automation definition and email delivery prerequisite without running any action. Permission: automations:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| automation_id | string | yes | The Automation identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_preview_journey Preview an automation journey ~86
Shows the bounded path a selected Subscriber would take through the current saved conditions without running actions or writing history. Permissions: subscribers:read, automations:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| automation_id | string | yes | The Automation identifier. |
| subscriber_id | string | yes | The saved Subscriber whose current state should be evaluated. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_send_test Send automation test messages ~144
Sends up to five selected saved Automation email steps to one explicit test address. This does not start the Automation or run other actions. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, subscribers:read, automations:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| automation_id | string | yes | The Automation identifier. |
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_update Update an automation ~197
Updates an existing draft or paused Automation. Before changing a running Automation, read it by ID, retain its status in the current task only, pause it, apply the update, and use bounded direct item reads until is_updating is false. Run preflight, return it to running only if it was running before and preflight passes, and verify the final status. If the update fails before changing the Automation, restore its prior running status when preflight passes. If readiness or the prior status cannot be restored, leave it paused and immediately report the failure; never activate an Automation that was not already running. Effect: workspace-change. Retry after reading the current resource state. Permission: automations:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| automation_id | string | yes | The automation identifier. |
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
automations_update_status Change an automation status ~97
Starts, pauses, or returns one Automation to draft without changing its definition. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, automations:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| automation_id | string | yes | The Automation identifier. |
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_cancel Cancel a broadcast send ~127
Requests cancellation for delivery work that has not reached the provider. Provider-accepted emails cannot be recalled. Repeat the same request with the same idempotency key when the response is lost. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| broadcast_id | string | yes | The broadcast identifier. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_create Create a broadcast ~104
Creates a broadcast draft in the authenticated workspace. Effect: workspace-change. Retry with the same idempotency_key. Permission: broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_get Get a broadcast ~55
Returns a broadcast draft, scheduled send, active send, or completed send. Permission: broadcasts:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| broadcast_id | string | yes | The broadcast identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_get_send_progress Get broadcast send progress ~119
Returns bounded delivery progress, current rates, timing, outcome counts, and pause state. Poll until terminal is true; use 5 to 10 second intervals while progress changes and back off to 30 seconds when unchanged. Permission: broadcasts:read. Polling: wait at least 2 seconds, use exponential backoff up to 30 seconds, stop at a terminal state, and stop after 15 minutes. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| broadcast_id | string | yes | The broadcast identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_list List broadcasts ~102
Returns broadcast drafts, scheduled sends, active sends, and completed sends. Permission: broadcasts:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of items to return. |
| search | string | – | Filter Broadcasts by subject, preview text, status, or sender. |
| starting_after | string | – | Opaque cursor returned by the previous page. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_preflight Inspect broadcast readiness ~73
Optionally checks the current Subscriber estimate, provider capacity, sender setup, event tracking, and blocking issues. This diagnostic is not required before starting a durable send. Permission: broadcasts:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| broadcast_id | string | yes | The broadcast identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_schedule Schedule or reschedule a broadcast ~115
Schedules a draft for future delivery, or changes the delivery time of an existing scheduled Broadcast. This uses Mailrith's durable scheduled-send path and does not start delivery immediately. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| broadcast_id | string | yes | The broadcast identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_send Send a broadcast now ~173
Immediately creates durable preparation for a broadcast draft or scheduled send. Mailrith calculates the exact Subscriber total and checks provider readiness in the background before delivery. A 202 response means the durable send was accepted, not that provider delivery is complete. Reuse the same idempotency key if the response is lost. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | – | The exact JSON request body defined by the Mailrith public API contract. |
| broadcast_id | string | yes | The broadcast identifier. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_send_test Send a broadcast test email ~165
Sends a test message from an existing Broadcast that has an email delivery connection. Provide a saved Subscriber ID for personalization; use subscribers_list to find one when needed. The recipient may be any test inbox and does not have to match the saved Subscriber. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, subscribers:read, broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| broadcast_id | string | yes | The broadcast identifier. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_unschedule Unschedule a broadcast ~70
Returns a scheduled Broadcast to draft state before delivery starts. Effect: workspace-change. Retry after reading the current resource state. Permissions: live_actions:write, broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| broadcast_id | string | yes | The broadcast identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
broadcasts_update Update a broadcast ~214
Updates an existing Broadcast draft. Scheduled, running, completed, and failed Broadcasts cannot be changed here. Before changing a scheduled Broadcast, read it by ID and retain its scheduled_at in the current task only. If the saved time is no longer safely in the future, ask the user for a new time before unscheduling. Otherwise unschedule it, apply the update, reschedule it for the same time, and verify both status and scheduled_at. If the update fails after unscheduling, restore the unchanged Broadcast to the same future time when possible. If the schedule cannot be restored, leave it as a Draft and immediately report that it will not send; never choose a replacement time without the user. Effect: workspace-change. Retry after reading the current resource state. Permission: broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| broadcast_id | string | yes | The broadcast identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
custom_fields_get Get a custom field ~63
Returns one custom field from the authenticated workspace, including its exact ready-to-use email personalization token. Permission: custom_fields:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| custom_field_id | string | yes | The custom field identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
custom_fields_list List custom fields ~114
Returns a bounded page of custom fields in the authenticated workspace, including each field's exact ready-to-use email personalization token. Permission: custom_fields:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of custom fields to return. |
| search | string | – | Filter custom fields by label or type. |
| starting_after | string | – | Use the opaque cursor from the previous page to request the next page. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
discovery_get_capabilities Get authenticated API capabilities ~57
Returns the current workspace context, discovery URLs, shared request conventions, supported webhook events, and public resource operations available to the authenticated bearer credential. Permission: none. API reference: https://mailrith.com/developers/api-reference.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
email_templates_create Create an email template ~108
Creates a reusable email template scoped to the authenticated workspace. Effect: workspace-change. Retry with the same idempotency_key. Permission: email_templates:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
email_templates_get Get an email template ~54
Returns a reusable email template linked to the authenticated workspace. Permission: email_templates:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| template_id | string | yes | The email template identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
email_templates_list List email templates ~92
Returns reusable email templates linked to the authenticated workspace. Permission: email_templates:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of items to return. |
| search | string | – | Filter email templates by name. |
| starting_after | string | – | Opaque cursor returned by the previous page. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
email_templates_preview Preview an email template for a Subscriber ~90
Renders one template using a saved Subscriber's name, email, and custom fields without sending or saving anything. Permissions: subscribers:read, email_templates:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| template_id | string | yes | The email template identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
email_templates_update Update an email template ~89
Updates the content or enabled state of an existing email template. Effect: workspace-change. Retry after reading the current resource state. Permission: email_templates:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| template_id | string | yes | The email template identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
segments_get Get a segment ~53
Returns one saved segment from the authenticated workspace. Permission: segments:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| segment_id | string | yes | The identifier of the segment to return. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
segments_list List segments ~93
Returns saved segments from the authenticated workspace. Permission: segments:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | The maximum number of segments to return. |
| search | string | – | Filter Segments by name or description. |
| starting_after | string | – | The opaque cursor from the previous page of saved segments. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
segments_preview Preview a segment definition ~83
Returns subscriber counts for an unsaved segment definition. Include `current_segment_id` when previewing edits to an existing segment so circular segment references are rejected before saving. Permission: segments:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sender_identities_get Get a sender identity ~67
Returns one enabled sender name, address, and provider type by stable identifier. Provider credentials and configuration are never returned. Permission: workspace:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| sender_identity_id | string | yes | The sender identity identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sender_identities_list List sender identities ~107
Returns a bounded page of enabled sender names, addresses, and provider types that can be selected for Broadcasts and Sequences. Provider credentials and configuration are never returned. Permission: workspace:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of sender identities to return. |
| starting_after | string | – | Opaque next_cursor returned by the previous sender identity page. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_create Create a sequence ~103
Creates a sequence in the authenticated workspace. Effect: workspace-change. Retry with the same idempotency_key. Permission: sequences:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_get Get a sequence ~48
Returns one sequence from the authenticated workspace. Permission: sequences:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| sequence_id | string | yes | The sequence identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_list List sequences ~107
Returns sequences in the authenticated workspace. Permission: sequences:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of sequences to return. |
| search | string | – | Filter sequences by name, status, or sender details. Retrieve a known Sequence ID through the item endpoint. |
| starting_after | string | – | Use the opaque cursor from the previous page to request the next page. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_preflight Check sequence readiness ~62
Checks the saved Sequence, its published emails, and its email delivery connection without changing data or sending email. Permission: sequences:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| sequence_id | string | yes | The Sequence identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_preview_journey Preview a sequence journey ~91
Returns the bounded saved email timeline and shows which messages a selected Subscriber is eligible to receive, without enrolling the Subscriber or sending email. Permissions: subscribers:read, sequences:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| sequence_id | string | yes | The Sequence identifier. |
| subscriber_id | string | yes | The saved Subscriber whose personalization and targeting should be previewed. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_send_test Send sequence test messages ~146
Sends up to five selected saved Sequence emails to one explicit test address. This does not enroll a Subscriber, start the Sequence, or write delivery activity. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, subscribers:read, sequences:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| idempotency_key | string | – | Optional idempotency key to retry the request safely. It must not exceed 256 UTF-8 bytes. |
| sequence_id | string | yes | The Sequence identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_update Update a sequence ~193
Updates an existing paused Sequence. Before changing a running Sequence, read it by ID, retain its status in the current task only, pause it, apply the update, and use bounded direct item reads until is_updating is false. Run preflight, return it to running only if it was running before and preflight passes, and verify the final status. If the update fails before changing the Sequence, restore its prior running status when preflight passes. If readiness or the prior status cannot be restored, leave it paused and immediately report the failure; never activate a Sequence that was not already running. Effect: workspace-change. Retry after reading the current resource state. Permission: sequences:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| sequence_id | string | yes | The sequence identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
sequences_update_status Activate or pause a sequence ~93
Starts or pauses one Sequence without changing its content or delivery settings. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, sequences:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| sequence_id | string | yes | The Sequence identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_add_tag Add a Tag to a Subscriber ~93
Adds the selected Tag to a Subscriber. If the Subscriber already has the Tag, the API returns the Subscriber unchanged. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| subscriber_id | string | yes | The Subscriber identifier. |
| tag_id | string | yes | The Tag identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_add_to_sequence Add a subscriber to a sequence ~96
Adds the selected subscriber to the selected sequence. If the subscriber is already in the sequence, the API returns the subscriber unchanged. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| sequence_id | string | yes | The sequence identifier. |
| subscriber_id | string | yes | The subscriber identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_get Get a subscriber ~52
Returns one Subscriber by its stable identifier from the authenticated workspace. Permission: subscribers:read. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| subscriber_id | string | yes | The Subscriber identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_list List subscribers ~322
Returns subscribers in the authenticated workspace, sorted from newest to oldest. Permission: subscribers:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| cold_only | boolean | – | When `true`, return only cold subscribers. |
| string | – | Filter subscribers by an exact subscriber email address. | |
| limit | integer | – | Maximum number of subscribers to return. Defaults to 25 and is capped at 100. |
| search | string | – | Filter subscribers by name, email, or status. |
| sequence_id | string | – | Return subscribers that match this sequence ID. Repeat `sequence_id` or use `sequence_ids` to match any of several sequences. |
| sequence_ids | string | – | Comma-separated sequence IDs. By default, the API returns only subscribers who are active in any listed sequence. |
| sequence_operator | string | – | Controls how sequence filters are applied. Defaults to `is_active_in_any_of`. |
| starting_after | string | – | Use the opaque cursor from the previous page to request the next page. |
| status | string | – | Filter subscribers by subscriber status. |
| tag_id | string | – | Return subscribers that currently have this tag ID. Repeat `tag_id` or use `tag_ids` to match any of several tags. |
| tag_ids | string | – | Comma-separated tag IDs. By default, the API returns subscribers who have any listed tag. |
| tag_operator | string | – | Controls how tag filters are applied. Defaults to `has_any_of`. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_remove_from_sequence Remove a subscriber from a sequence ~96
Removes the selected subscriber from the selected sequence. If the subscriber is not in the sequence, the API returns the subscriber unchanged. Effect: subscriber-change. Retry after reading the current resource state. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| sequence_id | string | yes | The sequence identifier. |
| subscriber_id | string | yes | The subscriber identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_remove_tag Remove a tag from a subscriber ~94
Removes the selected tag from a subscriber. If the subscriber does not have the tag, the API returns the subscriber unchanged. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| subscriber_id | string | yes | The subscriber identifier. |
| tag_id | string | yes | The tag identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_update Update a subscriber ~119
Updates profile fields, status, custom fields, tags, or sequence assignments for one subscriber. Fields omitted from the request stay unchanged. Blank optional custom field values also leave saved values unchanged, and filled-in invalid values are rejected. Effect: subscriber-change. Retry after reading the current resource state. Permission: subscribers:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| subscriber_id | string | yes | The subscriber identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
subscribers_update_status Change Subscriber sending eligibility ~130
Changes the delivery status for one Subscriber without changing profile, targeting, or Sequence enrollment fields. Making a Subscriber Active requires consent_evidence; its collected_at value must include the correct UTC offset and must not be later than Mailrith's server time. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.
| Name | Type | Req | Description |
|---|---|---|---|
| body | object | yes | The exact JSON request body defined by the Mailrith public API contract. |
| subscriber_id | string | yes | The Subscriber identifier. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| operation_id | string | yes | The stable Mailrith public API operation ID. |
| request_id | string | yes | The stable correlation ID for this MCP tool invocation. |
| response | object | – | – |
No examples provided.
What is the Mailrith Email Marketing MCP server?
Mailrith Email Marketing is an MCP server listed in the public MCP registry as com.mailrith/mailrith. Manage Subscribers, Broadcasts, Sequences, Automations, and reporting in Mailrith. This page covers its hosted endpoint (https://api.mailrith.com/mcp).
Is the Mailrith Email Marketing MCP server safe to use?
Mailrith Email Marketing scores 93 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Mailrith Email Marketing MCP server expose?
Mailrith Email Marketing exposes 55 tools: discovery_get_capabilities, workspace_get, sender_identities_list, sender_identities_get, analytics_create_report, and 50 more. Their descriptions and schemas cost roughly 5,780 tokens of context every time the server is loaded.
Does the Mailrith Email Marketing MCP server require authentication?
Yes. Mailrith Email Marketing asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the Mailrith Email Marketing MCP server still maintained?
Mailrith Email Marketing is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.