mcp server
Mailrith Email Marketing
Manage Subscribers, Broadcasts, Sequences, Automations, and reporting in Mailrith.
Description as published by the maintainer. Source
- version 1.0.1
- active
- analytics
- workflow automation
active — Most recent push to the repository was 2026-07-31. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.
What this server can do
52 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
analytics_create_report(body)- 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. Required: body.
analytics_get_report(limit, report_id, starting_after)- 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. Required: report_id.
automations_create(body, idempotency_key)- 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. Required: body.
automations_get(automation_id)- Returns one automation from the authenticated workspace. Permission: automations:read. API reference: https://mailrith.com/developers/api-reference. Required: automation_id.
automations_list(limit, search, starting_after)- Returns automations in the authenticated workspace. Permission: automations:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
automations_preflight(automation_id)- Checks the saved Automation definition and email delivery prerequisite without running any action. Permission: automations:read. API reference: https://mailrith.com/developers/api-reference. Required: automation_id.
automations_preview_journey(automation_id, subscriber_id)- 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. Required: automation_id, subscriber_id.
automations_send_test(body, automation_id, idempotency_key)- 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. Required: automation_id, body.
automations_update(body, automation_id)- 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. Required: automation_id, body.
automations_update_status(body, automation_id)- 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. Required: automation_id, body.
broadcasts_cancel(broadcast_id, idempotency_key)- 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. Required: broadcast_id.
broadcasts_create(body, idempotency_key)- 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. Required: body.
broadcasts_get(broadcast_id)- Returns a broadcast draft, scheduled send, active send, or completed send. Permission: broadcasts:read. API reference: https://mailrith.com/developers/api-reference. Required: broadcast_id.
broadcasts_get_send_progress(broadcast_id)- 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. Required: broadcast_id.
broadcasts_list(limit, search, starting_after)- 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.
broadcasts_preflight(broadcast_id)- 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. Required: broadcast_id.
broadcasts_schedule(body, broadcast_id)- 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. Required: broadcast_id, body.
broadcasts_send(body, broadcast_id, idempotency_key)- 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. Required: broadcast_id.
broadcasts_send_test(body, broadcast_id, idempotency_key)- 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. Required: broadcast_id, body.
broadcasts_unschedule(broadcast_id)- 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. Required: broadcast_id.
broadcasts_update(body, broadcast_id)- 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. Required: broadcast_id, body.
discovery_get_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.
email_templates_create(body, idempotency_key)- 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. Required: body.
email_templates_get(template_id)- Returns a reusable email template linked to the authenticated workspace. Permission: email_templates:read. API reference: https://mailrith.com/developers/api-reference. Required: template_id.
email_templates_list(limit, search, starting_after)- 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.
email_templates_preview(body, template_id)- 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. Required: template_id, body.
email_templates_update(body, template_id)- 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. Required: template_id, body.
segments_get(segment_id)- Returns one saved segment from the authenticated workspace. Permission: segments:read. API reference: https://mailrith.com/developers/api-reference. Required: segment_id.
segments_list(limit, search, starting_after)- 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.
segments_preview(body)- 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. Required: body.
sender_identities_get(sender_identity_id)- 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. Required: sender_identity_id.
sender_identities_list(limit, starting_after)- 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.
sequences_create(body, idempotency_key)- 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. Required: body.
sequences_get(sequence_id)- Returns one sequence from the authenticated workspace. Permission: sequences:read. API reference: https://mailrith.com/developers/api-reference. Required: sequence_id.
sequences_list(limit, search, starting_after)- Returns sequences in the authenticated workspace. Permission: sequences:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
sequences_preflight(sequence_id)- 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. Required: sequence_id.
sequences_preview_journey(sequence_id, subscriber_id)- 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. Required: sequence_id, subscriber_id.
sequences_send_test(body, sequence_id, idempotency_key)- 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. Required: sequence_id, body.
sequences_update(body, sequence_id)- 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. Required: sequence_id, body.
sequences_update_status(body, sequence_id)- 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. Required: sequence_id, body.
subscribers_add_tag(tag_id, subscriber_id)- 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. Required: subscriber_id, tag_id.
subscribers_add_to_sequence(sequence_id, subscriber_id)- 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. Required: subscriber_id, sequence_id.
subscribers_get(subscriber_id)- Returns one Subscriber by its stable identifier from the authenticated workspace. Permission: subscribers:read. API reference: https://mailrith.com/developers/api-reference. Required: subscriber_id.
subscribers_list(email, limit, search, status, tag_id, tag_ids, cold_only, sequence_id, sequence_ids, tag_operator, starting_after, sequence_operator)- 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.
subscribers_remove_from_sequence(sequence_id, subscriber_id)- 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. Required: subscriber_id, sequence_id.
subscribers_remove_tag(tag_id, subscriber_id)- 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. Required: subscriber_id, tag_id.
subscribers_update(body, subscriber_id)- 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. Required: subscriber_id, body.
subscribers_update_status(body, subscriber_id)- 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. Required: subscriber_id, body.
subscribers_upsert(body, idempotency_key)- 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. Required: body.
tags_get(tag_id)- Returns one Tag from the authenticated workspace. Permission: tags:read. API reference: https://mailrith.com/developers/api-reference. Required: tag_id.
tags_list(limit, search, starting_after)- Returns tags in the authenticated workspace. Permission: tags:read. Pagination: use bounded pages and returned cursors. API reference: https://mailrith.com/developers/api-reference.
workspace_get- 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.
Last successful function declaration observed on . Source: https://api.mailrith.com/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://api.mailrith.com/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| GitHub stars | 0 | Number of GitHub accounts that bookmarked this repository since it was created. It is a bookmark count, not installs, not active users and not quality. | cumulative, all time | GitHub | |
| Last commit | 2026-07-31 | Date of the most recent push to any branch. This is the strongest cheap indicator of whether the project is still maintained. | point in time | GitHub | |
| Open issues | 0 | Open issues plus open pull requests, as GitHub counts them together. A high number can mean an active project or an abandoned one. | as of fetch | GitHub | |
| Package downloads | 242 downloads | Package downloads from the npm registry in this window. Includes continuous integration runs, mirrors and automated installs, so it overstates the number of human users. | 2026-07-30 to 2026-08-05 | npm | |
| Latest published version | 1.0.1 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-07-30 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| License | MIT | Licence GitHub detected in the repository. Detection can be wrong; the LICENSE file is authoritative. | as of fetch | GitHub | |
| First listed in the MCP Registry | 2026-07-30 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| repository status | active | The repository exists on GitHub and is not archived. This says nothing about how recently it was worked on. | as of fetch | GitHub | |
| mcp tools declared | 52 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | api.mailrith.com | |
| mcp endpoint status | ok | The server listed 52 functions when asked. | as of probe | api.mailrith.com |
Where to get it
Related, by what their authors tagged them
-
com.beacio/mcp
— last commit 2026-07-30, shares sdk
MCP server for Web Bluetooth on iOS Safari: scaffolding, UUID lookup, extension detection.
-
com.extentos/mcp-server
— last commit 2026-08-01, shares sdk
Build smart-glasses apps with AI agents: scaffold, validate, and simulate before real hardware.
-
LayerCall
— last commit 2026-08-04, shares sdk
Score an IP, email, phone, domain or device for fraud in one call, with the signals behind it.
-
com.mnemopay/sdk
— last commit 2026-06-26, shares sdk
Memory + wallet for AI agents. Real payment rails, Agent FICO 300-850, Merkle audit, identity.
-
nlqdb — analytical memory for AI agents
— last commit 2026-08-06, shares sdk
Analytical memory for AI agents: a real Postgres queried in plain English over MCP. One command.
-
OnchainDiligence
— last commit 2026-07-08, shares sdk
Pay-per-call compliance via x402: wallet sanctions, OFAC name, UK + US company verification.
-
com.tinysend/tinysend
— last commit 2026-06-23, shares sdk
Email for agents: newsletters, subscribers, contacts, broadcasts. OAuth sign-in, no API key.
-
Xquik MCP Server
— last commit 2026-08-03, shares sdk
128 REST operations. 120 MCP routes; 119 JSON/text ops. OAuth 2.1. Not affiliated with X Corp.
-
AgentSEO
— last commit 2026-07-17, shares sdk
Live SEO workflow tools for Claude Code, Codex, and AI agents.
-
dev.safeprompt/mcp
— last commit 2026-08-03, shares sdk
Detect prompt injection, jailbreaks, and code injection in untrusted text before it reaches an LLM.
These share tags the maintainers applied themselves, such as sdk. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.
This is not a recommendation and not a test result. It is a map of what the authors said their work is about.
How the author describes it
Topics the maintainer set on GitHub: ai-agents, email-marketing, gemini-cli-extension, mcp, python, sdk, typescript.
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json