AI apps (MCP)
Account tools
Every tool on the account server. The list your app sees depends on the permissions you granted.
- 75 tools
- 10 groups
https://g.sendcorex.com/mcp/accountDomains
10domain_listList sending domains
Lists every sending domain on the account (lightweight, no live DNS check).
Read onlydomain:readdomain_getGet domain and check DNS
Returns one domain with the DNS records to publish and checks DNS live: marks the domain validated once Return-Path (CNAME) and DKIM are published, and promotes a pending 2048-bit DKIM key when its new TXT record is visible.
Read onlydomain:readdomain_list_freeList shared free domains
Lists the shared domains that can be used to create a sender without owning a domain (pass one as domain in sender_create).
Read onlydomain:readdomain_send_dns_instructionsEmail DNS setup instructions
Emails the DNS records (SPF, DKIM, Return-Path, DMARC) needed for a domain to any address, e.g.
Changes datadomain:readdomain_addAdd sending domain
Adds a sending domain to the account and generates its DKIM key; the domain starts unvalidated until the returned DNS records are published (then verify with domain_get).
Changes datadomain:createdomain_start_dkim_upgradeStart DKIM 2048-bit upgrade
Starts replacing a 1024-bit DKIM key with a 2048-bit one under a new selector; the old key keeps signing until the new TXT record (dns_records.dkim_pending) is published, after which domain_get promotes it automatically.
Changes datadomain:createdomain_cancel_dkim_upgradeCancel DKIM upgrade
Cancels a pending 2048-bit DKIM upgrade and discards the pending key; the current key stays in use.
Asks to confirmdomain:createdomain_update_descriptionSet domain description
Sets or clears the free-text description (internal note) of a domain; an empty string or null clears it.
Changes datadomain:createdomain_request_remediationRequest blocklist remediation
Submits a manual review request for a domain that domain_add rejected as BLACKLISTED; once approved, domain_add can be retried.
Changes datadomain:createdomain_deleteDelete sending domain
Permanently deletes a domain, its DKIM keys and ALL senders on it; this cannot be undone.
Asks to confirmdomain:delete
Senders
6sender_listList senders
Lists every sender (from address) on the account.
Read onlysender:readsender_getGet sender
Returns one sender by sender_id, same fields as an item of sender_list (including reputation).
Read onlysender:readsender_createCreate sender
Creates the sender username@domain on a validated domain of the account, or on a shared domain from domain_list_free.
Changes datasender:createsender_updateUpdate sender
Changes a sender's from_name and/or reply_to (at least one must be sent; username and domain cannot change).
Changes datasender:updatesender_update_descriptionSet sender description
Sets or clears the free-text description (internal note) of a sender; an empty string or null clears it.
Changes datasender:updatesender_deleteDelete sender
Permanently deletes a sender; this cannot be undone.
Asks to confirmsender:delete
Templates
8template_listList templates
Lists the account's email templates (newest updated first), optionally filtered by type (unlayer, custom or html).
Read onlytemplate:readtemplate_getGet template
Gets one template by template_id (html_<uuid>, unlayer_<number> or custom_<uuid>) including its content.
Read onlytemplate:readtemplate_renderRender template
Renders a template replacing {{variable}} placeholders with the given values (HTML-escaped in html, raw in subject and text) to preview what will be sent.
Read onlytemplate:readtemplate_list_versionsList template versions
Lists the saved versions of a template (each update keeps a version; only the last 10 are kept).
Read onlytemplate:readtemplate_createCreate HTML template
Creates a new html-type template from your own HTML (max 512 KB; unsafe content is rejected).
Changes datatemplate:createtemplate_updateUpdate HTML template
Updates an html-type template: send at least one of name, html, text or subject (text/subject null clears them).
Asks to confirmtemplate:updatetemplate_restore_versionRestore template version
Restores an html-type template to a previous version, overwriting its current content.
Asks to confirmtemplate:updatetemplate_deleteDelete HTML template
Permanently deletes an html-type template (Unlayer and Custom templates can only be deleted in the dashboard: TEMPLATE_READ_ONLY).
Asks to confirmtemplate:delete
Email logs
2logs_listList email logs
Searches the account's sent-email logs (API, SMTP and campaigns; warmup excluded), newest first, with AND-combined filters; default window is the last 60 days.
Read onlylogs:readlogs_getGet email logs by id
Fetches email logs by email id (UUID), up to 50 per call or 10 with include_content=true (adds content.html, the sent HTML).
Read onlylogs:read
Bounces & complaints
2feedback_listList feedback events
Lists bounce, complaint and dropped-email events for the account, oldest first (90-day retention), for syncing suppressions: store next_cursor and pass it on the next call (has_more=true means more are ready now).
Read onlyfeedback:readfeedback_get_emailGet feedback for an email
Gets the feedback events of one sent email by email_id: at most one bounce, one complaint and one dropped event.
Read onlyfeedback:read
Counters
5counters_get_totalsGet all-time totals
Gets the account's all-time sending counters across API, SMTP and campaigns.
Read onlycounters:readcounters_get_monthGet monthly counters
Gets the sending counters of one calendar month (UTC); defaults to the current month.
Read onlycounters:readcounters_get_monthsGet counters by month
Gets sending counters per month (UTC) for a range of months, plus the period total; omit from/to for an open-ended range (all months).
Read onlycounters:readcounters_get_dailyGet counters by day
Gets sending counters per day for a date range (both inclusive, max 400 days), with days cut in the given IANA timezone (default UTC).
Read onlycounters:readcounters_get_hourlyGet counters by hour
Gets sending counters per UTC hour between two instants (max 7 days apart).
Read onlycounters:read
Contacts
30contacts_getGet contacts by email
Fetch up to 100 contacts by exact email address.
Read onlycontact:readcontacts_queryQuery contacts
Search/filter contacts with a 'where' filter and optional sort, paginated (limit 1–1000, default 50).
Read onlycontact:readcontacts_countCount contacts
Count contacts matching a 'where' filter (same filter as contacts_query), stopping at 'max' (default 100000).
Read onlycontact:readcontacts_list_eventsList contact events
List the activity timeline of one contact (sent, open, click, bounce, complaint, unsubscribe), newest first, paginated (limit 1–1000, default 50).
Read onlycontact:readcontacts_get_statsGet contact totals
Account-wide contact counters without scanning: returns {total, status: {status: n}, lists: {list_id: {total, ok, opened, clicked}}, tags: {tag: n}}.
Read onlycontact:readcontacts_list_fieldsList custom fields
List the account's custom contact field definitions (key, name, type, options, created_at, updated_at).
Read onlycontact:readcontacts_define_fieldDefine custom field
Create a custom contact field, or update the name/options of an existing one (the type cannot change).
Changes datacontact:createcontacts_delete_fieldDelete custom field
Delete a custom field definition and purge its values from every contact in the background (irreversible).
Asks to confirmcontact:deletecontacts_list_listsList contact lists
List all contact lists, oldest first.
Read onlycontact:readcontacts_get_listGet contact list
Get one list with its member stats {total, ok, opened, clicked}.
Read onlycontact:readcontacts_list_membersList list members
Page through the members of a list: each member has email, sendable, subscribed, added_at, plus the full contact when hydrate is true.
Read onlycontact:readcontacts_create_listCreate contact list
Create a contact list (id generated unless list_id is given).
Changes datacontact:createcontacts_update_listUpdate contact list
Update a list's attributes; only the given args change, and null/"" clears an optional attribute.
Changes datacontact:updatecontacts_delete_listDelete contact list
Delete a list: it disappears immediately and its memberships are purged from contacts in the background (contacts themselves are kept).
Asks to confirmcontact:deletecontacts_list_segmentsList segments
List saved segments (segment_id, name, where, sort, created_at, updated_at).
Read onlycontact:readcontacts_get_segmentGet segment
Get one saved segment's definition (segment_id, name, where, sort, created_at, updated_at).
Read onlycontact:readcontacts_run_segmentRun segment
Return the contacts currently matching a saved segment (its where + sort), paginated like contacts_query (limit 1–1000, default 50).
Read onlycontact:readcontacts_save_segmentSave segment
Create a saved segment, or replace an existing one's name/where/sort when segment_id is given (omitting sort clears it).
Changes datacontact:createcontacts_delete_segmentDelete segment
Delete a saved segment definition (contacts are not affected).
Asks to confirmcontact:deletecontacts_upsertCreate or update contacts
Create or update up to 500 contacts by email; only the given attributes change (null clears a profile attribute or field).
Changes datacontact:createcontact:updatecontacts_updateUpdate existing contacts
Same as contacts_upsert but never creates: emails without a contact fail with NOT_FOUND.
Changes datacontact:updatecontacts_add_tagsAdd tags to contacts
Add tags to up to 500 existing contacts.
Changes datacontact:updatecontacts_remove_tagsRemove tags from contacts
Remove tags from up to 500 existing contacts.
Asks to confirmcontact:updatecontacts_add_to_listsAdd contacts to lists
Add up to 500 existing contacts to one or more lists (as subscribed members).
Changes datacontact:updatecontacts_remove_from_listsRemove contacts from lists
Remove up to 500 existing contacts from one or more lists (drops the membership; to keep it but stop sending, use contacts_set_list_subscription).
Asks to confirmcontact:updatecontacts_set_list_subscriptionSet list subscription
Subscribe or unsubscribe up to 500 contacts within one list (membership is kept; unsubscribed members are not sendable for that list).
Changes datacontact:updatecontacts_set_statusSet contact status
Set the global status of up to 500 contacts (subscribed, unsubscribed, bounced, complained, blocked); only subscribed contacts are sendable.
Changes datacontact:updatecontacts_set_fieldsSet custom field values
Set custom field values on up to 500 contacts (same values for all).
Changes datacontact:updatecontacts_unset_fieldsClear custom field values
Remove custom field values (by key) from up to 500 contacts; the field definitions stay.
Asks to confirmcontact:updatecontacts_deleteDelete contacts
Permanently delete up to 500 contacts (profile, fields, tags, list memberships).
Asks to confirmcontact:delete
Tracking preferences
5privacy_get_preferencesGet recipient tracking preferences
Returns the open/click tracking preference one recipient chose (via the privacy page, dashboard or API).
Read onlyprivacy:readprivacy_get_manyGet tracking preferences for many recipients
Batch lookup of open/click tracking preferences for 1–100 recipients.
Read onlyprivacy:readprivacy_get_historyGet recipient preference history
Returns the change history of one recipient's tracking preferences, newest first.
Read onlyprivacy:readprivacy_list_changesList tracking preference changes
Incremental feed of every recipient preference change on the account (oldest first, last 90 days), for syncing to a CRM.
Read onlyprivacy:readprivacy_set_preferencesSet recipient tracking preferences
Records a recipient's open and/or click tracking choice (source "api"); a field that is omitted keeps its current value, and at least one of track_opens/track_clicks is required.
Changes dataprivacy:write
Email validation
5validator_validate_emailValidate an email address
Fully validates one email address (syntax, domain/MX, disposable, typo and live SMTP deliverability checks); costs 1 validation credit (cached results within 5 min are also charged) and can take up to ~40s.
Changes datatools:validatevalidator_validate_emailsValidate a batch of emails
Fully validates up to 50 email addresses in one call (same checks as validator_validate_email, including SMTP); can take up to ~110s.
Changes datatools:validatevalidator_list_validationsList past email validations
Lists the account's email validation history, newest first, optionally filtered to one email address; free (no credits).
Read onlytools:validatevalidator_check_disposableCheck for disposable email domain
Checks whether an email address or domain belongs to a disposable/temporary email provider (DNS and reputation checks, no SMTP); pass email or domain (at least one).
Changes datatools:validatevalidator_list_disposable_checksList past disposable checks
Lists the account's disposable-check history, newest first; free (no credits).
Read onlytools:validate
Send email
2email_sendSend transactional email
Sends a transactional email through the Sendcorex Email API (same as POST /v3.0/send): validation, anti-spam, credits (1 per recipient) and daily limit, tracking, contact lists, scheduling.
Asks to confirmemail:sendemail_cancel_scheduledCancel scheduled email
Cancels an email scheduled with email_send + scheduled_at, before it is sent.
Changes dataemail:send