Mailrith Email Marketing

REMOTE · API.MAILRITH.COM · 2 COMPONENTS · SCANNED AUG 3

Manage Subscribers, Broadcasts, Sequences, Automations, and reporting in Mailrith.

Available components

remote · api.mailrith.com 80 npm · @mailrith/mcp-server 44

80 80 Trust /100

Trust breakdown (6 categories)

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 →

Endpoint Security89

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 check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
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
Tool/resource definitions use about 5037 tokens (~93/item across 54 items; 52 tools + 2 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management13

Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

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

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · api.mailrith.com

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add --transport http com-mailrith-mailrith https://api.mailrith.com/mcp

# ~/.codex/config.toml

[mcp_servers.com-mailrith-mailrith]
url = "https://api.mailrith.com/mcp"

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-mailrith-mailrith": {
      "type": "remote",
      "url": "https://api.mailrith.com/mcp",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add com-mailrith-mailrith --url https://api.mailrith.com/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  com-mailrith-mailrith:
    url: "https://api.mailrith.com/mcp"

// mcp.json

{
  "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.

Changelog

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.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.
1 Aug 26 +5
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 74

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

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 3 Aug 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	20 Jul 2026	18 Oct 2026	ECDSA 256	ECDSA-SHA256	616c74a839626e1513162e7667696517
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

DNSSEC insecure

Validation of api.mailrith.com. — Not signed

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
com.	present	19718	13	Verified
mailrith.com.	absent			Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation

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

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

MCP tools — 52 exposed · ~4,870 tokens

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.

Tool Tokens

analytics_create_report Create or reuse an analytics report ~97

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 after reading the current resource state. Permission: analytics:read. API reference: https://mailrith.com/developers/api-reference.

Input Output Examples

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	—	—	—

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.

Input Output Examples

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 ~93

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.

Input Output Examples

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 make retries safe.

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 ~132

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.

Input Output Examples

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 make retries safe.

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 ~81

Updates an existing automation. Effect: workspace-change. Retry after reading the current resource state. Permission: automations:write. API reference: https://mailrith.com/developers/api-reference.

Input Output Examples

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.

Input Output Examples

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 ~115

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.

Input Output Examples

Name	Type	Req	Description
broadcast_id	string	yes	The broadcast identifier.
idempotency_key	string	—	Optional idempotency key to make retries safe.

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 ~91

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.

Input Output Examples

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 for safe retries.

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 ~161

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.

Input Output Examples

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 make retries safe.

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 ~116

Sends a test message from an existing broadcast to one recipient. 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.

Input Output Examples

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 make retries safe.

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.

Input Output Examples

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 ~84

Updates a broadcast draft or scheduled send in place. Effect: workspace-change. Retry after reading the current resource state. Permission: broadcasts:write. API reference: https://mailrith.com/developers/api-reference.

Input Output Examples

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.

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 Output Examples

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 ~95

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.

Input Output Examples

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 for safe retries.

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 ~91

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.

Input Output Examples

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 make retries safe.

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 ~134

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.

Input Output Examples

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 make retries safe.
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 ~79

Updates an existing sequence. Effect: workspace-change. Retry after reading the current resource state. Permission: sequences:write. API reference: https://mailrith.com/developers/api-reference.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

Name	Type	Req	Description
cold_only	boolean	—	When `true`, return only cold subscribers.
email	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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 ~98

Changes the delivery status for one Subscriber without changing profile, targeting, or Sequence enrollment fields. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.

Input Output Examples

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_upsert Create or upsert a subscriber ~122

Creates a new subscriber when the email does not exist in the workspace. If the email already exists, the API updates the existing subscriber unless create_only is true. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.

Input Output Examples

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.

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.

tags_get Get a tag ~48

Returns one Tag from the authenticated workspace. Permission: tags:read. API reference: https://mailrith.com/developers/api-reference.

Input Output Examples

Name	Type	Req	Description
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.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

30 Jul 3 Aug