Servidor MCP

Mailcheer

com.mailcheer/mailcheer
Comunicación Marketing y publicidad Público y accesible MCP 2026-07-28

Qué hace este MCP

Manages email subscribers, suppressions, campaign drafts and sends, transactional emails, workspace settings, and delivery statistics.

add_subscriber
Add a subscriber
Adds or updates a subscriber. By default the person enters as PENDING and receives a confirmation email: that is double opt-in, and it protects the workspace's sending reputation. `double_opt_in: false` subscribes directly and must only be used when consent was already collected elsewhere — never on your own initiative. A suppressed or unsubscribed address is refused. An address gets at most one confirmation every 2 minutes and 3 per 24 hours: do not retry in a loop, read `confirmation_not_sent_reason` and `confirmation_retry_at` in the response.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['email'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}}, 'email': {'type': 'string'}, 'lastName': {'type': 'string'}, 'firstName': {'type': 'string'}, 'double_opt_in': {'type': 'boolean', 'description': 'false = direct subscription without confirmation. Only request this on explicit instruction from the person.'}}}
add_suppression
Suppress an address
Adds an address to the workspace's suppression list. By default (`manual`), it will receive nothing further, neither campaigns nor individual emails; with `unsubscribe`, only campaigns, automations, and sends carrying `unsubscribe_url` are refused to it. Use when someone requests no further contact outside the unsubscribe link.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string'}, 'reason': {'enum': ['unsubscribe', 'bounce', 'complaint', 'manual'], 'type': 'string'}}}
create_campaign
Create a campaign draft
Creates a DRAFT. Nothing is sent: you then need to call send_campaign, or send it from the Mailcheer workspace. Content is written in plain text in `text` — a blank line separates paragraphs, "#" at the start of a line makes a heading. Always have the draft reviewed before sending.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['name'], 'properties': {'from': {'type': 'string', 'description': 'Address of an already-registered sender. Defaults to the workspace sender.'}, 'kind': {'type': 'string', 'description': 'newsletter, offer, announcement… newsletter by default.'}, 'name': {'type': 'string', 'description': 'Internal name, visible only in the workspace.'}, 'text': {'type': 'string', 'description': 'Plain-text content.'}, 'subject': {'type': 'string', 'description': 'Subject line seen by recipients.'}, 'preheader': {'type': 'string', 'description': 'Preview text shown after the subject in the inbox.'}}}
erase_subscriber
Erase a person (GDPR)
Erases a person from the workspace at THEIR request (right to erasure): record, name, fields, proof of consent, tags. Statistics of campaigns already sent do not move; the suppression list is not touched. To stop someone receiving anything, use remove_subscriber — not this one. IRREVERSIBLE: only use it on the explicit request of the person concerned, relayed by the user.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string'}}}
get_account
Workspace info
Returns the workspace this key grants access to, its scopes, plan, remaining emails this month (queued sends included), when the counter resets, billing status, member and domain limits, sending domains (verified or not) and registered senders. Call this FIRST: it tells you which address to send from before attempting anything.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
get_campaign_stats
Campaign statistics
Status and figures for a campaign: recipients, sent, delivered, opened, clicked, bounced, complained. Rates are calculated on delivered messages, not on recipients. Every rate comes twice: open_rate and click_rate include bots (security gateways, preloads), human_open_rate and human_click_rate set them aside — that is the figure to give the person when they ask how many read it.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
get_email
Sent email status
Status of an email sent via send_email: sent, delivered, bounced, or complained. Amazon's delivery callback arrives a few seconds to a few minutes after sending — a "sent" status right after the call is normal.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
list_campaigns
List campaigns
The workspace's campaigns, from newest to oldest, with their status: draft, scheduled, sending, or sent.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'number'}, 'cursor': {'type': 'string'}, 'status': {'type': 'string'}}}
list_subscribers
List subscribers
Lists the workspace's subscribers, page by page. Use `cursor` with the `next_cursor` value from the response to get the next page. `status` filters on subscribed, pending, unsubscribed, bounced, or complained.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Search by address or name.'}, 'limit': {'type': 'number', 'description': '1 to 100, 50 by default.'}, 'cursor': {'type': 'string', 'description': 'Next-page cursor.'}, 'status': {'type': 'string'}, 'updated_since': {'type': 'string', 'description': 'ISO 8601 date: only the records created or changed since then (status, name, fields, tags).'}}}
list_suppression
List suppression entries
Suppressed addresses, with their reason: bounced, complained or manually suppressed (nothing goes to them), or unsubscribed (no more campaigns, automations, or sends carrying `unsubscribe_url`, but an individual email still reaches them). The `scope` field tells whether the address is suppressed for this workspace only or for the entire platform. No tool removes an address from this list: that action is done manually in the Mailcheer workspace, because it is the one that can suspend a sending capability.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'email': {'type': 'string', 'description': 'Look up a specific address.'}, 'limit': {'type': 'number'}, 'cursor': {'type': 'string'}}}
list_tags
List tags
The workspace's tags, with how many subscribers carry each one (`subscribers`) and, among them, the active ones (`subscribed`). Read this before tagging: reuse an existing name rather than creating a near-duplicate.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
preview_campaign_send
Preview a campaign send
Read-only: nothing is sent. Returns exactly what send_campaign would do right now — would it go out (and if not, why), and how many people would receive it. With `to`, reports address by address who is kept and who is excluded, with the reason (unsubscribed, bounced, complained, not in the list…). If the monthly quota is not enough, `would_send` is false, `blocked_code` is `quota_exceeded` and `blocked_details` gives the figures and the reset date. Call it BEFORE send_campaign, and give that number to the person when you ask them to confirm.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Campaign identifier.'}, 'to': {'type': 'array', 'items': {'type': 'string'}, 'description': "Optional. The addresses to restrict the send to. Omitted = the campaign's whole audience."}}}
remove_subscriber
Unsubscribe a subscriber
Unsubscribes an address and adds it to the workspace's suppression list: no more campaigns, automations, or sends carrying `unsubscribe_url`. The record is not deleted — that is what prevents the address from coming back on the next file import. This action cannot be reversed via the API: only the person can re-subscribe.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string'}}}
send_campaign
Send a campaign
⚠️ IRREVERSIBLE. Locks the recipient list and triggers sending to ALL active subscribers in the workspace — or, with `to`, only to the requested addresses that are active subscribers (never an unsubscribed or suppressed address). A sent email cannot be recalled. First call preview_campaign_send with the same parameters, then ask the person for explicit confirmation, telling them how many people will receive the message. Messages go out progressively; get_campaign_stats tracks progress.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Campaign identifier.'}, 'to': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional. Restricts the send to these addresses. An empty list sends to nobody (refused); for the whole list, omit the field.'}}}
send_email
Send an email
Sends a single (transactional) email to one or more addresses. The sender must belong to a verified domain of the workspace — call get_account to see which ones. An address suppressed for a bounce, a complaint or by hand fails the entire call, with its reason. An unsubscribed address still gets an individual email (a reply, an invoice, an appointment); a newsletter or a prospecting email must carry `unsubscribe_url`, and is then refused to an unsubscribed address. At most 50 addresses in all, to, cc and bcc together. Every address (to, cc, bcc) counts against the plan's monthly quota: past it, the call is refused (`quota_exceeded`) with the figures and the reset date — do not retry before that date. The email is sent immediately: this action cannot be undone.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['from', 'to', 'subject'], 'properties': {'to': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 50}], 'description': 'Recipient, or list of recipients.'}, 'from': {'type': 'string', 'description': 'Sending address on a verified domain. "Name <address@domain.com>" format accepted.'}, 'html': {'type': 'string', 'description': 'HTML body.'}, 'text': {'type': 'string', 'description': 'Plain-text body. At least one of html or text is required.'}, 'replyTo': {'type': 'string', 'description': 'Reply-to address.'}, 'subject': {'type': 'string', 'description': 'Message subject.'}, 'unsubscribe_url': {'type': 'string', 'description': 'One-click unsubscribe https address. Required for a newsletter or a prospecting email: it makes the send refused to an unsubscribed address. Leave it out for an individual email.'}}}
tag_subscriber
Add or remove tags
Adds (`add`) and removes (`remove`) tags on ONE existing subscriber, and nothing else: no subscription, no confirmation email, no status touched. Prefer it to add_subscriber for changing tags: add_subscriber is a subscription and sends the confirmation again to a pending person. An unknown address is not created (404). The response says what really changed (`added`, `removed`).
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['email'], 'properties': {'add': {'type': 'array', 'items': {'type': 'string'}}, 'email': {'type': 'string'}, 'remove': {'type': 'array', 'items': {'type': 'string'}}}}
update_campaign
Edit a campaign draft
Edits a DRAFT: name, subject, preheader, kind, sender, content (`text`). Nothing is sent. Prefer it to create_campaign to rework a text: otherwise the old draft stays in the list. A scheduled, sending or sent campaign cannot be edited (409).
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'from': {'type': 'string'}, 'kind': {'type': 'string'}, 'name': {'type': 'string'}, 'text': {'type': 'string', 'description': 'The new content, in plain text: it replaces the old one.'}, 'subject': {'type': 'string'}, 'preheader': {'type': 'string'}}}
Añadido
update_campaign
27 de September de 2026 a las 02:42
Modificado
add_suppression
27 de September de 2026 a las 02:42
Modificado
list_suppression
27 de September de 2026 a las 02:42
Añadido
erase_subscriber
27 de September de 2026 a las 02:42
Añadido
tag_subscriber
27 de September de 2026 a las 02:42
Añadido
list_tags
27 de September de 2026 a las 02:42
Modificado
remove_subscriber
27 de September de 2026 a las 02:42
Modificado
list_subscribers
27 de September de 2026 a las 02:42
Modificado
send_email
27 de September de 2026 a las 02:42
Modificado
get_campaign_stats
25 de September de 2026 a las 02:49
Modificado
preview_campaign_send
25 de September de 2026 a las 02:49
Modificado
add_subscriber
25 de September de 2026 a las 02:49
Modificado
get_account
25 de September de 2026 a las 02:49
Modificado
send_email
25 de September de 2026 a las 02:49
Añadido
get_email
23 de September de 2026 a las 02:40
Añadido
get_campaign_stats
23 de September de 2026 a las 02:40
Añadido
send_campaign
23 de September de 2026 a las 02:40
Añadido
preview_campaign_send
23 de September de 2026 a las 02:40
Añadido
create_campaign
23 de September de 2026 a las 02:40
Añadido
list_campaigns
23 de September de 2026 a las 02:40
Añadido
add_suppression
23 de September de 2026 a las 02:40
Añadido
list_suppression
23 de September de 2026 a las 02:40
Añadido
remove_subscriber
23 de September de 2026 a las 02:40
Añadido
add_subscriber
23 de September de 2026 a las 02:40
Añadido
list_subscribers
23 de September de 2026 a las 02:40
Añadido
get_account
23 de September de 2026 a las 02:40
Añadido
send_email
23 de September de 2026 a las 02:40