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
MCPhttps://g.sendcorex.com/mcp/account
Read onlynever changes anythingChanges datacreates or updatesAsks to confirmsends email or deletes: your app asks you first
75 tools

Domains

10
  • domain_list

    List sending domains

    Lists every sending domain on the account (lightweight, no live DNS check).

    Read onlydomain:read
  • domain_get

    Get 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:read
  • domain_list_free

    List 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:read
  • domain_send_dns_instructions

    Email DNS setup instructions

    Emails the DNS records (SPF, DKIM, Return-Path, DMARC) needed for a domain to any address, e.g.

    Changes datadomain:read
  • domain_add

    Add 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:create
  • domain_start_dkim_upgrade

    Start 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:create
  • domain_cancel_dkim_upgrade

    Cancel DKIM upgrade

    Cancels a pending 2048-bit DKIM upgrade and discards the pending key; the current key stays in use.

    Asks to confirmdomain:create
  • domain_update_description

    Set domain description

    Sets or clears the free-text description (internal note) of a domain; an empty string or null clears it.

    Changes datadomain:create
  • domain_request_remediation

    Request 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:create
  • domain_delete

    Delete sending domain

    Permanently deletes a domain, its DKIM keys and ALL senders on it; this cannot be undone.

    Asks to confirmdomain:delete

Senders

6
  • sender_list

    List senders

    Lists every sender (from address) on the account.

    Read onlysender:read
  • sender_get

    Get sender

    Returns one sender by sender_id, same fields as an item of sender_list (including reputation).

    Read onlysender:read
  • sender_create

    Create sender

    Creates the sender username@domain on a validated domain of the account, or on a shared domain from domain_list_free.

    Changes datasender:create
  • sender_update

    Update sender

    Changes a sender's from_name and/or reply_to (at least one must be sent; username and domain cannot change).

    Changes datasender:update
  • sender_update_description

    Set sender description

    Sets or clears the free-text description (internal note) of a sender; an empty string or null clears it.

    Changes datasender:update
  • sender_delete

    Delete sender

    Permanently deletes a sender; this cannot be undone.

    Asks to confirmsender:delete

Templates

8
  • template_list

    List templates

    Lists the account's email templates (newest updated first), optionally filtered by type (unlayer, custom or html).

    Read onlytemplate:read
  • template_get

    Get template

    Gets one template by template_id (html_<uuid>, unlayer_<number> or custom_<uuid>) including its content.

    Read onlytemplate:read
  • template_render

    Render 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:read
  • template_list_versions

    List template versions

    Lists the saved versions of a template (each update keeps a version; only the last 10 are kept).

    Read onlytemplate:read
  • template_create

    Create HTML template

    Creates a new html-type template from your own HTML (max 512 KB; unsafe content is rejected).

    Changes datatemplate:create
  • template_update

    Update 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:update
  • template_restore_version

    Restore template version

    Restores an html-type template to a previous version, overwriting its current content.

    Asks to confirmtemplate:update
  • template_delete

    Delete 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

2
  • logs_list

    List 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:read
  • logs_get

    Get 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

2
  • feedback_list

    List 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:read
  • feedback_get_email

    Get 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

5
  • counters_get_totals

    Get all-time totals

    Gets the account's all-time sending counters across API, SMTP and campaigns.

    Read onlycounters:read
  • counters_get_month

    Get monthly counters

    Gets the sending counters of one calendar month (UTC); defaults to the current month.

    Read onlycounters:read
  • counters_get_months

    Get 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:read
  • counters_get_daily

    Get 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:read
  • counters_get_hourly

    Get counters by hour

    Gets sending counters per UTC hour between two instants (max 7 days apart).

    Read onlycounters:read

Contacts

30
  • contacts_get

    Get contacts by email

    Fetch up to 100 contacts by exact email address.

    Read onlycontact:read
  • contacts_query

    Query contacts

    Search/filter contacts with a 'where' filter and optional sort, paginated (limit 1–1000, default 50).

    Read onlycontact:read
  • contacts_count

    Count contacts

    Count contacts matching a 'where' filter (same filter as contacts_query), stopping at 'max' (default 100000).

    Read onlycontact:read
  • contacts_list_events

    List 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:read
  • contacts_get_stats

    Get 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:read
  • contacts_list_fields

    List custom fields

    List the account's custom contact field definitions (key, name, type, options, created_at, updated_at).

    Read onlycontact:read
  • contacts_define_field

    Define custom field

    Create a custom contact field, or update the name/options of an existing one (the type cannot change).

    Changes datacontact:create
  • contacts_delete_field

    Delete custom field

    Delete a custom field definition and purge its values from every contact in the background (irreversible).

    Asks to confirmcontact:delete
  • contacts_list_lists

    List contact lists

    List all contact lists, oldest first.

    Read onlycontact:read
  • contacts_get_list

    Get contact list

    Get one list with its member stats {total, ok, opened, clicked}.

    Read onlycontact:read
  • contacts_list_members

    List 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:read
  • contacts_create_list

    Create contact list

    Create a contact list (id generated unless list_id is given).

    Changes datacontact:create
  • contacts_update_list

    Update contact list

    Update a list's attributes; only the given args change, and null/"" clears an optional attribute.

    Changes datacontact:update
  • contacts_delete_list

    Delete 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:delete
  • contacts_list_segments

    List segments

    List saved segments (segment_id, name, where, sort, created_at, updated_at).

    Read onlycontact:read
  • contacts_get_segment

    Get segment

    Get one saved segment's definition (segment_id, name, where, sort, created_at, updated_at).

    Read onlycontact:read
  • contacts_run_segment

    Run segment

    Return the contacts currently matching a saved segment (its where + sort), paginated like contacts_query (limit 1–1000, default 50).

    Read onlycontact:read
  • contacts_save_segment

    Save 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:create
  • contacts_delete_segment

    Delete segment

    Delete a saved segment definition (contacts are not affected).

    Asks to confirmcontact:delete
  • contacts_upsert

    Create 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:update
  • contacts_update

    Update existing contacts

    Same as contacts_upsert but never creates: emails without a contact fail with NOT_FOUND.

    Changes datacontact:update
  • contacts_add_tags

    Add tags to contacts

    Add tags to up to 500 existing contacts.

    Changes datacontact:update
  • contacts_remove_tags

    Remove tags from contacts

    Remove tags from up to 500 existing contacts.

    Asks to confirmcontact:update
  • contacts_add_to_lists

    Add contacts to lists

    Add up to 500 existing contacts to one or more lists (as subscribed members).

    Changes datacontact:update
  • contacts_remove_from_lists

    Remove 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:update
  • contacts_set_list_subscription

    Set 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:update
  • contacts_set_status

    Set contact status

    Set the global status of up to 500 contacts (subscribed, unsubscribed, bounced, complained, blocked); only subscribed contacts are sendable.

    Changes datacontact:update
  • contacts_set_fields

    Set custom field values

    Set custom field values on up to 500 contacts (same values for all).

    Changes datacontact:update
  • contacts_unset_fields

    Clear custom field values

    Remove custom field values (by key) from up to 500 contacts; the field definitions stay.

    Asks to confirmcontact:update
  • contacts_delete

    Delete contacts

    Permanently delete up to 500 contacts (profile, fields, tags, list memberships).

    Asks to confirmcontact:delete

Tracking preferences

5
  • privacy_get_preferences

    Get recipient tracking preferences

    Returns the open/click tracking preference one recipient chose (via the privacy page, dashboard or API).

    Read onlyprivacy:read
  • privacy_get_many

    Get tracking preferences for many recipients

    Batch lookup of open/click tracking preferences for 1–100 recipients.

    Read onlyprivacy:read
  • privacy_get_history

    Get recipient preference history

    Returns the change history of one recipient's tracking preferences, newest first.

    Read onlyprivacy:read
  • privacy_list_changes

    List 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:read
  • privacy_set_preferences

    Set 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

5
  • validator_validate_email

    Validate 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:validate
  • validator_validate_emails

    Validate 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:validate
  • validator_list_validations

    List past email validations

    Lists the account's email validation history, newest first, optionally filtered to one email address; free (no credits).

    Read onlytools:validate
  • validator_check_disposable

    Check 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:validate
  • validator_list_disposable_checks

    List past disposable checks

    Lists the account's disposable-check history, newest first; free (no credits).

    Read onlytools:validate

Send email

2
  • email_send

    Send 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:send
  • email_cancel_scheduled

    Cancel scheduled email

    Cancels an email scheduled with email_send + scheduled_at, before it is sent.

    Changes dataemail:send