rapidmail MCP by usefulapi
Read rapidmail lists, recipients, mailings and stats; add, update or unsubscribe one recipient.
Should I use this
Quality & Safety
Findings (5)
- LOWTool 'rapidmail_get_recipientlist_activity_stats' name length outside 3-30 rangein rapidmail_get_recipientlist_activity_stats
- LOWTool 'rapidmail_unsubscribe_recipient' name length outside 3-30 rangein rapidmail_unsubscribe_recipient
- LOWTool 'rapidmail_list_mailing_activity' name length outside 3-30 rangein rapidmail_list_mailing_activity
- LOWTool 'rapidmail_get_mailing_recipient_activity' name length outside 3-30 rangein rapidmail_get_mailing_recipient_activity
- LOWTool 'rapidmail_list_transactional_emails' name length outside 3-30 rangein rapidmail_list_transactional_emails
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"rapidmail": {
"url": "https://rapidmail.usefulapi.io/mcp"
}
}
}Remote endpoints
https://rapidmail.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (16)
🟢rapidmail_list_recipientlists(page)
List the recipient lists (newsletter audiences) of the rapidmail account with id, name, description, whether unsubscribed recipients are blacklisted, and which is the default. Use the ids for recipients and mailing filters. GET /recipientlists.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_get_recipientlist(recipientlist_id)
One recipient list by id. GET /recipientlists/{id}.
Input Schema
{
"type": "object",
"properties": {
"recipientlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail recipient list id."
}
},
"required": [
"recipientlist_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_get_recipientlist_activity_stats(recipientlist_id, from, to)
Subscription activity of one recipient list between two dates (for example new subscriptions and unsubscriptions). The range may be at most one year, must not start before the list was created and must not lie in the future. GET /recipientlists/{id}/stats/activity.
Input Schema
{
"type": "object",
"properties": {
"recipientlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail recipient list id."
},
"from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Start date, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "End date, yyyy-mm-dd; later than from."
}
},
"required": [
"recipientlist_id",
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_list_recipients(recipientlist_id, email, foreign_id, status, sort_by, ...)
List the recipients (subscribers) of ONE recipient list, optionally filtered by e-mail address, external id or status. recipientlist_id is required. The long text fields (extrabig1-10) are only returned with include_extrabig. GET /recipients.
Input Schema
{
"type": "object",
"properties": {
"recipientlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail recipient list id (see rapidmail_list_recipientlists)."
},
"email": {
"description": "Only the recipient with this e-mail address.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"foreign_id": {
"description": "Only the recipient with this external id.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"status": {
"description": "Only recipients in these statuses: new (awaiting confirmation), active, bounced, abused, deleted.",
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"new",
"active",
"bounced",
"abused",
"deleted"
]
}
},
"sort_by": {
"description": "Sort field.",
"type": "string",
"enum": [
"activated",
"created",
"updated"
]
},
"sort_order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"include_extrabig": {
"description": "Also return the long text fields extrabig1-10 (default false).",
"type": "boolean"
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"recipientlist_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_get_recipient(recipient_id)
One recipient by id: e-mail, name, status, custom fields and timestamps. GET /recipients/{id}.
Input Schema
{
"type": "object",
"properties": {
"recipient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail recipient id."
}
},
"required": [
"recipient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴rapidmail_create_recipient(recipientlist_id, email, double_opt_in, test_mode, firstname, ...)
WRITE: add ONE recipient (subscriber) to a recipient list. By default double opt-in is used: the recipient is created with status 'new' and rapidmail sends ONE confirmation e-mail to that address; they only receive newsletters after confirming. Set double_opt_in=false only if you hold the person's documented consent: the recipient is then stored as 'active' and no e-mail is sent (refused if the address was unsubscribed before). If a deleted recipient with the same address exists it is re-activated; an existing address returns a conflict error. Never use for bulk imports. POST /recipients.
Input Schema
{
"type": "object",
"properties": {
"recipientlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail recipient list id to add the recipient to."
},
"email": {
"type": "string",
"maxLength": 255,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "E-mail address of the recipient."
},
"double_opt_in": {
"description": "true (default): status 'new' and a confirmation e-mail is sent to the address. false: status 'active', no e-mail (only with documented consent).",
"type": "boolean"
},
"test_mode": {
"description": "true: validate only, nothing is saved and no e-mail is sent.",
"type": "boolean"
},
"firstname": {
"description": "First name.",
"type": "string",
"maxLength": 255
},
"lastname": {
"description": "Last name.",
"type": "string",
"maxLength": 255
},
"gender": {
"description": "Gender.",
"type": "string",
"enum": [
"male",
"female"
]
},
"title": {
"description": "Academic title, e.g. Prof. Dr.",
"type": "string",
"maxLength": 50
},
"zip": {
"description": "Postal code (max 7 characters).",
"type": "string",
"maxLength": 7
},
"birthdate": {
"description": "Birth date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"foreign_id": {
"description": "Your own external id for this contact.",
"type": "string",
"maxLength": 255
},
"mailtype": {
"description": "Preferred mail format.",
"type": "string",
"enum": [
"text",
"html"
]
},
"extra1": {
"description": "Custom field 1 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra2": {
"description": "Custom field 2 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra3": {
"description": "Custom field 3 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra4": {
"description": "Custom field 4 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra5": {
"description": "Custom field 5 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra6": {
"description": "Custom field 6 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra7": {
"description": "Custom field 7 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra8": {
"description": "Custom field 8 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra9": {
"description": "Custom field 9 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra10": {
"description": "Custom field 10 (max 255 characters).",
"type": "string",
"maxLength": 255
}
},
"required": [
"recipientlist_id",
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴rapidmail_update_recipient(recipient_id, email, firstname, lastname, gender, ...)
WRITE: partially update ONE recipient (only the fields you pass change): e-mail, name, custom fields. The status and the recipient list cannot be changed here, and no e-mail is sent. An e-mail address that already exists in the list returns a conflict error. PATCH /recipients/{id}.
Input Schema
{
"type": "object",
"properties": {
"recipient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail recipient id."
},
"email": {
"description": "New e-mail address.",
"type": "string",
"maxLength": 255,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"firstname": {
"description": "First name.",
"type": "string",
"maxLength": 255
},
"lastname": {
"description": "Last name.",
"type": "string",
"maxLength": 255
},
"gender": {
"description": "Gender.",
"type": "string",
"enum": [
"male",
"female"
]
},
"title": {
"description": "Academic title, e.g. Prof. Dr.",
"type": "string",
"maxLength": 50
},
"zip": {
"description": "Postal code (max 7 characters).",
"type": "string",
"maxLength": 7
},
"birthdate": {
"description": "Birth date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"foreign_id": {
"description": "Your own external id for this contact.",
"type": "string",
"maxLength": 255
},
"mailtype": {
"description": "Preferred mail format.",
"type": "string",
"enum": [
"text",
"html"
]
},
"extra1": {
"description": "Custom field 1 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra2": {
"description": "Custom field 2 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra3": {
"description": "Custom field 3 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra4": {
"description": "Custom field 4 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra5": {
"description": "Custom field 5 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra6": {
"description": "Custom field 6 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra7": {
"description": "Custom field 7 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra8": {
"description": "Custom field 8 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra9": {
"description": "Custom field 9 (max 255 characters).",
"type": "string",
"maxLength": 255
},
"extra10": {
"description": "Custom field 10 (max 255 characters).",
"type": "string",
"maxLength": 255
}
},
"required": [
"recipient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴rapidmail_unsubscribe_recipient(recipient_id)
WRITE: remove ONE recipient from their list. rapidmail only soft-deletes the record (status 'deleted', as if the person had unsubscribed) and the statistics count it as an unsubscription. No goodbye e-mail is sent. Single recipient only. DELETE /recipients/{id}.
Input Schema
{
"type": "object",
"properties": {
"recipient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail recipient id."
}
},
"required": [
"recipient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_list_mailings(status, recipientlist_id, created_since, updated_since, sent_from, ...)
List newsletters (mailings) with status, subject, sender, send time, recipient count and recipient lists. Filter by status, recipient list, created / updated / sent date. Read only: mailings are never created, sent or scheduled by this server. GET /mailings.
Input Schema
{
"type": "object",
"properties": {
"status": {
"description": "Mailing status, e.g. draft, scheduled, sending, sent.",
"type": "string",
"enum": [
"new",
"draft",
"scheduled",
"preparing",
"prepared",
"queueing",
"queued",
"sending",
"sent_split",
"sent",
"canceling",
"canceled",
"deleted"
]
},
"recipientlist_id": {
"description": "Only mailings sent to this recipient list.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"created_since": {
"description": "Only mailings created since this date/time.",
"type": "string"
},
"updated_since": {
"description": "Only mailings updated since this date/time.",
"type": "string"
},
"sent_from": {
"description": "Only mailings sent from this date/time.",
"type": "string"
},
"sent_to": {
"description": "Only mailings sent up to this date/time (after sent_from).",
"type": "string"
},
"sort_by": {
"description": "Sort field.",
"type": "string",
"enum": [
"created",
"updated",
"sent",
"send_at"
]
},
"sort_order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_get_mailing(mailing_id)
One mailing by id: status, subject, sender, destinations (recipient lists), send time, size and attachments. GET /mailings/{id}.
Input Schema
{
"type": "object",
"properties": {
"mailing_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail mailing id."
}
},
"required": [
"mailing_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_get_mailing_stats(mailing_id)
Statistics of one sent mailing (opens, clicks, bounces, unsubscriptions and similar totals). GET /mailings/{id}/stats.
Input Schema
{
"type": "object",
"properties": {
"mailing_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail mailing id."
}
},
"required": [
"mailing_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_list_mailing_activity(mailing_id, page)
The recipients a mailing went to and what each did (delivered, opened, clicked, bounced). Detailed event information is only available if the respective plugin is enabled in the rapidmail account. GET /mailings/{id}/stats/activity.
Input Schema
{
"type": "object",
"properties": {
"mailing_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail mailing id."
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"mailing_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_get_mailing_recipient_activity(mailing_id, mailingrecipient_id)
Delivery and engagement details of one recipient of one mailing. GET /mailings/{id}/stats/activity/{mailingrecipient_id}.
Input Schema
{
"type": "object",
"properties": {
"mailing_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "rapidmail mailing id."
},
"mailingrecipient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The mailing-recipient id from rapidmail_list_mailing_activity."
}
},
"required": [
"mailing_id",
"mailingrecipient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_list_mailing_folders
The folders used to organise mailings, with id and name. GET /mailings/folders.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_list_blacklist(pattern, page_size, created_since, updated_since, page)
The account's blacklist: e-mail addresses, domains and patterns that never receive mailings, with their type, source and dates. GET /blacklist.
Input Schema
{
"type": "object",
"properties": {
"pattern": {
"description": "Only entries matching this pattern.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"page_size": {
"description": "Entries per page, 1-1000 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"created_since": {
"description": "Only entries created since this date/time.",
"type": "string"
},
"updated_since": {
"description": "Only entries updated since this date/time.",
"type": "string"
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rapidmail_list_transactional_emails(date_from, date_to, status, project_id, from, ...)
Transactional (SMTP) e-mails sent through the rapidmail account: sender, recipient, subject, status (queued, delivered, bounced...), delivery diagnostics and open/click counts. Metadata only, no message bodies. Filter by date, status, project or address. GET /trx/emails.
Input Schema
{
"type": "object",
"properties": {
"date_from": {
"description": "From date, yyyy-mm-dd (not older than the account's retention).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"date_to": {
"description": "To date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"status": {
"description": "Only these delivery statuses.",
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"enum": [
"queued",
"received",
"delivered",
"paused",
"bounced",
"abused",
"rejected",
"deleted"
]
}
},
"project_id": {
"description": "Only these transactional-mail project ids.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"from": {
"description": "Sender name or address.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"to": {
"description": "Recipient name or address.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"subject": {
"description": "Subject text.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"has_attachments": {
"description": "Only mails with (true) or without (false) attachments.",
"type": "boolean"
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence