Sequenzy Mcp

For a new sending domain, calladd_sending_domain, publish the DNS records in the returnedwebsite.dnsRecords, wait for DNS propagation, and then callverify_sending_domain. Publish every returned record instead of assuming a fixed provider or record count: unified domains include required DMARC, while legacy domains can return Amazon SES MAIL FROM and inbound-reply records. If verification is attempted before creation, the error points back toadd_sending_domainwith the requested domain.

For Shopify, callget_integration_pixelbefore relying on product views, cart activity, or browse-abandonment triggers. The result is read live from Shopify because merchants can remove the pixel independently. Ifpixel.healthyis false,dependentEventsnames the triggers that cannot arrive; callactivate_integration_pixelto install or repoint the pixel. Activation is idempotent, and events begin on the next storefront visit rather than being backfilled.

New companies start with no sync rules. The inherited preset remains available for SaaS/ecommerce companies by passingnulltoupdate_sync_rules; services and consulting companies should normally keep[]or define explicit rules.

Uselist_sender_profilesto find the profile ID, then callupdate_sender_profileto change only its display name. Passtype: "reply"for a reply-to profile; sender is the default. The address, sending domain, and account-wide default From/Reply-To selections remain unchanged. Renaming requires thecompanies:managescope.

After a product delivery file is attached, matching purchase events includedownload.urlanddownload.name, so purchase-triggered emails can use merge tags like{{event.download.url}}.

For Stripe products,list_productsreturns every active price as a variant, with the Stripe price ID invariantId. Use that ID to target an exact price in a purchase sequence even when it is not the product's default price.

The tool accepts PNG, JPEG, GIF, and WebP images up to 5MB. Local stdio clients can passfilePath. Hosted/remote clients that can access attachment bytes can passimageBase64withfilename. ProvidealtTextfor accessibility, then usedisplayWidthPercent,cropHeight,objectFit(coverorcontain), andalignto standardize screenshot presentation. The returnedimageBlockcan be copied directly into the block array accepted by campaign, sequence, template, and transactional-email tools.

Authenticated image bytes are always uploaded to the origin configured bySEQUENZY_API_URL, even if a reverse proxy returns an equivalent upload URL under another host. API credentials are never forwarded to that alternate origin.

{ "filePath": "/Users/me/Desktop/product-results.png", "altText": "Product results dashboard", "displayWidthPercent": 100, "cropHeight": 320, "objectFit": "cover", "align": "center" }

{ "emails": ["ada@example.com", "grace@example.com"], "duplicateStrategy": "skip", "enrollInSequences": false, "optInMode": "default" }

Send at most 500 emails per request. Standard API rate limits still apply: 100 requests per minute per API key and 20 requests per second burst. For CSV-driven CLI imports, accepted email headers includeemail,e-mail,email address, andmail; if no recognized header exists, the CLI reads the first column.

Segment filters support attributes, events, saved segment membership, engagement events, Stripe product purchase rules, and commerce product purchase rules. UsefilterJoinOperator: "or"for match-any segments, or pass a v2rootgroup for nested logic.

Each segment filter field validates its own operators:

- status,segment:is,is_not
- tag:contains,not_contains,is_empty,is_not_empty
- email:contains,not_contains
- emailProvider,list:is,is_not,is_empty,is_not_empty
- firstName,lastName:contains,not_contains,is_empty,is_not_empty
- added:less_than,more_than
- attribute:is,is_not,is_empty,is_not_empty,gte,lte,gt,lt,contains,not_contains
- event, email engagement fields:is,is_not,at_least,less_than_count
- emailBounced: also supportsis_temporary_bounce,is_permanent_bounce
- stripeProduct:is,is_not,at_least,less_than_count
- stripeCurrentProduct,stripeTrialProduct:is,is_not,gte,lte,gt,lt
- commerceProduct:is,is_not,at_least,less_than_count

{ "field": "stripeProduct", "operator": "is", "value": "prod_pro" } { "field": "stripeProduct", "operator": "is_not", "value": "prod_pro" } { "field": "stripeProduct", "operator": "at_least", "value": "prod_pro:3" } { "field": "stripeProduct", "operator": "less_than_count", "value": "prod_pro:3" }

Commerce product filters match products purchased through commerce orders. Values can beprovider:productIdfor provider-scoped IDs (shopify,woocommerce, orapi), a bare product ID to match any provider, orprovider:productId:countfor threshold operators:

{ "field": "commerceProduct", "operator": "is", "value": "api:starter-kit" } { "field": "commerceProduct", "operator": "at_least", "value": "shopify:42:2" }

Engagement fields such asemailSent,emailDelivered,emailOpened,emailClicked,emailBounced, andemailComplainedaccept rolling windows like7d,30d,90d,180d, orall. Withat_leastandless_than_count, usecount:timeRange, such as10:30dor10:all. Presence operators can instead use a campaign scope likecampaign:cmp_123; campaign scopes cannot be combined with count operators.

Requires the Meta Ads integration to be connected in the Sequenzy dashboard (Settings -> Integrations).create_audience_syncaccepts an existing segment (segmentId) or a ready-made template (predefinedSegmentId, for examplezero-ltv,no-purchase-1y,recent-buyers,high-spenders-ecom,non-buyers,engaged) - the template segment is created automatically on first use, and the first upload runs immediately.

list_templatesreturns 50 email bodies newest first by default and accepts alimitup to 100. Advanceoffsetbypagination.countwhilepagination.hasMoreis true;pagination.totalreports the full matching count, including campaign and transactional-email bodies.

For net-new content requested in natural language, passpromptso Sequenzy generates branded native blocks server-side. Useblocksonly for finished caller-supplied Sequenzy content, and usehtmlonly when preserving supplied or explicitly requested markup.prompt,blocks, andhtmlare mutually exclusive;styleandtoneare valid only withprompt.

Useset_template_localizationwhen translated copy comes from your own localization workflow. It requires an enabled non-primarylocale, a localizedsubject, and exactly one ofhtmlorblocks. Usesync_template_localizationsto ask Sequenzy to translate selected locales; omitlocalesto sync every enabled non-primary locale. Explicit sync works even when automatic on-save localization is disabled.

Useget_ab_testto copy the effectivesettingsobject and discover variant IDs before editing. Campaign settings usetestPercentage,testDurationMinutes, andwinnerCriteria; sequence settings usetestType,winnerThreshold, andwinnerCriteria. The legacy sequence valuestestPercentage: 100andtestDurationMinutes: 0are compatibility sentinels, not runtime settings.select_ab_test_winnerapplies only to a campaign test that is currently testing and immediately queues the winning variant for the remaining audience.update_ab_testchanges the appropriate settings model and requiresconfirmLiveChange: truewhen sequence settings affect an active or already-used test. Variant updates accept eitherhtmlorblocks, not both.

create_ab_testaccepts exactly one ofcampaignIdorautomationNodeId; the latter requires one to four extra variants and converts a sequence email node intoaction_ab_test. An explicit sequencewinnerCriteriaoverrides thetestTypedefault, so content variants can still be judged by opens. PassconfirmLiveChange: truewhen converting a node in an active sequence. Together with control A, an A/B test supports at most five variants. Sequence variants receive independent email templates and can be edited, added, or removed while the test is a draft; when the parent sequence is active,update_ab_test_variant,add_ab_test_variant, anddelete_ab_test_variantalso requireconfirmLiveChange: truebecause they immediately change the live rotation.

Prompt-created campaigns are generated and persisted in one API request and remain drafts. UsetemplateId,blocks, orhtmlonly when copying or preserving existing content rather than asking the agent to author it. Omit all content fields to create an empty draft for later editing.

To deliver at the same wall-clock time in every recipient's own timezone, callschedule_campaignwithsendInRecipientTimezone: trueand an IANAscheduledTimezonethat identifies the wall clock represented byscheduledAt. Contacts without a stored timezone receive the campaign at thescheduledAtinstant. This mode cannot be combined with recurring or spread delivery.

For campaign- and sequence-level identities,fromEmailplusfromNameselects the sender identity with that display name on the mailbox, creating it when needed without renaming other same-address identities. A Reply-To address instead has one company-wide saved name: whenreplyToNamediffers from that name, the saved name is kept and the successful response includes recovery guidance inwarnings.

Agents should pass a caller-ownedidempotencyKeytosend_emailbefore the first attempt and reuse it for every retry of that same logical email. Sequenzy returns the originalemailSendIdfor 14 days instead of creating another delivery. Reusing the key with different send arguments is rejected, so do not generate a fresh key inside a retry loop.

Core block shapes are{ "type": "heading", "content": "Title", "level": 1 },{ "type": "text", "content": "<p>Copy</p>" },{ "type": "button", "text": "Book a call", "url": "https://example.com", "variant": "primary" }, and{ "type": "image", "src": "https://...", "alt": "Description", "width": 100, "widthType": "percent" }. Buttons also acceptcontentas an alias fortextand default to theprimaryvariant. ImagewidthTypeacceptspercentorpx.

Rawhtmlis stored as one opaque block. It preserves supplied markup but does not add a company logo, native branded sections, or theme-driven block design. Usepromptfor a new branded draft orblocksfor editor-native design; MCP authoring results include a warning when raw HTML is used.

Useupdate_companywithfromEmailand/orreplyToto set account-wide defaults.fromEmailmust use a configured, verified sending domain;replyTomay be any valid mailbox.create_campaign,update_campaign,create_sequence, andupdate_sequenceaccept the same direct-address fields for resource-specific overrides and create the backing profile when needed. SendfromNameorreplyToNamealone to rename the existing default profile without changing its address. When an address has multiple display names, usesenderProfileIdorreplyProfileIdfromlist_sender_profilesto select the exact profile to make default and rename.

update_companyalso manages the company's default email theme throughemailTheme(presetId,colors,typography,layout). Theme updates are partial - omitted fields keep their current value (or the preset default) and numeric values are clamped to supported ranges. PassemailTheme: nullto reset the company to the platform default theme. Layout settings can control the sharedbaseRadiusand a separatebuttonRadius.

Reply tracking is available on the same company tools. UsereplyTrackingEnabled,replyTrackingDomainMode(sequenzyorcustom), andforwardReplieswithupdate_company. Company reads also return the current read-onlyreplyRetentionDaysvalue.

{ "type": "poll", "variant": "options", "question": "What did you think of this email?", "options": [ { "label": "Loved it", "value": "loved" }, { "label": "Not for me", "value": "not_for_me" } ], "attributeKey": "email_feedback" }