# Mailrith Email Marketing (remote · api.mailrith.com)

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

- Trust score: 80/100 (high trust)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.mailrith.com`: 80/100 (this document), [markdown](https://verifymcp.io/servers/com-mailrith-mailrith/api.md), [page](https://verifymcp.io/servers/com-mailrith-mailrith/api)
- npm · `@mailrith/mcp-server`: 44/100, [markdown](https://verifymcp.io/servers/com-mailrith-mailrith/mailrith-mcp-server.md), [page](https://verifymcp.io/servers/com-mailrith-mailrith/mailrith-mcp-server)

## Channel facts

- Endpoint: `https://api.mailrith.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 89/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - 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.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 5037 tokens (~93/item across 54 items; 52 tools + 2 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

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

### Codex

```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
    }
  }
}
```

### OpenClaw

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

### Hermes

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

### Other

```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 recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 80, +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.

### 2026-08-01 (score 79, +5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 74)

First indexed and scored.

## MCP tools (52)

### `discovery_get_capabilities` (~57 tokens)

Get authenticated API capabilities

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.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `workspace_get` (~52 tokens)

Get the current workspace

Returns the authenticated workspace profile and mailing context used by broadcasts, sequences, automations, forms, and magic links. Permission: workspace:read. API reference: https://mailrith.com/developers/api-reference.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sender_identities_list` (~107 tokens)

List sender identities

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 parameters:

- `limit` (integer): Maximum number of sender identities to return.
- `starting_after` (string): Opaque next_cursor returned by the previous sender identity page.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sender_identities_get` (~67 tokens)

Get a sender identity

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 parameters:

- `sender_identity_id` (string, required): The sender identity identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `analytics_create_report` (~97 tokens)

Create or reuse an analytics report

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response`

### `analytics_get_report` (~98 tokens)

Get an analytics report

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 parameters:

- `limit` (integer): Maximum aggregate row count, from 1 to 50.
- `report_id` (string, required): Stable analytics report identifier.
- `starting_after` (string): Opaque next_cursor returned by the previous report page.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_list` (~322 tokens)

List subscribers

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 parameters:

- `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`.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_get` (~52 tokens)

Get a subscriber

Returns one Subscriber by its stable identifier from the authenticated workspace. Permission: subscribers:read. API reference: https://mailrith.com/developers/api-reference.

Input parameters:

- `subscriber_id` (string, required): The Subscriber identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_upsert` (~122 tokens)

Create or upsert a subscriber

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `idempotency_key` (string): Optional idempotency key to retry the request safely.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response`

### `subscribers_update` (~119 tokens)

Update a subscriber

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `subscriber_id` (string, required): The subscriber identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_update_status` (~98 tokens)

Change Subscriber sending eligibility

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `subscriber_id` (string, required): The Subscriber identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_add_tag` (~93 tokens)

Add a Tag to a Subscriber

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 parameters:

- `subscriber_id` (string, required): The Subscriber identifier.
- `tag_id` (string, required): The Tag identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_remove_tag` (~94 tokens)

Remove a tag from a subscriber

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 parameters:

- `subscriber_id` (string, required): The subscriber identifier.
- `tag_id` (string, required): The tag identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_add_to_sequence` (~96 tokens)

Add a subscriber to a sequence

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 parameters:

- `sequence_id` (string, required): The sequence identifier.
- `subscriber_id` (string, required): The subscriber identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `subscribers_remove_from_sequence` (~96 tokens)

Remove a subscriber from a sequence

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 parameters:

- `sequence_id` (string, required): The sequence identifier.
- `subscriber_id` (string, required): The subscriber identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `tags_list` (~103 tokens)

List tags

Returns tags in the authenticated workspace. Permission: tags:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.

Input parameters:

- `limit` (integer): Maximum number of tags to return.
- `search` (string): Filter Tags by name or description. Retrieve a known Tag ID through the item endpoint.
- `starting_after` (string): Use the opaque cursor from the previous page to request the next page.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `tags_get` (~48 tokens)

Get a tag

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

Input parameters:

- `tag_id` (string, required): The Tag identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `segments_list` (~93 tokens)

List segments

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 parameters:

- `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.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `segments_get` (~53 tokens)

Get a segment

Returns one saved segment from the authenticated workspace. Permission: segments:read. API reference: https://mailrith.com/developers/api-reference.

Input parameters:

- `segment_id` (string, required): The identifier of the segment to return.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `segments_preview` (~83 tokens)

Preview a segment definition

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_list` (~102 tokens)

List broadcasts

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 parameters:

- `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.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_create` (~91 tokens)

Create a broadcast

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `idempotency_key` (string): Optional idempotency key for safe retries.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_get` (~55 tokens)

Get a broadcast

Returns a broadcast draft, scheduled send, active send, or completed send. Permission: broadcasts:read. API reference: https://mailrith.com/developers/api-reference.

Input parameters:

- `broadcast_id` (string, required): The broadcast identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_update` (~84 tokens)

Update a broadcast

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `broadcast_id` (string, required): The broadcast identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_preflight` (~73 tokens)

Inspect broadcast readiness

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 parameters:

- `broadcast_id` (string, required): The broadcast identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_send_test` (~116 tokens)

Send a broadcast test email

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `broadcast_id` (string, required): The broadcast identifier.
- `idempotency_key` (string): Optional idempotency key to make retries safe.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_schedule` (~115 tokens)

Schedule or reschedule a broadcast

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `broadcast_id` (string, required): The broadcast identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_unschedule` (~70 tokens)

Unschedule a broadcast

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 parameters:

- `broadcast_id` (string, required): The broadcast identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_send` (~161 tokens)

Send a broadcast now

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 parameters:

- `body` (object): The exact JSON request body defined by the Mailrith public API contract.
- `broadcast_id` (string, required): The broadcast identifier.
- `idempotency_key` (string): Optional idempotency key to make retries safe.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_cancel` (~115 tokens)

Cancel a broadcast send

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 parameters:

- `broadcast_id` (string, required): The broadcast identifier.
- `idempotency_key` (string): Optional idempotency key to make retries safe.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `broadcasts_get_send_progress` (~119 tokens)

Get broadcast send progress

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 parameters:

- `broadcast_id` (string, required): The broadcast identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_list` (~107 tokens)

List sequences

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 parameters:

- `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.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_create` (~91 tokens)

Create a sequence

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `idempotency_key` (string): Optional idempotency key to make retries safe.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_get` (~48 tokens)

Get a sequence

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

Input parameters:

- `sequence_id` (string, required): The sequence identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_update` (~79 tokens)

Update a sequence

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `sequence_id` (string, required): The sequence identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_preflight` (~62 tokens)

Check sequence readiness

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 parameters:

- `sequence_id` (string, required): The Sequence identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_preview_journey` (~91 tokens)

Preview a sequence journey

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 parameters:

- `sequence_id` (string, required): The Sequence identifier.
- `subscriber_id` (string, required): The saved Subscriber whose personalization and targeting should be previewed.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_send_test` (~134 tokens)

Send sequence test messages

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 parameters:

- `body` (object, required): 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, required): The Sequence identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `sequences_update_status` (~93 tokens)

Activate or pause a sequence

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `sequence_id` (string, required): The Sequence identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_list` (~98 tokens)

List automations

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 parameters:

- `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.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_create` (~93 tokens)

Create an automation

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `idempotency_key` (string): Optional idempotency key to make retries safe.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_get` (~50 tokens)

Get an automation

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

Input parameters:

- `automation_id` (string, required): The automation identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_update` (~81 tokens)

Update an automation

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 parameters:

- `automation_id` (string, required): The automation identifier.
- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_preflight` (~57 tokens)

Check automation readiness

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 parameters:

- `automation_id` (string, required): The Automation identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_preview_journey` (~86 tokens)

Preview an automation journey

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 parameters:

- `automation_id` (string, required): The Automation identifier.
- `subscriber_id` (string, required): The saved Subscriber whose current state should be evaluated.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_send_test` (~132 tokens)

Send automation test messages

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 parameters:

- `automation_id` (string, required): The Automation identifier.
- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `idempotency_key` (string): Optional idempotency key to make retries safe.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `automations_update_status` (~97 tokens)

Change an automation status

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 parameters:

- `automation_id` (string, required): The Automation identifier.
- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `email_templates_list` (~92 tokens)

List email templates

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 parameters:

- `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.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `email_templates_create` (~95 tokens)

Create an email template

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `idempotency_key` (string): Optional idempotency key for safe retries.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `email_templates_get` (~54 tokens)

Get an email template

Returns a reusable email template linked to the authenticated workspace. Permission: email_templates:read. API reference: https://mailrith.com/developers/api-reference.

Input parameters:

- `template_id` (string, required): The email template identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `email_templates_preview` (~90 tokens)

Preview an email template for a Subscriber

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `template_id` (string, required): The email template identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

### `email_templates_update` (~89 tokens)

Update an email template

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 parameters:

- `body` (object, required): The exact JSON request body defined by the Mailrith public API contract.
- `template_id` (string, required): The email template identifier.

Output parameters:

- `error` (object)
- `operation_id` (string): The stable Mailrith public API operation ID.
- `request_id` (string): The stable correlation ID for this MCP tool invocation.
- `response` (object)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-mailrith-mailrith/api#diagnostics

## Score history

- 2026-08-03: 80
- 2026-08-02: 79
- 2026-08-01: 79
- 2026-07-30: 74

## Links

- Remote endpoint: https://api.mailrith.com/mcp
- Repository: https://github.com/anrawool/mailrith-agent-platform
- Website: https://mailrith.com/developers/mcp
- Changelog RSS feed: https://verifymcp.io/servers/com-mailrith-mailrith/api/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-mailrith-mailrith/api/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-mailrith-mailrith/api