Mailrith Email Marketing MCP server
Manage Subscribers, Broadcasts, Sequences, Automations, and reporting in Mailrith.
0 stars66 downloads/wk
Reviews
Write oneNobody has reviewed Mailrith Email Marketing yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mailrith Email Marketing tools (55, 26 write)
write = sends, deletes, buys or postsanalytics_create_reportwrite actionFreeRuns 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.
analytics_get_reportFreeReturns 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.
automations_createwrite actionFreeCreates 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.
automations_getFreeReturns one automation from the authenticated workspace. Permission: automations:read. API reference: https://mailrith.com/developers/api-reference.
automations_listFreeReturns automations in the authenticated workspace. Permission: automations:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
automations_preflightFreeChecks the saved Automation definition and email delivery prerequisite without running any action. Permission: automations:read. API reference: https://mailrith.com/developers/api-reference.
automations_preview_journeyFreeShows 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.
automations_send_testwrite actionFreeSends 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.
automations_updatewrite actionFreeUpdates 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.
automations_update_statuswrite actionFreeStarts, 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.
broadcasts_cancelwrite actionFreeRequests 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.
broadcasts_createwrite actionFreeCreates 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.
broadcasts_getFreeReturns a broadcast draft, scheduled send, active send, or completed send. Permission: broadcasts:read. API reference: https://mailrith.com/developers/api-reference.
broadcasts_get_send_progresswrite actionFreeReturns 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.
broadcasts_listFreeReturns 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.
broadcasts_preflightFreeOptionally 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.
broadcasts_scheduleFreeSchedules 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.
broadcasts_sendwrite actionFreeImmediately 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.
broadcasts_send_testwrite actionFreeSends a test message from an existing Broadcast that has an email delivery connection. Provide a saved Subscriber ID for personalization; use subscribers_list to find one when needed. The recipient may be any test inbox and does not have to match the saved Subscriber. Effect: external-email. Retry with the same idempotency_key. Permissions: live_actions:write, subscribers:read, broadcasts:write. API reference: https://mailrith.com/developers/api-reference.
broadcasts_unscheduleFreeReturns 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.
broadcasts_updatewrite actionFreeUpdates 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.
custom_fields_getFreeReturns 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_fields_listFreeReturns 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.
discovery_get_capabilitiesFreeReturns 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.
email_templates_createwrite actionFreeCreates 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.
email_templates_getwrite actionFreeReturns a reusable email template linked to the authenticated workspace. Permission: email_templates:read. API reference: https://mailrith.com/developers/api-reference.
email_templates_listwrite actionFreeReturns 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.
email_templates_previewwrite actionFreeRenders 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.
email_templates_updatewrite actionFreeUpdates 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.
segments_getFreeReturns one saved segment from the authenticated workspace. Permission: segments:read. API reference: https://mailrith.com/developers/api-reference.
segments_listFreeReturns saved segments from the authenticated workspace. Permission: segments:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
segments_previewFreeReturns 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.
sender_identities_getFreeReturns 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_identities_listFreeReturns 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.
sequences_createwrite actionFreeCreates 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.
sequences_getFreeReturns one sequence from the authenticated workspace. Permission: sequences:read. API reference: https://mailrith.com/developers/api-reference.
sequences_listFreeReturns sequences in the authenticated workspace. Permission: sequences:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
sequences_preflightFreeChecks 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.
sequences_preview_journeyFreeReturns 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.
sequences_send_testwrite actionFreeSends 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.
sequences_updatewrite actionFreeUpdates 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.
sequences_update_statuswrite actionFreeStarts 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.
subscribers_add_tagFreeAdds 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.
subscribers_add_to_sequenceFreeAdds 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.
subscribers_getFreeReturns one Subscriber by its stable identifier from the authenticated workspace. Permission: subscribers:read. API reference: https://mailrith.com/developers/api-reference.
subscribers_listFreeReturns 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.
subscribers_remove_from_sequencewrite actionFreeRemoves 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.
subscribers_remove_tagwrite actionFreeRemoves 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.
subscribers_updatewrite actionFreeUpdates 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.
subscribers_update_statuswrite actionFreeChanges 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.
subscribers_upsertwrite actionFreeCreates 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.
tags_createwrite actionFreeCreates 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.
tags_getFreeReturns one Tag from the authenticated workspace. Permission: tags:read. API reference: https://mailrith.com/developers/api-reference.
tags_listFreeReturns tags in the authenticated workspace. Permission: tags:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
workspace_getFreeReturns 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.
Public scan report
scanner v0.1.9 · 2026-09-21 · same rubric, same numbers if you re-run it
- Code scan11 source files scanned25/25
- Live reliabilityremote reachable in 1623ms20/20
- Tool poisoning55 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 26 write-action tools with no auth3/15
- Maintenancelast push 5 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
What the publisher says
From the Mailrith Email Marketing repository's README, as published. We do not edit it. Read it on GitHub
Mailrith Agent Platform
This public repository contains the versioned developer surfaces for building safe AI agent email marketing workflows with Mailrith:
plugin packages
- The public API, OAuth, scope, risk, and MCP contract
- The official TypeScript and Python SDKs
- The local and self-hosted MCP server
- The Mailrith CLI
- The installable Mailrith Agent Skill and supported-client connection templates
- The installable ChatGPT/Codex, Claude Code, GitHub Copilot CLI, and Cursor
installation guide, and shared submission materials
- The Gemini CLI extension
- The Claude Connector listing, Microsoft certification package, Cline
The hosted Mailrith application and its private infrastructure remain in a separate private repository. This repository intentionally contains no application source, database migrations, deployment credentials, customer data, or private operational configuration.
Development
Requirements: Node.js 20 or newer, pnpm 11.7.0, and Python 3.10 or newer.
pnpm install --frozen-lockfile
pnpm validateGenerated SDK and MCP files come from packages/public-api. Change the public contract first, then run:
pnpm generate:agent-artifacts
pnpm generate:agent-integrations
pnpm agent:release:manifestCommit the contract and every regenerated artifact in the same change.
Releases
The Release Agent Packages workflow prepares checksummed npm, Python, and platform packages on coordinated runs. The prepare-cli and cli targets prepare only the CLI archive. Publishing requires the protected agent-packages-production environment and trusted publishing configured for npm and PyPI. A matching agent-v tag or an explicitly approved publish run starts publication.
The CLI, other npm packages, Python, and marketplace submission versions advance independently through the coordinated workflow. This keeps already-submitted marketplace archives unchanged while another package channel receives a compatible patch release. The release manifest records each version, the contract digest, package digests, and public-registry status.
The platform archives are submission-ready files for OpenAI, Claude, Cursor, Gemini CLI, GitHub Copilot CLI, Microsoft, and Cline. Provider review and public directory approval are separate from npm and PyPI publication.
CLI 1.1.2 was published to npm on September 4, 2026. The other packages and prepared marketplace artifacts remain at 1.1.1. See Releasing The CLI for the separate CLI version fields and the preparation and publication steps.
Security
Do not report security vulnerabilities in public issues. Follow SECURITY.md.
Official Builds And Forks
Forking the code is allowed. Modified public versions must use distinct names and clearly say that they are unofficial and not affiliated with Mailrith. See the Mailrith Trademark And Unofficial Fork Policy.
License
The code is available under the MIT License. Mailrith brand identifiers are not licensed with the code.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add --transport http mailrith https://api.mailrith.com/mcp
Mailrith Email Marketing: common questions
- Is Mailrith Email Marketing MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Mailrith Email Marketing safety report
- How do I install Mailrith Email Marketing?
- It runs remotely at api.mailrith.com. Add it to Claude Code, Claude Desktop or Cursor with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Mailrith Email Marketing need an API key?
- Yes. The registry entry asks for
MAILRITH_API_KEY. - Is Mailrith Email Marketing maintained?
- The last commit was 5 days ago (2026-09-16). The latest release is v1.1.1.
- Is Mailrith Email Marketing up?
- 100% of our last 9 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Mailrith Email Marketing?
- Servers from other publishers that do the same job: SendGrid MCP Server, Abnormal Security MCP server and Envloped MCP server. Compare all Mailrith Email Marketing alternatives.
Alternatives to Mailrith Email Marketing
Same job from other publishers: the closest match first, then the best rated.
- SendGrid MCP ServerMCP server for SendGrid's v3 API: email marketing, transactional mail, templates, and analytics.not reviewedGrowingB
Abnormal Security MCPAbnormal Security email threats, cases, and reporting in your terminal and your AI agents.not reviewedGrowingB- EnvlopedSend transactional email, verify domains, build contact segments, and draft marketing campaigns.not reviewedNewA
- emailmdRender markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.not reviewedEstablishedA
- OpenOSINTAI-powered OSINT agent & MCP server. 16 tools: email, breach, IP, WHOIS, DNS, Shodan, GitHub & more.not reviewedEstablishedC