rapidmail MCP by usefulapi
Read rapidmail lists, recipients, mailings and stats; add, update or unsubscribe one recipient.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- LOWrapidmail_get_recipientlist_activity_stats에서
- LOWrapidmail_unsubscribe_recipient에서
- LOWrapidmail_list_mailing_activity에서
- LOWrapidmail_get_mailing_recipient_activity에서
- LOWrapidmail_list_transactional_emails에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"rapidmail": {
"url": "https://rapidmail.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://rapidmail.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거