Every action runs strictly under your authenticated Mailing Engineer identity via OAuth 2.1. Read tools never modify data. Destructive tools (such as dispatching a campaign) always ask for your confirmation in the chat interface.
Audience & Segments 15
List contacts
list_contactsread
List or count the contacts in the audience that match a set of filters.
Use when the user asks who is in the audience, how many contacts match some criteria, or to inspect subscribers in a specific segment.
Parameters
| Parameter | Type | Description |
|---|
search | string | Text to look for in the first name, last name, or email address. |
segment_name | string | Filter contacts by segment name (e.g. "General", "VIP", "Gmail (@gmail.com)"). |
email_status | enum | Filter by consent status: subscribed or unsubscribed. |
count_only | boolean | If true, returns only the total count without listing individual rows. |
page | integer | Page number, starting at 1. |
per_page | integer | Items per page, between 1 and 100 (default 20). |
Get contact details
get_contact_detailsread
Retrieve full profile, segment membership, and subscription status for a single subscriber by email or ID.
Use when the user asks about a specific subscriber such as "What is the status of ana@example.com?".
Parameters
| Parameter | Type | Description |
|---|
email | string | Email address of the subscriber (case-insensitive). |
contact_id | integer | Optional numeric ID of the contact. |
Create contact
create_contactwrite
Add a new subscriber to the audience with automatic Anti-Bounce & Global DNC verification.
Creates or updates a contact and assigns them to the specified segment.
Parameters
| Parameter | Type | Description |
|---|
emailrequired | string | Subscriber email address. |
first_name | string | Subscriber first name. |
last_name | string | Subscriber last name. |
segment_name | string | Target segment or tag (default: "General"). |
Update contact
update_contactdestructive
Update an existing subscriber first name, last name, segment or subscription status.
Modifies contact attributes for an existing email address.
Parameters
| Parameter | Type | Description |
|---|
emailrequired | string | Email address of the contact to update. |
first_name | string | New first name. |
last_name | string | New last name. |
segment_name | string | New segment name. |
Unsubscribe contact
unsubscribe_contactdestructive
Immediately mark a subscriber as unsubscribed (opt-out) across future campaigns.
Sets is_unsubscribed = 1 so the contact will never receive commercial campaigns.
Parameters
| Parameter | Type | Description |
|---|
emailrequired | string | Email address to unsubscribe. |
Delete contact
delete_contactdestructive
Permanently delete a contact from the client database (GDPR erasure).
Irreversibly removes the contact row from saas_contacts.
Parameters
| Parameter | Type | Description |
|---|
emailrequired | string | Email address of the contact to delete. |
Import contacts batch
import_contactsdestructive
Bulk import a list of email addresses into a segment with automatic MX & Global Bounce filtering.
Filters out invalid syntax, dead MX domains, and historical bounces before importing.
Parameters
| Parameter | Type | Description |
|---|
emailsrequired | string | Comma or newline-separated list of email addresses to import. |
segment_name | string | Segment name to assign (default: "General"). |
Validate email list hygiene (MX & Anti-Bounce)
validate_email_hygieneread
Check one or more email addresses for syntax, disposable domains, MX records, and global bounce history.
Exclusive Mailing Engineer hygiene shield that protects Amazon SES reputation before sending.
Parameters
| Parameter | Type | Description |
|---|
emailsrequired | string | One or more email addresses separated by comma or space. |
List segments
list_segmentsread
List all audience segments with total and active subscriber counts.
Returns every segment configured in the account along with active vs unsubscribed counts.
No parameters required.
Create or auto-split segment
create_segmentwrite
Automatically segment contacts by ISP provider (Gmail, Yahoo, Outlook, Corporate) or into equal sending batches.
Supports ISP smart segmentation, batch splitting, or renaming an existing segment.
Parameters
| Parameter | Type | Description |
|---|
moderequired | enum | Segmentation mode: "isp", "batches", or "rename". |
batch_size | integer | Batch size when mode="batches" (e.g. 5000). |
prefix | string | Label prefix for batches (e.g. "Lot"). |
source_segment | string | Source segment name when renaming or splitting. |
new_name | string | New segment name when mode="rename". |
Get audience evolution
get_audience_evolutionread
Track subscriber growth, newly added contacts, and unsubscribes over the last 30 days.
Returns daily and monthly acquisition metrics for the audience.
Parameters
| Parameter | Type | Description |
|---|
days | integer | Lookback window in days (default: 30). |
Get audience breakdown by ISP & status
get_audience_breakdownread
Break down the subscriber base by email provider (Gmail, Yahoo, Outlook, Corporate .RO) and consent status.
Helps optimize deliverability and subject lines for the dominant inbox providers in the list.
No parameters required.
Analyze audience RFM & engagement health
analyze_audienceread
Perform a strategic health analysis of the audience, including list hygiene status and 10k Bonus Shield eligibility.
Combines segment distribution, bounce shield status, and engagement metrics.
No parameters required.
Get audience filter options
get_audience_optionsread
Return available segments, consent statuses, and ISP groups for filtering contacts.
Useful before calling list_contacts or create_campaign.
No parameters required.
Migrate contacts in 1-Click from Klaviyo, NewsMAN, Mailchimp or Brevo
migrate_contacts_from_espwrite
Import subscribers in 1-Click from Klaviyo, NewsMAN, Mailchimp, or Brevo (via API key or exported list), running automatic Anti-Bounce & MX validation and separating Yahoo and Gmail segments.
Validates every subscriber against MX records and global bounce rules, imports clean contacts, and automatically isolates @yahoo.com and @gmail.com subscribers into dedicated segments for safe deliverability.
Parameters
| Parameter | Type | Description |
|---|
source_esprequired | enum | Source ESP platform: klaviyo, newsman, mailchimp, brevo, or csv_export. |
api_key | string | Optional API key from Klaviyo, NewsMAN, Mailchimp, or Brevo for automatic pull. |
list_id | string | Optional external list or audience ID in the source ESP. |
emails_export | string | Comma, semicolon, or newline-separated subscriber list exported from the ESP. |
auto_split_yahoo_gmail | boolean | If true (default), automatically segments imported contacts into dedicated Yahoo and Gmail segments. |
Campaigns 8
List email campaigns
list_campaignsread
List recent, scheduled, or sent email campaigns with delivery, open, and click counts.
Returns campaigns ordered from newest to oldest.
Parameters
| Parameter | Type | Description |
|---|
status | enum | Filter by campaign status: all, sent, sending, scheduled, paused_safety, cancelled. |
limit | integer | Maximum number of campaigns to return (1-50, default 15). |
Get campaign details
get_campaign_detailsread
Get full metadata, sender configuration, target segment, and HTML preview snippet for a campaign.
Pass campaign_id from list_campaigns.
Parameters
| Parameter | Type | Description |
|---|
campaign_idrequired | integer | Numeric ID of the campaign. |
Get campaign performance report
get_campaign_reportread
Get detailed delivery, open rate, click-through rate (CTR), bounce rate, and unsubscribe metrics for a campaign.
Includes Canary Batch safety telemetry and credit cost breakdown.
Parameters
| Parameter | Type | Description |
|---|
campaign_idrequired | integer | Numeric ID of the campaign. |
Create or schedule email campaign
create_campaigndestructive
Create and dispatch (or schedule for a future date/time) an email campaign to a target segment.
Automatically applies first-party tracking on nl., rewrites Shopify images, and enforces the 2% SES Canary Circuit Breaker.
Parameters
| Parameter | Type | Description |
|---|
namerequired | string | Internal name of the campaign (e.g. "Black Friday VIP Drop"). |
subjectrequired | string | Email subject line. |
preheader_text | string | Optional inbox preview text. |
segment_name | string | Target segment name (default: "all"). |
scheduled_at | string | Optional ISO-8601 future date/time to schedule sending (e.g. "2026-11-15T09:00:00Z"). Leave empty to send immediately. |
custom_html | string | Full responsive HTML body of the newsletter. |
from_name | string | Optional sender display name. |
from_address | string | Optional sender email address on the client verified domain. |
Update scheduled campaign
update_campaigndestructive
Update the name, subject, scheduled time, or HTML content of a scheduled campaign before it sends.
Only campaigns that have not finished sending can be modified.
Parameters
| Parameter | Type | Description |
|---|
campaign_idrequired | integer | Numeric ID of the campaign to update. |
name | string | Updated campaign name. |
subject | string | Updated email subject line. |
scheduled_at | string | Updated ISO-8601 scheduled time. |
custom_html | string | Updated HTML body. |
Send test campaign email
send_test_campaigndestructive
Send a real-time test email (either a DNS alignment test or custom campaign HTML) to a specified inbox.
Uses 100% domain-aligned DKIM/SPF headers and rewrites links through nl..
Parameters
| Parameter | Type | Description |
|---|
to_emailrequired | string | Recipient email address where the test should be delivered. |
subject | string | Optional custom subject line for the test. |
custom_html | string | Optional HTML content to test (if omitted, sends an official DNS alignment test card). |
campaign_id | integer | Optional campaign ID whose HTML should be sent as a test. |
Pause or cancel campaign
pause_campaignwrite
Pause an active campaign or cancel a scheduled campaign and refund unused credits to the wallet.
Halts dispatching immediately via the safety circuit breaker.
Parameters
| Parameter | Type | Description |
|---|
campaign_idrequired | integer | Numeric ID of the campaign to pause/cancel. |
Resume or send scheduled campaign now
resume_campaigndestructive
Trigger immediate sending for a scheduled or paused campaign.
Starts dispatching the campaign immediately through Amazon SES.
Parameters
| Parameter | Type | Description |
|---|
campaign_idrequired | integer | Numeric ID of the campaign. |
AI Studio & Store Scraper 7
Generate AI newsletter from store URL
generate_ai_newsletter_from_storewrite
Scrape real products (images, prices, discounts) from the client e-commerce store and generate a complete responsive HTML newsletter.
EXCLUSIVE Mailing Engineer capability: automatically extracts products from Shopify/WooCommerce/Gomag/custom stores, proxies images via nl., and builds a high-converting HTML email.
Parameters
| Parameter | Type | Description |
|---|
store_url | string | URL of the store or collection page to extract products from (e.g. "https://watchclub.ro/collections/seiko"). |
prompt | string | Campaign angle, offer, or copywriting brief (e.g. "Black Friday -25% la ceasuri originale + cod EXTRA10"). |
theme_style | enum | Visual palette: luxury_gold, crimson_sale, royal_navy, or clean_light. |
product_count | integer | Number of products to extract (2 to 8, default 4). |
discount_pct | integer | Optional discount percentage badge (e.g. 20). |
save_as_scheduled_campaign | boolean | If true, also saves the generated HTML as a scheduled draft campaign. |
Suggest high-converting AI subject lines
suggest_ai_subject_linesread
Generate 5 high-open-rate email subject lines and preheaders tailored to an e-commerce offer or niche.
Optimized against Gmail/Yahoo spam filter trigger words.
Parameters
| Parameter | Type | Description |
|---|
topicrequired | string | Campaign topic, product category, or discount offer. |
tone | enum | Tone of voice: urgency, luxury, curiosity, or VIP. |
List Visual Studio master templates
list_email_templatesread
List all pre-built responsive e-commerce email templates available in Mailing Engineer Studio.
Returns template IDs, names, categories, and default subjects.
No parameters required.
Audit email copy & HTML for spam triggers
check_spam_score_and_deliverabilityread
Analyze a subject line and HTML body for spam words, image-to-text ratio, missing unsubscribe links, and external image penalties.
Returns a 0-100 Inbox Placement score and actionable fixes.
Parameters
| Parameter | Type | Description |
|---|
subjectrequired | string | Email subject line to evaluate. |
html | string | HTML content of the email. |
Rewrite & optimize email paragraph
rewrite_email_copy_airead
Transform raw promotional text into persuasive, conversion-optimized Romanian or English e-commerce copy.
Produces headline, body paragraph, and CTA button text variants.
Parameters
| Parameter | Type | Description |
|---|
textrequired | string | Draft text or offer idea to rewrite. |
style | enum | Target style: persuasive, concise, luxury, or urgent. |
Spy competitor store & generate counter-offer HTML newsletter
spy_competitor_store_and_counter_offerwrite
Scan a competitor store URL, extract their prices and promotional offers, then extract products from the client store and automatically generate a counter-offer HTML newsletter.
Compares competitor pricing against your store catalog and generates a ready-to-send responsive HTML campaign that beats the competitor offer.
Parameters
| Parameter | Type | Description |
|---|
competitor_urlrequired | string | URL of the competitor online store or collection page to scan (e.g. "https://concurent.ro/oferte"). |
client_store_url | string | Optional URL of your store or collection page (defaults to your account custom_domain). |
undercut_discount_pct | integer | Extra discount percentage to beat the competitor offer (default: 15). |
coupon_code | string | Optional promotional voucher code for the counter-offer (default: "BEAT15"). |
theme_style | enum | Visual theme: luxury_gold, crimson_sale, royal_navy, or clean_light. |
Translate & localize campaign for EU markets (EUR / PLN / HUF)
translate_campaign_for_eu_marketswrite
Automatically translate and adapt an e-commerce newsletter into major EU languages (EN, DE, FR, IT, ES, PL, HU) and convert displayed prices from RON into EUR, PLN, or HUF.
Localizes subject lines, CTA buttons, trust badges, and unsubscribe footers while converting product prices from RON to EUR, PLN, or HUF at live reference rates.
Parameters
| Parameter | Type | Description |
|---|
target_languagerequired | enum | Target EU language code: EN, DE, FR, IT, ES, PL, or HU. |
target_currency | enum | Target currency for price conversion: EUR, PLN, or HUF. |
campaign_id | integer | Optional campaign ID to translate (if omitted, uses custom_html or the last generated AI newsletter). |
subject | string | Optional email subject line to translate. |
custom_html | string | Optional HTML newsletter body to translate and convert prices. |
Domain, DNS & Deliverability 9
Yahoo & Gmail Complaint Doctor (<0.1% AWS SES Shield)
yahoo_gmail_complaint_doctorread
Analyze client campaigns and audience structure (@yahoo.com / @gmail.com share), verify visible unsubscribe links in both header and footer, and generate an automated plan to keep complaints below the 0.1% AWS SES threshold.
Protects Amazon SES reputation by auditing Yahoo/Gmail FBL complaint risk, checking dual header+footer 1-click unsubscribe placement, and providing step-by-step remediation.
Parameters
| Parameter | Type | Description |
|---|
campaign_id | integer | Optional campaign ID to inspect for complaint rate and HTML header/footer unsubscribe visibility. |
html | string | Optional HTML template to verify for visible unsubscribe links in both header and footer. |
List sending domains
list_domainsread
List the sending domain(s), default sender addresses, and tracking subdomain configured on the account.
Returns custom_domain, default_from_email, and verification status.
No parameters required.
Get sending domain DNS & SES status
get_sending_domainread
Inspect all 9 DNS records (3x DKIM 2048-bit, nl proxy subdomain, SPF, DMARC, bounce MX/TXT, and BIMI logo) in real time.
Queries Cloudflare DoH and AWS SES eu-central-1 to verify exact live DNS values.
Parameters
| Parameter | Type | Description |
|---|
domain | string | Optional domain name to inspect (defaults to account custom_domain). |
Provision & validate sending domain in AWS SES
validate_domainwrite
Provision a domain in Amazon SES (2048-bit Easy DKIM + bounce MAIL FROM) and validate its live DNS records.
Automatically unlocks the 10k Bonus Shield step once core records are verified.
Parameters
| Parameter | Type | Description |
|---|
domain | string | Domain name to provision and verify (e.g. "magazinultau.ro"). |
Audit any e-commerce domain (SPF, DKIM, DMARC, ESP, Ads)
audit_store_domain_liveread
Run a deep live technical & deliverability audit on any e-commerce domain.
Detects current ESP (Klaviyo, theMarketer, Mailchimp, Newsman), SPF/DMARC flaws, MX servers, and inbox placement risk.
Parameters
| Parameter | Type | Description |
|---|
domainrequired | string | Any store domain to audit (e.g. "exemplu.ro"). |
Auto-configure DNS records in Cloudflare (1-Click)
auto_configure_cloudflare_dnswrite
Automatically create and align all DKIM, SPF, DMARC, bounce, BIMI, and nl proxy records in Cloudflare via API token.
Sets DKIM CNAMEs to DNS-Only (grey cloud) and nl. to Proxied (orange cloud) automatically.
Parameters
| Parameter | Type | Description |
|---|
domainrequired | string | Domain name managed in Cloudflare. |
cloudflare_tokenrequired | string | Cloudflare API Token with Zone.DNS Edit permission. |
Get wallet balance, credits & pricing
get_costsread
Check available email credits, RON wallet balance, 10k Bonus Shield status, and recent billing transactions.
Shows total_credits, used_credits, available_credits, and bonus unlock requirements.
No parameters required.
Get integration & SES deliverability health
get_integration_healthread
Check overall account health: Amazon SES tier status, DNS verification, list hygiene, and Shopify connection.
Returns a complete diagnostic checklist for the client account.
No parameters required.
Verify MCP connection & authenticated identity
verify_connectionread
Verify that Claude / ChatGPT is authenticated with Mailing Engineer MCP and display the connected account profile.
Returns account ID, company name, custom domain, and active permissions.
No parameters required.
E-commerce & Shopify 10
List or extract store products
list_productsread
List products from the connected Shopify store or extract live products from the client store URL.
Returns product titles, prices, compare-at prices, discounts, images, and URLs.
Parameters
| Parameter | Type | Description |
|---|
store_url | string | Optional store or collection URL to fetch products from. |
limit | integer | Maximum products to return (default 8). |
Get product details
get_product_detailsread
Inspect detailed pricing, discount percentage, image proxy URL, and metadata for a specific product.
Pass product URL or search keyword.
Parameters
| Parameter | Type | Description |
|---|
product_urlrequired | string | URL or handle of the product. |
Get store product collections & categories
get_product_optionsread
Return available product collections and brand metadata from the client e-commerce store.
Helps choose which collection to feature in an AI campaign.
Parameters
| Parameter | Type | Description |
|---|
store_url | string | Optional store URL. |
List e-commerce orders & billing transactions
list_ordersread
List synced e-commerce orders and account transactions.
Returns recent order activity and revenue metrics.
Parameters
| Parameter | Type | Description |
|---|
limit | integer | Max records to return (default 15). |
Get e-commerce order & campaign conversion trend
get_order_trendread
Analyze click-to-order conversion trends and attributed campaign performance over time.
Shows daily/weekly engagement and conversion velocity.
Parameters
| Parameter | Type | Description |
|---|
days | integer | Lookback period in days (default 30). |
List promotional coupon codes
list_couponsread
List active discount codes used across email campaigns and automations.
Returns coupon codes, discount percentages, and usage notes.
No parameters required.
Create or save promotional coupon for campaigns
save_couponwrite
Register a promotional discount code (e.g. EXTRA10, VIP20) to embed in AI newsletters and abandoned cart flows.
Makes the coupon available for 1-click insertion in campaigns.
Parameters
| Parameter | Type | Description |
|---|
coderequired | string | Coupon code (e.g. "BLACKFRIDAY20"). |
discount_pct | integer | Discount percentage (e.g. 20). |
description | string | Terms or description of the coupon. |
Get e-commerce revenue & ROI attribution stats
get_ecommerce_statsread
Calculate attributed e-commerce revenue, ROI multiple, open/click conversion funnel, and cost per email.
Provides executive KPIs for the store.
No parameters required.
Get real-time email engagement & active clickers
get_realtime_visitorsread
Check real-time email opens, active link clickers, and live delivery throughput in the last 60 minutes.
Monitors live customer activity from active campaigns.
No parameters required.
Check Shopify store integration status
sync_shopify_customersread
Inspect connected Shopify store status, synced customer count, and webhook health.
Queries the shopify_stores table for the client domain.
No parameters required.
Reports & Analytics 4
Get executive dashboard report
get_reportread
Get the complete account overview: total contacts, total campaigns, sent volume, open rate, click rate, and deliverability score.
Primary tool for answering "How is my account performing?".
No parameters required.
Get subscriber acquisition history
get_audience_historyread
Get historical growth of contacts across segments over time.
Groups subscriber joins by date and segment.
No parameters required.
List campaign & deliverability analytics reports
list_analytics_reportsread
List all available performance, bounce/complaint safety, and ROI reports for the account.
Summarizes every sent campaign with its KPIs.
No parameters required.
Get detailed comparative analytics report
get_analytics_reportread
Compare top-performing campaigns by open rate, click rate, and segment responsiveness.
Identifies best sending times, best subject lines, and top segments.
No parameters required.
Transactional & Wallet 4
Send transactional or 1-to-1 aligned email
send_transactional_emaildestructive
Send an immediate 1-to-1 transactional or notification email through Amazon SES using the client verified domain.
Ideal for order confirmations, VIP notifications, or custom single-recipient messages.
Parameters
| Parameter | Type | Description |
|---|
to_emailrequired | string | Recipient email address. |
subjectrequired | string | Subject line of the email. |
html_bodyrequired | string | HTML content of the transactional message. |
Get available email & transactional credits
get_transactional_creditsread
Return exact available credits, used credits, and RON balance from the client wallet.
Fast check before dispatching high-volume sends.
No parameters required.
List recent wallet & sending transactions
list_transactional_messagesread
List credit top-ups, bonus grants, and recent sending activity.
Reads from saas_transactions for the authenticated client.
No parameters required.
Update default sender name, email & reply-to
update_sender_profilewrite
Update the company name, default From name, default From email, or Reply-To address on the account.
Saves settings in saas_clients and provisions the domain if changed.
Parameters
| Parameter | Type | Description |
|---|
company_name | string | Company or brand name. |
default_from_name | string | Default sender display name (e.g. "Echipa WatchClub"). |
default_from_email | string | Default sender email on verified domain. |
default_reply_to | string | Default reply-to email address. |