# Mailrith Email Marketing MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/com-mailrith-mailrith
- Repository: https://github.com/anrawool/mailrith-agent-platform
- Website: https://mailrith.com/developers/mcp

## Install
- Command: `npx -y @mailrith/mcp-server`
- Endpoint: https://api.mailrith.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Npm @mailrith/mcp-server v1.0.1
- Environment variable: MAILRITH_API_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://api.mailrith.com/mcp

## Tools
- discovery_get_capabilities (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. Endpoint: https://api.mailrith.com/mcp
- workspace_get (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. Endpoint: https://api.mailrith.com/mcp
- sender_identities_list (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. Endpoint: https://api.mailrith.com/mcp
- sender_identities_get (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. Endpoint: https://api.mailrith.com/mcp
- analytics_create_report (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. Endpoint: https://api.mailrith.com/mcp
- analytics_get_report (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_list (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_get (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_upsert (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_update (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_update_status (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_add_tag (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_remove_tag (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_add_to_sequence (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. Endpoint: https://api.mailrith.com/mcp
- subscribers_remove_from_sequence (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. Endpoint: https://api.mailrith.com/mcp
- tags_list (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. Endpoint: https://api.mailrith.com/mcp
- tags_get (Get a tag) - Returns one Tag from the authenticated workspace. Permission: tags:read. API reference: https://mailrith.com/developers/api-reference. Endpoint: https://api.mailrith.com/mcp
- segments_list (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. Endpoint: https://api.mailrith.com/mcp
- segments_get (Get a segment) - Returns one saved segment from the authenticated workspace. Permission: segments:read. API reference: https://mailrith.com/developers/api-reference. Endpoint: https://api.mailrith.com/mcp
- segments_preview (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_list (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_create (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_get (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_update (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_preflight (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_send_test (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_schedule (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_unschedule (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_send (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_cancel (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. Endpoint: https://api.mailrith.com/mcp
- broadcasts_get_send_progress (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. Endpoint: https://api.mailrith.com/mcp
- sequences_list (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. Endpoint: https://api.mailrith.com/mcp
- sequences_create (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. Endpoint: https://api.mailrith.com/mcp
- sequences_get (Get a sequence) - Returns one sequence from the authenticated workspace. Permission: sequences:read. API reference: https://mailrith.com/developers/api-reference. Endpoint: https://api.mailrith.com/mcp
- sequences_update (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. Endpoint: https://api.mailrith.com/mcp
- sequences_preflight (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. Endpoint: https://api.mailrith.com/mcp
- sequences_preview_journey (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. Endpoint: https://api.mailrith.com/mcp
- sequences_send_test (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. Endpoint: https://api.mailrith.com/mcp
- sequences_update_status (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. Endpoint: https://api.mailrith.com/mcp
- automations_list (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. Endpoint: https://api.mailrith.com/mcp
- automations_create (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. Endpoint: https://api.mailrith.com/mcp
- automations_get (Get an automation) - Returns one automation from the authenticated workspace. Permission: automations:read. API reference: https://mailrith.com/developers/api-reference. Endpoint: https://api.mailrith.com/mcp
- automations_update (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. Endpoint: https://api.mailrith.com/mcp
- automations_preflight (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. Endpoint: https://api.mailrith.com/mcp
- automations_preview_journey (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. Endpoint: https://api.mailrith.com/mcp
- automations_send_test (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. Endpoint: https://api.mailrith.com/mcp
- automations_update_status (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. Endpoint: https://api.mailrith.com/mcp
- email_templates_list (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. Endpoint: https://api.mailrith.com/mcp
- email_templates_create (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. Endpoint: https://api.mailrith.com/mcp
- email_templates_get (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. Endpoint: https://api.mailrith.com/mcp
- email_templates_preview (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. Endpoint: https://api.mailrith.com/mcp
- email_templates_update (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. Endpoint: https://api.mailrith.com/mcp

## Resources
- mailrith://operations - Mailrith Operation Index A compact operation index without nested request or response schemas. MIME type: application/json
- mailrith://discovery - Mailrith Discovery Guide Recommended discovery order and official Mailrith entry points. MIME type: text/markdown

## Prompts
- mailrith_agent_plan - Plan a Mailrith task Generate a concise plan for a Mailrith task before calling tools. Arguments: goal

## Metadata
- Owner: com.mailrith
- Version: 1.0.1
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 30, 2026
- Source: https://registry.modelcontextprotocol.io