The MailSenpai MCP connector routes your AI agent's tool calls to MailSenpai's own MCP server through Scalekit. Each user signs in to MailSenpai once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 74 tools.
- Tools
- 74
- What they doRead · write · destructive
- 34 · 9 · 3134 read9 write31 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the MailSenpai MCP connection
In AgentKit > Connections, create a MailSenpai MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for MailSenpai MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'mailsenpaimcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize MailSenpai MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'mailsenpaimcp_check_blacklist',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "mailsenpaimcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize MailSenpai MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="mailsenpaimcp_check_blacklist",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolmailsenpaimcp_check_blacklistChecks whether a public IPv4 address or a domain is listed on the public email blocklists (DNSBLs) that MailSenpai queries.Read-onlyCheck Blacklist
Checks whether a public IPv4 address or a domain is listed on the public email blocklists (DNSBLs) that MailSenpai queries. For a domain it checks the domain, its registered domain, the IPs of its MX servers and its A record. Returns status (done, in_progress), summary, counts (checks, listed, unreachable, clean) and, for each target, every list with result (listed, clean, unreachable), the reason and the list's official removal page. manual_checks holds the lists that are not queried (for example Spamhaus), each with the link to its official check page. Works on any IP or domain, needs no data from the MailSenpai account and changes nothing. Use it when emails bounce with a blocklist error or before sending from a new IP. It usually answers in 1-5 seconds; if status is in_progress, call again with the returned job.
Inputs
jobstring- Only to resume: the job returned by a previous call that ended with status in_progress. Avoids starting a second check.
languagestring- Language of summary and notes: en (default) or it.one of
enit targetstring- Public IPv4 address (e.g. 203.0.113.10) or domain (e.g. example.com). IPv6 and private addresses are not supported: for IPv6 pass the domain.
mailsenpaimcp_check_domain_dnsChecks the public DNS records that decide whether a domain's email gets delivered: SPF (single record, ending, DNS lookups under the limit of 10, includes that no longer exist), DKIM (the most common selectors, or the one you pass in selector, with key length), DMARC (policy, reports address, inherited from the parent domain) and MX (which servers and spam filters receive the mail).Read-onlyCheck Domain Dns
Checks the public DNS records that decide whether a domain's email gets delivered: SPF (single record, ending, DNS lookups under the limit of 10, includes that no longer exist), DKIM (the most common selectors, or the one you pass in selector, with key length), DMARC (policy, reports address, inherited from the parent domain) and MX (which servers and spam filters receive the mail). Returns status (checked, public_mailbox, not_found, invalid, dns_unreachable), summary, checks.spf/dkim/dmarc/mx each with result (ok, fix, missing, check) and an explanatory note, tips ordered by priority with the exact values to publish, and the raw records. Works on any domain, does not need data from the MailSenpai account and changes nothing. Use it before sending from a new domain or when emails land in spam.
Inputs
domainstring- Domain to check, e.g. example.com. A URL or an email address also works: the domain is extracted.
languagestring- Language of notes and tips: en (default) or it.one of
enit selectorstring- Optional DKIM selector to try first (the name before ._domainkey), when the sending service uses an uncommon one.
mailsenpaimcp_get_campaignReturns one campaign by campaign_uid: name, subject, sender, list and segment, status and send date.Read-onlyGet Campaign
Returns one campaign by campaign_uid: name, subject, sender, list and segment, status and send date. For opens, clicks and bounces use get_campaign_stats. Read-only.
Inputs
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
mailsenpaimcp_get_campaign_statsReturns the aggregate results of one campaign: recipients processed, delivered, opens and unique opens, clicks, hard/soft bounces, unsubscribes and complaints, with rates.Read-onlyGet Campaign Stats
Returns the aggregate results of one campaign: recipients processed, delivered, opens and unique opens, clicks, hard/soft bounces, unsubscribes and complaints, with rates. For the individual bounce records use list_campaign_bounces. Read-only.
Inputs
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
mailsenpaimcp_get_email_spam_test_resultReturns the state and result of a spam test started with start_email_spam_test.Read-onlyGet Email Spam Test Result
Returns the state and result of a spam test started with start_email_spam_test. status is waiting (no email received yet: ask the user to send it, then call again), analyzing, completed or expired. When completed: score from 0 to 10, rating (excellent, good, needs_work, at_risk), summary, partial (true when authentication or the filter verdict could not be evaluated), the received email (from, subject, sending IP, size), sections with each check (authentication, blocklists, reverse DNS, headers, content), to_do with the fixes in order of impact and the spam filter rules that fired. Only the analysis is stored, never the message text; details are deleted after 24 hours. The score describes this one message, it is not a promise of inbox placement. Read-only.
Inputs
test_tokenstring- The test_token returned by start_email_spam_test.
mailsenpaimcp_get_listReturns the full settings of one mailing list by list_uid: general info, default sender (from name, from email, reply-to), notification and company details.Read-onlyGet List
Returns the full settings of one mailing list by list_uid: general info, default sender (from name, from email, reply-to), notification and company details. If you only know the list name, find its list_uid with list_lists first. Read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_get_list_fieldReturns one custom field of a list by field_id: label, tag, type, required flag, default value and options (for dropdowns).Read-onlyGet List Field
Returns one custom field of a list by field_id: label, tag, type, required flag, default value and options (for dropdowns). Use list_list_fields to find the field_id. Read-only.
Inputs
field_idstring- Numeric ID of the custom field (field_id), e.g. 12. Find it with list_list_fields.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_get_list_segmentReturns one segment by segment_uid with its name, match mode (all or any) and conditions.Read-onlyGet List Segment
Returns one segment by segment_uid with its name, match mode (all or any) and conditions. Use list_segment_subscribers to see the matching subscribers. Read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
segment_uidstring- Unique ID of the segment (segment_uid). Find it with list_list_segments.
mailsenpaimcp_get_my_mailsenpai_capabilitiesReturns what the connected MailSenpai account may do: customer name, roles, permission scopes, the list UIDs it is restricted to (empty means all lists) and plan limits such as canSendCampaigns, canDelete, requiresApprovalForSend and maxPerPage.Read-onlyGet My Mailsenpai Capabilities
Returns what the connected MailSenpai account may do: customer name, roles, permission scopes, the list UIDs it is restricted to (empty means all lists) and plan limits such as canSendCampaigns, canDelete, requiresApprovalForSend and maxPerPage. Call it first when you are unsure whether a write, send or delete action is allowed. Read-only, no parameters.
Inputs
This tool takes no inputs.
mailsenpaimcp_get_subscriberReturns one subscriber by subscriber_uid with email, all custom field values, status, source, IP address and date added.Read-onlyGet Subscriber
Returns one subscriber by subscriber_uid with email, all custom field values, status, source, IP address and date added. If you only have the email address use search_subscriber_by_email first. Read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
subscriber_uidstring- Unique ID of the subscriber (subscriber_uid), a 13-character code. Find it with search_subscriber_by_email or list_subscribers.
mailsenpaimcp_get_templateReturns one saved email template by template_uid, including its name and full HTML content.Read-onlyGet Template
Returns one saved email template by template_uid, including its name and full HTML content. Read-only.
Inputs
template_uidstring- Unique ID of the saved email template (template_uid). Find it with list_templates or search_templates.
mailsenpaimcp_get_transactional_emailReturns one transactional email by email_uid with recipient, sender, subject, status and sending details.Read-onlyGet Transactional Email
Returns one transactional email by email_uid with recipient, sender, subject, status and sending details. Read-only.
Inputs
email_uidstring- Unique ID of the transactional email (email_uid). Find it with list_transactional_emails.
mailsenpaimcp_list_blacklisted_subscribersLists the subscribers of a list with status blacklisted (blocked: they never receive emails, e.g.Read-onlyList Blacklisted Subscribers
Lists the subscribers of a list with status blacklisted (blocked: they never receive emails, e.g. after complaints or hard bounces). Shortcut for search_subscribers_by_status with status=blacklisted. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_campaign_bouncesLists the individual bounces recorded for one campaign: subscriber, bounce type (hard, soft or internal) and the receiving server's message.Read-onlyList Campaign Bounces
Lists the individual bounces recorded for one campaign: subscriber, bounce type (hard, soft or internal) and the receiving server's message. Use get_campaign_stats for totals only. Paginated; read-only.
Inputs
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_campaignsLists the account's campaigns page by page with campaign_uid, name, type and status (draft, pending-sending, sending, sent, paused...), optionally only those of one list.Read-onlyList Campaigns
Lists the account's campaigns page by page with campaign_uid, name, type and status (draft, pending-sending, sending, sent, paused...), optionally only those of one list. Use get_campaign for the details and get_campaign_stats for the results. Paginated; read-only.
Inputs
list_uidstring- Optional: return only the campaigns of this list (list_uid from list_lists). Omit for all campaigns.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_confirmed_subscribersLists the subscribers of a list with status confirmed, i.e.Read-onlyList Confirmed Subscribers
Lists the subscribers of a list with status confirmed, i.e. the active contacts who receive campaigns. Shortcut for search_subscribers_by_status with status=confirmed. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_countriesLists the countries known to MailSenpai with country_id, name and code, used for address details (e.g.Read-onlyList Countries
Lists the countries known to MailSenpai with country_id, name and code, used for address details (e.g. a list's company info) and to look up zones with list_country_zones. Paginated; read-only.
Inputs
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_country_zonesLists the zones (states, provinces, regions) of one country by country_id from list_countries.Read-onlyList Country Zones
Lists the zones (states, provinces, regions) of one country by country_id from list_countries. Paginated; read-only.
Inputs
country_idstring- Numeric country_id as returned by list_countries.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_list_field_typesReturns the custom field types that create_list_field accepts (identifier and name, e.g.Read-onlyList List Field Types
Returns the custom field types that create_list_field accepts (identifier and name, e.g. text, dropdown, date). Read-only, no parameters.
Inputs
This tool takes no inputs.
mailsenpaimcp_list_list_fieldsLists the custom fields of one list (for example EMAIL, FNAME, LNAME) with each field's field_id, tag, label, type and required flag.Read-onlyList List Fields
Lists the custom fields of one list (for example EMAIL, FNAME, LNAME) with each field's field_id, tag, label, type and required flag. Use it to learn the tags for subscriber data and the field_id needed in segment conditions. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_list_segmentsLists the segments (saved subscriber filters) of one list with each segment_uid and name.Read-onlyList List Segments
Lists the segments (saved subscriber filters) of one list with each segment_uid and name. Use get_list_segment for the conditions and list_segment_subscribers to see who matches. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_listsLists the account's mailing lists page by page, with each list's list_uid, name and display name.Read-onlyList Lists
Lists the account's mailing lists page by page, with each list's list_uid, name and display name. Use it to find the list_uid that most other tools need; use get_list for the full settings of one list. Returns data.records plus count and total_pages. Read-only.
Inputs
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_segment_condition_operatorsReturns the operators that segment conditions can use (operator_id, name and slug such as contains or greater-than).Read-onlyList Segment Condition Operators
Returns the operators that segment conditions can use (operator_id, name and slug such as contains or greater-than). Read-only, no parameters.
Inputs
This tool takes no inputs.
mailsenpaimcp_list_segment_subscribersReturns the subscribers that currently match a saved segment (subscriber_uid, email, status, field values).Read-onlyList Segment Subscribers
Returns the subscribers that currently match a saved segment (subscriber_uid, email, status, field values). Use list_subscribers for the whole list, or search_subscribers_by_custom_fields for a one-off filter without saving a segment. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10 segment_uidstring- Unique ID of the segment (segment_uid). Find it with list_list_segments.
mailsenpaimcp_list_subscribersLists the subscribers of one list page by page, optionally filtered by status; each record has subscriber_uid, email, custom field values, status, source and date added.Read-onlyList Subscribers
Lists the subscribers of one list page by page, optionally filtered by status; each record has subscriber_uid, email, custom field values, status, source and date added. To find one person use search_subscriber_by_email; to filter by field values use search_subscribers_by_custom_fields. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10 statusstring- Optional status filter: confirmed, unconfirmed, unsubscribed, blacklisted, unapproved, disabled or moved. Omit to get every status.one of
confirmedunconfirmedunsubscribedblacklistedunapproveddisabledmoved
mailsenpaimcp_list_templatesLists the saved email templates of the account (template_uid, name, screenshot) page by page.Read-onlyList Templates
Lists the saved email templates of the account (template_uid, name, screenshot) page by page. Use search_templates to filter by name and get_template for the full HTML. Paginated; read-only.
Inputs
filtersobject- Optional filters, e.g. {"name": "welcome"}. Omit to list everything.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_transactional_emailsLists transactional emails (single one-to-one messages such as receipts or password resets) with email_uid, recipient, subject, status and send date.Read-onlyList Transactional Emails
Lists transactional emails (single one-to-one messages such as receipts or password resets) with email_uid, recipient, subject, status and send date. Paginated; read-only.
Inputs
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_unconfirmed_subscribersLists the subscribers of a list with status unconfirmed (signed up but not yet confirmed, so they do not receive campaigns).Read-onlyList Unconfirmed Subscribers
Lists the subscribers of a list with status unconfirmed (signed up but not yet confirmed, so they do not receive campaigns). Shortcut for search_subscribers_by_status with status=unconfirmed. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_list_unsubscribed_subscribersLists the subscribers of a list with status unsubscribed (opted out; kept for history and no longer emailed).Read-onlyList Unsubscribed Subscribers
Lists the subscribers of a list with status unsubscribed (opted out; kept for history and no longer emailed). Shortcut for search_subscribers_by_status with status=unsubscribed. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_search_subscriber_by_emailChecks whether an email address is in ONE given list and returns its subscriber_uid and status; an error saying the subscriber does not exist means not found.Read-onlySearch Subscriber By Email
Checks whether an email address is in ONE given list and returns its subscriber_uid and status; an error saying the subscriber does not exist means not found. Use search_subscriber_by_email_all_lists when you do not know the list. Read-only.
Inputs
emailstring- Email address of the subscriber, e.g. "jane@example.org".
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_search_subscriber_by_email_all_listsFinds an email address across ALL lists of the account and returns every match with its list, subscriber_uid and status.Read-onlySearch Subscriber By Email All Lists
Finds an email address across ALL lists of the account and returns every match with its list, subscriber_uid and status. Use it when the list is unknown (e.g. privacy or opt-out requests); use search_subscriber_by_email when you know the list. Read-only.
Inputs
emailstring- Email address of the subscriber, e.g. "jane@example.org".
mailsenpaimcp_search_subscribers_by_custom_fieldsFinds subscribers in one list whose custom field values match exactly, e.g.Read-onlySearch Subscribers By Custom Fields
Finds subscribers in one list whose custom field values match exactly, e.g. {"CITY": "Rome"}; with several fields all must match. Use it for ad-hoc lookups; use search_subscriber_by_email for an email address and create_list_segment for a reusable filter. Paginated; read-only.
Inputs
fieldsobject- Field tags and the exact values to match, e.g. {"FNAME": "Jane", "CITY": "Rome"}. Get the tags from list_list_fields.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_search_subscribers_by_statusLists the subscribers of one list that have the given status (required).Read-onlySearch Subscribers By Status
Lists the subscribers of one list that have the given status (required). Same result as list_subscribers with a status filter; the list_confirmed/unconfirmed/unsubscribed/blacklisted_subscribers tools are shortcuts for common statuses. Paginated; read-only.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10 statusstring- Subscriber status: confirmed, unconfirmed, unsubscribed, blacklisted, unapproved, disabled or moved.one of
confirmedunconfirmedunsubscribedblacklistedunapproveddisabledmoved
mailsenpaimcp_search_templatesFinds saved templates matching the given filters, e.g.Read-onlySearch Templates
Finds saved templates matching the given filters, e.g. {"name": "welcome"}, page by page. Use list_templates to browse all templates. Read-only.
Inputs
filtersobject- Filters to match, e.g. {"name": "welcome"}.
pageinteger- Page number to return, starting at 1.default
1 per_pageinteger- Results per page (default 10). The server caps it at the plan maximum, usually 50.default
10
mailsenpaimcp_bulk_create_subscribersAdds many subscribers to one list in a single call and returns the outcome for each row.WriteBulk Create Subscribers
Adds many subscribers to one list in a single call and returns the outcome for each row. The number of rows is capped by the plan (usually 500 per call); split bigger imports. Use create_subscriber for a single contact.
Inputs
dataarray- Array of subscribers, each with EMAIL and optional field tags, e.g. [{"EMAIL": "ann@example.org", "FNAME": "Ann"}, {"EMAIL": "bob@example.org"}].
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_copy_campaignDuplicates an existing campaign (list, segment, content and settings) into a new DRAFT without send date and returns the new campaign_uid; the copy's name gets a "#1"-style suffix.WriteCopy Campaign
Duplicates an existing campaign (list, segment, content and settings) into a new DRAFT without send date and returns the new campaign_uid; the copy's name gets a "#1"-style suffix. Use it to reuse a past campaign; use create_campaign to start from scratch. Nothing is sent.
Inputs
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
mailsenpaimcp_copy_listCreates a copy of a list with its settings, custom fields and segments (subscribers are NOT copied) and returns the new list_uid; the copy's name gets a "#1"-style suffix.WriteCopy List
Creates a copy of a list with its settings, custom fields and segments (subscribers are NOT copied) and returns the new list_uid; the copy's name gets a "#1"-style suffix. Use create_list instead to start an empty list from scratch.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_create_listCreates a new, empty mailing list and returns its list_uid.WriteCreate List
Creates a new, empty mailing list and returns its list_uid. To duplicate an existing list with its custom fields and segments use copy_list instead; to add contacts afterwards use create_subscriber or bulk_create_subscribers.
Inputs
dataobject- List settings. Flat form: {"name": "Newsletter", "description": "Monthly news", "from_name": "Acme", "from_email": "news@acme.com", "reply_to": "support@acme.com", "subject": "Hello"}. The nested form {"general": {...}, "defaults": {...}, "notifications": {...}, "company": {...}} is also accepted.
mailsenpaimcp_create_list_fieldAdds a new custom field to a list (e.g.WriteCreate List Field
Adds a new custom field to a list (e.g. a "City" text field or a "Plan" dropdown) and returns it. Valid type identifiers come from list_list_field_types. Existing subscribers start with the new field empty.
Inputs
dataobject- Field definition, e.g. {"type": "text", "label": "City", "tag": "CITY", "required": "no"}. type: text, textarea, dropdown, multiselect, date, datetime, checkbox, consentcheckbox, phonenumber, email, url, rating or yearsrange. tag (UPPERCASE, max 32 characters) is derived from label if omitted. For dropdown/multiselect add "options": [{"name": "Gold", "value": "gold"}].
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_create_list_segmentCreates a saved segment in a list from field conditions (and optional campaign open/click conditions) and returns its segment_uid.WriteCreate List Segment
Creates a saved segment in a list from field conditions (and optional campaign open/click conditions) and returns its segment_uid. Get field_id values from list_list_fields and operators from list_segment_condition_operators.
Inputs
dataobject- Segment definition, e.g. {"name": "Rome customers", "operator_match": "all", "conditions": [{"field_id": 12, "operator": "contains", "value": "Rome"}]}. operator_match: all or any. Operator slugs: is, is-not, contains, not-contains, starts-with, ends-with, not-starts-with, not-ends-with, greater-than, less-than (or a numeric operator_id).
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_create_subscriberAdds a new subscriber to a list and returns its subscriber_uid.WriteCreate Subscriber
Adds a new subscriber to a list and returns its subscriber_uid. Fails if the email is already in the list: use create_or_update_subscriber to add-or-update, or bulk_create_subscribers for many contacts at once. Depending on the list's opt-in setting the new subscriber may start as unconfirmed.
Inputs
dataobject- Subscriber data keyed by field tag; EMAIL is required, e.g. {"EMAIL": "jane@example.org", "FNAME": "Jane", "LNAME": "Doe"}. Optional: status, source, ip_address.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_create_templateSaves a new reusable email template from HTML (or a ZIP archive) and returns its template_uid, which create_campaign can use.WriteCreate Template
Saves a new reusable email template from HTML (or a ZIP archive) and returns its template_uid, which create_campaign can use. It does not create or send any campaign.
Inputs
templateobject- Template object, e.g. {"name": "Welcome", "content": "<html>...</html>", "inline_css": "no"}. HTML is encoded automatically; a ZIP archive can be given as "archive": "base64:<data>".
mailsenpaimcp_start_email_spam_testStarts a free spam test and returns a unique test address (testspam+code@mailsenpai.com) and a test_token.WriteStart Email Spam Test
Starts a free spam test and returns a unique test address (testspam+code@mailsenpai.com) and a test_token. The user must then send a real email to that address from the program they normally use (newsletter tool, CRM, website or app): this tool cannot send it for them. Then call get_email_spam_test_result with the test_token. Not read-only: it creates a test and MailSenpai emails the instructions to the account's address (or to email, when given; it must be a company address, not Gmail or similar). Ask the user before starting. Limits: 3 tests per address per day; the address expires after 24 hours. A test still waiting for the same address is reused.
Inputs
emailstring- Optional company email that owns the test and receives the instructions. Omit to use the email of the connected MailSenpai account. Free and temporary mailboxes are rejected.
languagestring- Language of the instructions email and of the result: en (default) or it. It cannot be changed later.one of
enit
mailsenpaimcp_cancel_scheduled_campaignStops a scheduled campaign before it starts by moving it back to draft; nothing is deleted and it can be scheduled again later.DestructiveCancel Scheduled Campaign
Stops a scheduled campaign before it starts by moving it back to draft; nothing is deleted and it can be scheduled again later. For a campaign that is already sending use pause_unpause_campaign. Confirm with the user first.
Inputs
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
mailsenpaimcp_confirm_subscriberSets a subscriber's status to confirmed by subscriber_uid: confirms an unconfirmed contact or re-subscribes one who unsubscribed, so they receive campaigns again.DestructiveConfirm Subscriber
Sets a subscriber's status to confirmed by subscriber_uid: confirms an unconfirmed contact or re-subscribes one who unsubscribed, so they receive campaigns again. Do this only with the contact's consent and after the user confirms. Use confirm_subscriber_by_email if you only have the address.
Inputs
dataobject- Optional extra subscriber fields to save in the same call, keyed by field tag, e.g. {"FNAME": "Jane"}. Usually omitted.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
subscriber_uidstring- Unique ID of the subscriber (subscriber_uid), a 13-character code. Find it with search_subscriber_by_email or list_subscribers.
mailsenpaimcp_confirm_subscriber_by_emailSame as confirm_subscriber, but first finds the subscriber by email in the given list.DestructiveConfirm Subscriber By Email
Same as confirm_subscriber, but first finds the subscriber by email in the given list. Re-subscribing someone who opted out requires their consent, so confirm with the user first.
Inputs
dataobject- Optional extra subscriber fields to save in the same call, keyed by field tag, e.g. {"FNAME": "Jane"}. Usually omitted.
emailstring- Email address of the subscriber, e.g. "jane@example.org".
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_create_campaignCreates a new campaign, by default as a DRAFT that sends nothing.DestructiveCreate Campaign
Creates a new campaign, by default as a DRAFT that sends nothing. Needs list_uid, name, subject, from_name, from_email, reply_to, send_at and content (template_uid or template_content HTML). To duplicate a past campaign use copy_campaign; to create and schedule in one step use create_scheduled_campaign. status=pending-sending schedules real sending and requires confirm_send=true after explicit user approval.
Inputs
approval_referencestring- Approval reference (free text, e.g. an approval ticket ID). Needed only when the plan requires approval before sending; see get_my_mailsenpai_capabilities.
auto_plain_textstring- yes (default) to generate the plain-text version from the HTML.one of
yesnodefaultyes campaignobject- Alternative to the flat fields: a complete campaign object, e.g. {"name": "October news", "list_uid": "ab123cd456ef7", "subject": "Hello", "from_name": "Acme", "from_email": "news@acme.com", "reply_to": "news@acme.com", "send_at": "2026-10-15 09:30:00", "template": {"template_uid": "..."}}. When it is not empty the flat fields are ignored.
confirm_sendboolean- Must be true only with status=pending-sending, after the user has explicitly approved sending to real recipients.default
false cronjobstring- Advanced: cron expression to repeat a regular campaign, e.g. "0 9 * * 1" (Mondays 09:00). Usually omitted.
cronjob_enabledstring- Advanced: 1 to enable the cron repetition, 0 to disable.
email_statsstring- Optional email address that receives the statistics report when sending finishes.
from_emailstring- Sender email address, e.g. "news@acme.com".
from_namestring- Sender name shown to recipients, e.g. "Acme".
inline_cssstring- yes to convert <style> CSS into inline styles; default no.one of
yesnodefaultno json_feedstring- Advanced: yes to enable JSON feed tags in the content. Usually omitted.one of
yesno list_uidstring- Required (here or inside campaign): list_uid of the recipients' list, from list_lists.
namestring- Internal campaign name, e.g. "October newsletter".
plain_textstring- Optional plain-text version; normally generated automatically (auto_plain_text=yes).
plain_text_emailstring- yes (default) to also send a plain-text version.one of
yesnodefaultyes reply_tostring- Reply-to email address.
segment_uidstring- Optional: send only to this segment of the list (segment_uid from list_list_segments).
send_atstring- Send date and time "YYYY-MM-DD HH:MM:SS" in the account time zone, e.g. "2026-10-15 09:30:00". Required by the platform even for drafts; used only once the campaign is scheduled.
statusstring- draft (default, nothing is sent) or pending-sending (schedules real sending at send_at; requires confirm_send=true).one of
draftpending-sendingdefaultdraft subjectstring- Email subject line.
templateobject- Optional content: {"template_uid": "..."} to reuse a saved template, or {"content": "<html>...</html>"} for new HTML.
template_archivestring- Content option 3 (rare): ZIP archive with HTML and images, as "base64:<data>".
template_contentstring- Content option 2: the email HTML, e.g. "<html><body>Hello [FNAME]</body></html>". Encoded automatically.
template_uidstring- Content option 1: template_uid of a saved template (from list_templates).
typestring- regular (default, one-off send) or autoresponder (triggered by subscriber events).one of
regularautoresponderdefaultregular url_trackingstring- yes (default) to track link clicks, no to disable.one of
yesnodefaultyes xml_feedstring- Advanced: yes to enable XML/RSS feed tags in the content. Usually omitted.one of
yesno
mailsenpaimcp_create_or_update_subscriberUpsert: looks up data.EMAIL in the list; if found it updates that subscriber, otherwise it creates a new one.DestructiveCreate Or Update Subscriber
Upsert: looks up data.EMAIL in the list; if found it updates that subscriber, otherwise it creates a new one. Use it to sync contacts when you do not know whether they already exist. Existing values are overwritten, so confirm with the user before updating real contacts.
Inputs
dataobject- Subscriber data keyed by field tag; EMAIL is required, e.g. {"EMAIL": "jane@example.org", "FNAME": "Jane", "LNAME": "Doe"}. Optional: status, source, ip_address.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_create_scheduled_campaignCreates a campaign and schedules it for real sending in one step (status pending-sending at campaign.send_at).DestructiveCreate Scheduled Campaign
Creates a campaign and schedules it for real sending in one step (status pending-sending at campaign.send_at). To prepare a draft for review use create_campaign instead. Ask the user to approve list, content and send time, then call with confirm_send=true (plus approval_reference if the plan requires it).
Inputs
approval_referencestring- Approval reference (free text, e.g. an approval ticket ID). Needed only when the plan requires approval before sending; see get_my_mailsenpai_capabilities.
campaignobject- Campaign object with list_uid, name, subject, from_name, from_email, reply_to and send_at ("YYYY-MM-DD HH:MM:SS", account time zone); give the content with "template" inside it or with the template parameter.
confirm_sendboolean- Must be true to send or schedule. Set it only after the user has explicitly approved sending to real recipients; otherwise the call is rejected.default
false templateobject- Optional content: {"template_uid": "..."} to reuse a saved template, or {"content": "<html>...</html>"} for new HTML.
mailsenpaimcp_create_transactional_emailSends one transactional email to a single recipient, queued for immediate delivery or for send_at.DestructiveCreate Transactional Email
Sends one transactional email to a single recipient, queued for immediate delivery or for send_at. It is a real send: show the user the recipient and content and call with confirm_send=true only after approval. To email a whole list use a campaign instead.
Inputs
approval_referencestring- Approval reference (free text, e.g. an approval ticket ID). Needed only when the plan requires approval before sending; see get_my_mailsenpai_capabilities.
confirm_sendboolean- Must be true to send. Set it only after the user has approved the recipient and the content; otherwise the call is rejected.default
false emailobject- Email object, e.g. {"to_name": "Jane", "to_email": "jane@example.org", "from_name": "Acme", "from_email": "noreply@acme.com", "reply_to_email": "help@acme.com", "subject": "Your receipt", "body": "<base64 HTML>", "send_at": "YYYY-MM-DD HH:MM:SS"}. body (and optional plain_text) must be base64-encoded; to_email, to_name, from_name, subject and body are required; send_at defaults to now. Optional "attachments": [{"name": "a.pdf", "type": "application/pdf", "data": "<base64>"}].
mailsenpaimcp_delete_campaignPermanently deletes a campaign and its statistics; this cannot be undone.DestructiveDelete Campaign
Permanently deletes a campaign and its statistics; this cannot be undone. To stop a campaign but keep it use cancel_scheduled_campaign or pause_unpause_campaign. Ask the user for explicit confirmation, then call with confirm_delete=true.
Inputs
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false
mailsenpaimcp_delete_listPermanently deletes a mailing list together with all its subscribers, custom fields and segments; this cannot be undone.DestructiveDelete List
Permanently deletes a mailing list together with all its subscribers, custom fields and segments; this cannot be undone. Ask the user for explicit confirmation, then call with confirm_delete=true. Only available if the plan allows deletions.
Inputs
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_delete_list_fieldPermanently deletes a custom field from a list, together with the values stored in it for every subscriber; this cannot be undone.DestructiveDelete List Field
Permanently deletes a custom field from a list, together with the values stored in it for every subscriber; this cannot be undone. Ask the user for explicit confirmation, then call with confirm_delete=true.
Inputs
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false field_idstring- Numeric ID of the custom field (field_id), e.g. 12. Find it with list_list_fields.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_delete_list_segmentPermanently deletes a saved segment; the subscribers themselves are kept.DestructiveDelete List Segment
Permanently deletes a saved segment; the subscribers themselves are kept. Ask the user for explicit confirmation, then call with confirm_delete=true.
Inputs
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
segment_uidstring- Unique ID of the segment (segment_uid). Find it with list_list_segments.
mailsenpaimcp_delete_subscriberPermanently deletes a subscriber (by subscriber_uid) and its history from a list; this cannot be undone.DestructiveDelete Subscriber
Permanently deletes a subscriber (by subscriber_uid) and its history from a list; this cannot be undone. To stop emails while keeping the record use unsubscribe_subscriber instead. Ask the user for explicit confirmation, then call with confirm_delete=true.
Inputs
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
subscriber_uidstring- Unique ID of the subscriber (subscriber_uid), a 13-character code. Find it with search_subscriber_by_email or list_subscribers.
mailsenpaimcp_delete_subscriber_by_emailSame as delete_subscriber, but first finds the address in the given list.DestructiveDelete Subscriber By Email
Same as delete_subscriber, but first finds the address in the given list. Permanent; for a simple opt-out use unsubscribe_subscriber_by_email. Ask the user for explicit confirmation, then call with confirm_delete=true.
Inputs
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false emailstring- Email address of the subscriber, e.g. "jane@example.org".
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_delete_templatePermanently deletes a saved template; campaigns that already used it keep their content.DestructiveDelete Template
Permanently deletes a saved template; campaigns that already used it keep their content. Ask the user for explicit confirmation, then call with confirm_delete=true.
Inputs
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false template_uidstring- Unique ID of the saved email template (template_uid). Find it with list_templates or search_templates.
mailsenpaimcp_delete_transactional_emailPermanently deletes a transactional email record by email_uid; this cannot be undone.DestructiveDelete Transactional Email
Permanently deletes a transactional email record by email_uid; this cannot be undone. Ask the user for explicit confirmation, then call with confirm_delete=true.
Inputs
confirm_deleteboolean- Must be true to delete. Set it only after the user has explicitly confirmed this permanent deletion; otherwise the call is rejected.default
false email_uidstring- Unique ID of the transactional email (email_uid). Find it with list_transactional_emails.
mailsenpaimcp_mark_campaign_as_sentMarks a campaign as sent, which permanently stops any remaining delivery; it cannot be resumed afterwards.DestructiveMark Campaign As Sent
Marks a campaign as sent, which permanently stops any remaining delivery; it cannot be resumed afterwards. Use it only to close a stuck or abandoned campaign, after explicit user confirmation, with confirm_send=true.
Inputs
approval_referencestring- Approval reference (free text, e.g. an approval ticket ID). Needed only when the plan requires approval before sending; see get_my_mailsenpai_capabilities.
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
confirm_sendboolean- Must be true to send or schedule. Set it only after the user has explicitly approved sending to real recipients; otherwise the call is rejected.default
false
mailsenpaimcp_pause_unpause_campaignToggles a campaign between sending and paused: a sending campaign is paused, a paused campaign RESUMES sending.DestructivePause Unpause Campaign
Toggles a campaign between sending and paused: a sending campaign is paused, a paused campaign RESUMES sending. Check the current status with get_campaign first and confirm with the user, because resuming restarts delivery.
Inputs
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
mailsenpaimcp_reschedule_campaignChanges the send date and time of a campaign that is already scheduled (it stays pending-sending).DestructiveReschedule Campaign
Changes the send date and time of a campaign that is already scheduled (it stays pending-sending). Use schedule_campaign_send for a draft that is not scheduled yet. Requires confirm_send=true after the user approves the new time.
Inputs
approval_referencestring- Approval reference (free text, e.g. an approval ticket ID). Needed only when the plan requires approval before sending; see get_my_mailsenpai_capabilities.
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
confirm_sendboolean- Must be true to send or schedule. Set it only after the user has explicitly approved sending to real recipients; otherwise the call is rejected.default
false send_atstring- Send date and time as "YYYY-MM-DD HH:MM:SS" in the account time zone, e.g. "2026-10-15 09:30:00".
mailsenpaimcp_schedule_campaign_sendSchedules an existing draft campaign for real sending at send_at (status becomes pending-sending).DestructiveSchedule Campaign Send
Schedules an existing draft campaign for real sending at send_at (status becomes pending-sending). Use reschedule_campaign to move an already scheduled campaign and cancel_scheduled_campaign to stop it before it starts. Ask the user to approve, then call with confirm_send=true.
Inputs
approval_referencestring- Approval reference (free text, e.g. an approval ticket ID). Needed only when the plan requires approval before sending; see get_my_mailsenpai_capabilities.
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
confirm_sendboolean- Must be true to send or schedule. Set it only after the user has explicitly approved sending to real recipients; otherwise the call is rejected.default
false send_atstring- Send date and time as "YYYY-MM-DD HH:MM:SS" in the account time zone, e.g. "2026-10-15 09:30:00".
mailsenpaimcp_set_subscriber_statusSets any status on a subscriber identified by subscriber_uid: confirmed, unconfirmed, unsubscribed, blacklisted, unapproved, disabled or moved.DestructiveSet Subscriber Status
Sets any status on a subscriber identified by subscriber_uid: confirmed, unconfirmed, unsubscribed, blacklisted, unapproved, disabled or moved. For the common cases prefer confirm_subscriber or unsubscribe_subscriber. It changes who receives emails, so confirm with the user first.
Inputs
dataobject- Optional extra subscriber fields to save in the same call, keyed by field tag, e.g. {"FNAME": "Jane"}. Usually omitted.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
statusstring- Subscriber status: confirmed, unconfirmed, unsubscribed, blacklisted, unapproved, disabled or moved.one of
confirmedunconfirmedunsubscribedblacklistedunapproveddisabledmoved subscriber_uidstring- Unique ID of the subscriber (subscriber_uid), a 13-character code. Find it with search_subscriber_by_email or list_subscribers.
mailsenpaimcp_set_subscriber_status_by_emailSame as set_subscriber_status, but first finds the subscriber by email in the given list.DestructiveSet Subscriber Status By Email
Same as set_subscriber_status, but first finds the subscriber by email in the given list. It changes who receives emails, so confirm with the user first.
Inputs
dataobject- Optional extra subscriber fields to save in the same call, keyed by field tag, e.g. {"FNAME": "Jane"}. Usually omitted.
emailstring- Email address of the subscriber, e.g. "jane@example.org".
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
statusstring- Subscriber status: confirmed, unconfirmed, unsubscribed, blacklisted, unapproved, disabled or moved.one of
confirmedunconfirmedunsubscribedblacklistedunapproveddisabledmoved
mailsenpaimcp_unsubscribe_subscriberUnsubscribes one subscriber (by subscriber_uid) from one list: the record and its history are kept with status unsubscribed and it stops receiving campaigns; reversible with confirm_subscriber.DestructiveUnsubscribe Subscriber
Unsubscribes one subscriber (by subscriber_uid) from one list: the record and its history are kept with status unsubscribed and it stops receiving campaigns; reversible with confirm_subscriber. Use delete_subscriber only to erase the record completely. Confirm with the user first.
Inputs
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
subscriber_uidstring- Unique ID of the subscriber (subscriber_uid), a 13-character code. Find it with search_subscriber_by_email or list_subscribers.
mailsenpaimcp_unsubscribe_subscriber_by_emailSame as unsubscribe_subscriber, but finds the address in ONE given list.DestructiveUnsubscribe Subscriber By Email
Same as unsubscribe_subscriber, but finds the address in ONE given list. To opt an address out of every list at once use unsubscribe_subscriber_from_all_lists_by_email. Confirm with the user first.
Inputs
emailstring- Email address of the subscriber, e.g. "jane@example.org".
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_unsubscribe_subscriber_from_all_lists_by_emailUnsubscribes an email address from ALL lists of the account in one call; the records are kept with status unsubscribed.DestructiveUnsubscribe Subscriber From All Lists By Email
Unsubscribes an email address from ALL lists of the account in one call; the records are kept with status unsubscribed. Use it for global opt-out requests; use unsubscribe_subscriber_by_email for a single list. Confirm with the user first.
Inputs
emailstring- Email address of the subscriber, e.g. "jane@example.org".
mailsenpaimcp_update_campaignEdits an existing campaign by campaign_uid (name, subject, sender, list or segment, content, send time); normally only drafts and paused campaigns can be changed.DestructiveUpdate Campaign
Edits an existing campaign by campaign_uid (name, subject, sender, list or segment, content, send time); normally only drafts and paused campaigns can be changed. Setting status=pending-sending or a send_at schedules real sending and needs confirm_send=true after explicit user approval; confirm other changes with the user too.
Inputs
approval_referencestring- Approval reference (free text, e.g. an approval ticket ID). Needed only when the plan requires approval before sending; see get_my_mailsenpai_capabilities.
campaignobject- Campaign fields to change, e.g. {"subject": "New subject"} or {"send_at": "2026-10-15 09:30:00"}. Setting status pending-sending or send_at requires confirm_send=true.
campaign_uidstring- Unique ID of the campaign (campaign_uid), a 13-character code. Find it with list_campaigns.
confirm_sendboolean- Must be true to send or schedule. Set it only after the user has explicitly approved sending to real recipients; otherwise the call is rejected.default
false templateobject- Optional content: {"template_uid": "..."} to reuse a saved template, or {"content": "<html>...</html>"} for new HTML.
mailsenpaimcp_update_listChanges the settings of an existing list (name, description, default sender, notifications, company) identified by list_uid.DestructiveUpdate List
Changes the settings of an existing list (name, description, default sender, notifications, company) identified by list_uid. Takes the same data format as create_list; subscribers are not touched. It overwrites the current values, so confirm the changes with the user first.
Inputs
dataobject- Settings to change, same format as create_list, e.g. {"name": "Newsletter IT", "from_name": "Acme Italia"}.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_update_list_fieldChanges an existing custom field (label, tag, type, required flag, visibility, options) by field_id.DestructiveUpdate List Field
Changes an existing custom field (label, tag, type, required flag, visibility, options) by field_id. Changing the tag or type can break templates and segments that use the field, so confirm with the user first.
Inputs
dataobject- Field properties to set, same format as create_list_field, e.g. {"label": "Town", "required": "yes"}.
field_idstring- Numeric ID of the custom field (field_id), e.g. 12. Find it with list_list_fields.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_update_list_segmentReplaces the name, match mode and conditions of an existing segment by segment_uid.DestructiveUpdate List Segment
Replaces the name, match mode and conditions of an existing segment by segment_uid. Campaigns that target the segment will use the new conditions, so confirm with the user first.
Inputs
dataobject- New segment definition, same format as create_list_segment.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
segment_uidstring- Unique ID of the segment (segment_uid). Find it with list_list_segments.
mailsenpaimcp_update_subscriberUpdates the custom field values (and optionally the status) of an existing subscriber identified by subscriber_uid.DestructiveUpdate Subscriber
Updates the custom field values (and optionally the status) of an existing subscriber identified by subscriber_uid. Use update_subscriber_by_email if you only have the address. It overwrites the values you pass, so confirm with the user first.
Inputs
dataobject- Fields to change keyed by field tag, e.g. {"FNAME": "Janet", "CITY": "Milan"}. To change only the status prefer the set_subscriber_status tools.
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
subscriber_uidstring- Unique ID of the subscriber (subscriber_uid), a 13-character code. Find it with search_subscriber_by_email or list_subscribers.
mailsenpaimcp_update_subscriber_by_emailSame as update_subscriber, but first finds the subscriber by email address in the given list; returns an error if the address is not in that list.DestructiveUpdate Subscriber By Email
Same as update_subscriber, but first finds the subscriber by email address in the given list; returns an error if the address is not in that list. It overwrites the values you pass, so confirm with the user first.
Inputs
dataobject- Fields to change keyed by field tag, e.g. {"FNAME": "Janet", "CITY": "Milan"}. To change only the status prefer the set_subscriber_status tools.
emailstring- Email address of the subscriber, e.g. "jane@example.org".
list_uidstring- Unique ID of the mailing list (list_uid), a 13-character code such as "ab123cd456ef7". Find it with list_lists.
mailsenpaimcp_update_templateReplaces the name and/or HTML content of an existing template by template_uid.DestructiveUpdate Template
Replaces the name and/or HTML content of an existing template by template_uid. Campaigns already created from it keep their own copy of the content. It overwrites the template, so confirm with the user first.
Inputs
templateobject- Template fields to replace, same format as create_template, e.g. {"name": "Welcome v2", "content": "<html>...</html>"}.
template_uidstring- Unique ID of the saved email template (template_uid). Find it with list_templates or search_templates.
No tools match.