Horizontal

WorksWork and collaborationMarketing and social

Mailrith Email Marketing

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

Addresshttps://api.mailrith.com/mcp
Claude Codeclaude mcp add --transport http mailrith https://api.mailrith.com/mcp
For Cursor and other clients
{
  "mcpServers": {
    "mailrith": {
      "type": "http",
      "url": "https://api.mailrith.com/mcp"
    }
  }
}

Watch out

Has tools that change things: 20 of them

The server itself marks these tools as deleting or overwriting data (destructiveHint): have the agent ask you before it calls them.

Test
Works: Handshake succeeded
Tools
55 tools
Handshake
1.4 s
Transport
streamable-http · 2025-06-18
Tested
6 November 2026
Registry name
com.mailrith/mailrith v2.0.1
Listed
4 November 2026
Updated
4 November 2026
Website
mailrith.com/developers/mcp
Source
github.com/anrawool/mailrith-agent-platform
Also as a package
1 package
The last 1 tests
WhenResultTime
2026-11-06 12:17 UTCHandshake succeeded1.4 s

The 55 tools it listed

"Read only" and "Changes data" are the server's own marks. Underlined parameters are required.

  1. 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 with the same idempotency_key. Permission: analytics:read. API reference: https://mailrith.com/developers/api-reference.

    idempotency_key body

  2. analytics_get_reportRead only

    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.

    report_id limit starting_after

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

    idempotency_key body

  4. automations_getRead only

    Get an automation

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

    automation_id

  5. automations_listRead only

    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.

    search limit starting_after

  6. automations_preflightRead only

    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.

    automation_id

  7. automations_preview_journeyRead only

    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.

    automation_id subscriber_id

  8. automations_send_testChanges data

    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.

    automation_id idempotency_key body

  9. automations_updateChanges data

    Update an automation

    Updates an existing draft or paused Automation. Before changing a running Automation, read it by ID, retain its status in the current task only, pause it, apply the update, and use bounded direct item reads until is_updating is false. Run preflight, return it to running only if it was running before and preflight passes, and verify the final status. If the update fails before changing the Automation, restore its prior running status when preflight passes. If readiness or the prior status cannot be restored, leave it paused and immediately report the failure; never activate an Automation that was not already running. Effect: workspace-change. Retry after reading the current resource state. Permission: automations:write. API reference: https://mailrith.com/developers/api-reference.

    automation_id body

  10. automations_update_statusChanges data

    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.

    automation_id body

  11. broadcasts_cancelChanges data

    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.

    broadcast_id idempotency_key

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

    idempotency_key body

  13. broadcasts_getRead only

    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.

    broadcast_id

  14. broadcasts_get_send_progressRead only

    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.

    broadcast_id

  15. broadcasts_listRead only

    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.

    search limit starting_after

  16. broadcasts_preflightRead only

    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.

    broadcast_id

  17. broadcasts_scheduleChanges data

    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.

    broadcast_id body

  18. broadcasts_sendChanges data

    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.

    broadcast_id idempotency_key body

  19. broadcasts_send_testChanges data

    Send a broadcast test email

    Sends a test message from an existing Broadcast that has a sender. Provide a saved Subscriber ID for personalization; use subscribers_list to find one when needed. The recipient may be any test inbox and does not have to match the saved Subscriber. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, subscribers:read, broadcasts:write. API reference: https://mailrith.com/developers/api-reference.

    broadcast_id idempotency_key body

  20. broadcasts_unscheduleChanges data

    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.

    broadcast_id

  21. broadcasts_updateChanges data

    Update a broadcast

    Updates an existing Broadcast draft. Scheduled, running, completed, and failed Broadcasts cannot be changed here. Before changing a scheduled Broadcast, read it by ID and retain its scheduled_at in the current task only. If the saved time is no longer safely in the future, ask the user for a new time before unscheduling. Otherwise unschedule it, apply the update, reschedule it for the same time, and verify both status and scheduled_at. If the update fails after unscheduling, restore the unchanged Broadcast to the same future time when possible. If the schedule cannot be restored, leave it as a Draft and immediately report that it will not send; never choose a replacement time without the user. Effect: workspace-change. Retry after reading the current resource state. Permission: broadcasts:write. API reference: https://mailrith.com/developers/api-reference.

    broadcast_id body

  22. custom_fields_getRead only

    Get a custom field

    Returns one custom field from the authenticated workspace, including its exact ready-to-use email personalization token. Permission: custom_fields:read. API reference: https://mailrith.com/developers/api-reference.

    custom_field_id

  23. custom_fields_listRead only

    List custom fields

    Returns a bounded page of custom fields in the authenticated workspace, including each field's exact ready-to-use email personalization token. Permission: custom_fields:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.

    search limit starting_after

  24. discovery_get_capabilitiesRead only

    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.

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

    idempotency_key body

  26. email_templates_getRead only

    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.

    template_id

  27. email_templates_listRead only

    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.

    search limit starting_after

  28. email_templates_previewRead only

    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.

    template_id body

  29. email_templates_updateChanges data

    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.

    template_id body

  30. segments_getRead only

    Get a segment

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

    segment_id

  31. segments_listRead only

    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.

    search limit starting_after

  32. segments_previewRead only

    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.

    body

  33. sender_identities_getRead only

    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.

    sender_identity_id

  34. sender_identities_listRead only

    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.

    limit starting_after

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

    idempotency_key body

  36. sequences_getRead only

    Get a sequence

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

    sequence_id

  37. sequences_listRead only

    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.

    search limit starting_after

  38. sequences_preflightRead only

    Check sequence readiness

    Checks the saved Sequence, its published emails, and its sender without changing data or sending email. Permission: sequences:read. API reference: https://mailrith.com/developers/api-reference.

    sequence_id

  39. sequences_preview_journeyRead only

    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.

    sequence_id subscriber_id

  40. sequences_send_testChanges data

    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.

    sequence_id idempotency_key body

  41. sequences_updateChanges data

    Update a sequence

    Updates an existing paused Sequence. Before changing a running Sequence, read it by ID, retain its status in the current task only, pause it, apply the update, and use bounded direct item reads until is_updating is false. Run preflight, return it to running only if it was running before and preflight passes, and verify the final status. If the update fails before changing the Sequence, restore its prior running status when preflight passes. If readiness or the prior status cannot be restored, leave it paused and immediately report the failure; never activate a Sequence that was not already running. Effect: workspace-change. Retry after reading the current resource state. Permission: sequences:write. API reference: https://mailrith.com/developers/api-reference.

    sequence_id body

  42. sequences_update_statusChanges data

    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.

    sequence_id body

  43. subscribers_add_tagChanges data

    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.

    subscriber_id tag_id

  44. subscribers_add_to_sequenceChanges data

    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.

    subscriber_id sequence_id

  45. subscribers_getRead only

    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.

    subscriber_id

  46. subscribers_listRead only

    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.

    search email status cold_only tag_id tag_ids tag_operator sequence_id sequence_ids sequence_operator limit starting_after

  47. subscribers_remove_from_sequenceChanges data

    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.

    subscriber_id sequence_id

  48. subscribers_remove_tagChanges data

    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.

    subscriber_id tag_id

  49. subscribers_updateChanges data

    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.

    subscriber_id body

  50. subscribers_update_statusChanges data

    Change Subscriber sending eligibility

    Changes the delivery status for one Subscriber without changing profile, targeting, or Sequence enrollment fields. Making a Subscriber Active requires consent_evidence; its collected_at value must include the correct UTC offset and must not be later than Mailrith's server time. Effect: external-email. Retry after reading the current resource state. Permissions: live_actions:write, subscribers:write. API reference: https://mailrith.com/developers/api-reference.

    subscriber_id body

  51. subscribers_upsertChanges data

    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.

    idempotency_key body

  52. tags_create

    Create a tag

    Creates a new tag in the authenticated workspace. The GDPR consent tag names can be created and applied like other tags when you need to apply consent collected outside Mailrith. Tag-level double opt-in fields are no longer accepted; configure double opt-in on forms and landing pages instead. Effect: workspace-change. Retry with the same idempotency_key. Permission: tags:write. API reference: https://mailrith.com/developers/api-reference.

    idempotency_key body

  53. tags_getRead only

    Get a tag

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

    tag_id

  54. tags_listRead only

    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.

    search limit starting_after

  55. workspace_getRead only

    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.

Is this yours?

Claim it to hear the moment it breaks, correct this page and add your own ways to use it.

Claim your server

A test is the handshake and the tool list: no tool was called. Names and descriptions are as listed by whoever registered the server; we haven't checked them.

Back to Tested MCP Servers