{"report":{"v":1,"package":"@sequenzy/mcp","version":"0.0.255","ranAt":"2026-11-16T11:33:18.947Z","install":{"ok":true,"integrity":"sha512-jZTBK+9lqd927m/mnWBDEg4YqCTM47ZbziV+0Q/leJiBe1HHQWuwht8oGpJ0rImUpGJe9RwcQCFfWV936pv/JA==","deps":3,"scripts":[],"bins":["sequenzy-mcp"],"license":"MIT","repository":"git+https://github.com/Sequenzy/mcp.git","bin":"sequenzy-mcp"},"start":{"ok":true,"ms":223,"serverName":"sequenzy","serverVersion":"0.0.255","protocol":"2025-06-18","stderr":"Sequenzy MCP error: Missing MCP API key\nDescription: The MCP server started without a Sequenzy API key, so it cannot authenticate any tool or resource request.\nHow to fix: If you do not have a Sequenzy account yet, create one for free at https://sequenzy.com/sign-up?utm_source=mcp&utm_medium=mcp-no-key. Then run `npx @sequenzy/setup` to connect this MCP client automatically, or create a key in the Sequenzy dashboard under Settings > API Keys, add it as `SEQUENZY_API_KEY` to the MCP server environment, and restart the MCP client.\nDocs: https://docs.sequenzy.com/concepts/mcp\nDetails: SEQUENZY_API_KEY environment variable is required\nSequenzy MCP server running on stdio\n"},"tools":[{"name":"open_sequenzy","description":"Open the Sequenzy workspace view: a company's sequences and recent campaigns, each opening as a flow diagram or rendered email in MCP Apps clients. Read-only. Without companyId it uses the selected company and offers a switcher. The open view has its own tools (get_view_state, reload_view and others); call reload_view after editing what the user is looking at. Other clients receive the lists as data.","params":["companyId"]},{"name":"preview_sequence","description":"Show an interactive visual preview of a saved sequence in clients that support MCP Apps. Displays its real nodes, connections, delays and branches; click an email step to preview its saved rendered email, including available A/B variants, at desktop or mobile width. Read-only: does not activate, enroll or send. Requires an explicit companyId to keep step previews pinned to the same company. Other clients receive the sequence data; use render_email for individual step HTML.","params":["companyId","sequenceId"]},{"name":"open_image_upload","description":"Open a compact image picker as a supporting workflow for email creation. Opening does not upload anything; the user chooses an image and explicitly submits it through upload_image_asset. Requires an explicit companyId. Clients without MCP Apps can use upload_image_asset directly.","params":["companyId"]},{"name":"monitor_subscriber_import","description":"Show a compact progress card for an existing subscriber import. Reads immediately, then polls get_subscriber_import every five seconds for up to five minutes while running. Refresh resumes monitoring. Requires explicit companyId and importId. Does not start or retry an import. Other clients receive the import data.","params":["companyId","importId"]},{"name":"get_account","description":"Get your own Sequenzy account information (not your customers' B2B accounts; use list_accounts for those) including available companies, the current API key's permission scopes, and the API Keys management URL. Useful after a missing-scope error to inspect access and find the replacement-key settings. When the key has access to multiple companies, other tools need a target company: either one selected with select_company or a companyId passed in each call.\n\nThe response shows 'companies' (all available) and 'selectedCompanyId' (currently active). Subsequent operations use the selected company unless a companyId override is passed.","params":[]},{"name":"select_company","description":"Select which company to operate on (for user-scoped API keys with access to multiple companies). Use get_account to see available companies. After selecting, all subsequent operations will use this company unless you pass a companyId override.","params":["companyId"]},{"name":"get_app_urls","description":"Generate Sequenzy dashboard URLs for known resource IDs. Use this when the user asks where to review or edit a generated sequence, campaign, template, company settings, or subscription. The response always includes the canonical owner-facing subscription URL when a company is resolved. For compatibility, settingsTab billing or subscription also resolves to that Account page rather than a nonexistent Settings tab. If companyId is omitted, the selected/current company is used when available.","params":["companyId","campaignId","landingPageId","sequenceId","templateId","emailId","transactionalId","emailSendId","domainId","status","settingsTab"]},{"name":"create_company","description":"Create a company with a website domain, or set noWebsite and provide a name. Optionally provide a business description and create a four-email welcome sequence. Requires a personal account key (seq_user_...); company-scoped keys cannot create another workspace. Website creation queues brand processing and this tool polls for completion.","params":["name","domain","noWebsite","description","withWelcomeSequence","websiteType"]},{"name":"get_company","description":"Read one company's settings and status: processing status, product info, brand colors, AI writing context, emailStylePreference (visual, plain, or null when not chosen), websiteType (saas, content, ecommerce, offline, mobile_app, other or null) with websiteTypeSource (user when chosen, detected from the website), header and footer (emailPreset), footerStyle for new AI-designed emails (auto, classic, mono, band or editorial), footerTheme (the auto-added footer's resolved colors and copy; change it with update_company footerTheme), reply-tracking settings, effective email localization settings, and darkModeLogoStatus (pending, outlined, not_needed or custom) with darkModeLogoUrl, the logo dark-mode inboxes show (set your own with update_company darkModeLogoUrl). The read-only emailBranding says whether \"Sent with Sequenzy\" is visible, whether the owner subscription removes it, why, the tier/status, the upgrade or renewal action, and subscriptionUrl. Branding is added at send time, so a paid entitlement removes it from existing live sequences without editing their emails. defaultSubscriberListIds are the lists new contacts join when nothing targets them: JSON null means every current and future list, not an empty selection; [] means no list; an array means exactly those lists. Change it with update_company. Read it before connecting an integration without per-integration list targeting (Dodo Payments, PostHog, Polar, Paddle, and similar): its live contacts and payment-provider backfills land there. PostHog history imports are different: their contacts get no list memberships. Send Time Optimization is not a company or sequence setting. It is campaign-only: audit with list_campaigns or get_campaign (sendTimeOptimization, sendTimeWindowHours, default 12h window). Change a draft with update_campaign, or apply it when calling schedule_campaign. Sequences use sendingWindow (allowed local hours/days), which is a shared gate, not per-subscriber predicted send times.","params":["companyId"]},{"name":"update_company","description":"Edit company product info, brand context, the default email theme, reply-tracking settings, account-wide sending identity defaults, and defaultSubscriberListIds - which lists new untargeted contacts join. That field is the write path for Dodo Payments and live PostHog events, plus every other integration without per-integration targeting: null = every current and future list (not 'no lists'), [] = no list, [ids] = exactly those lists. PostHog history imports always create contacts without list memberships. fromEmail must use a verified sending domain; replyTo may be any valid mailbox. Missing sender/reply profiles are created automatically. Send fromName/replyToName on their own to rename the display name of the existing default profile without changing its address, or pair them with senderProfileId/replyProfileId (from list_sender_profiles) to rename a specific profile. Provide at least one editable field. Profile, branding, and AI-context fields need the company_profile:manage scope; the sending identity, reply-tracking, and defaultSubscriberListIds fields additionally need companies:manage.","params":["companyId","renameMatchingFooters","previousCompanyName","name","description","logoUrl","darkModeLogoUrl","founderName","primaryColor","brandColors","valueProps","testimonials","toneVoice","companyContext","emailDesignPrompt","emailLengthPreference","websiteType","emailStylePreference","emailPreset","footerStyle","footerTheme","socialLinks","privacyPolicyUrl","termsUrl","address","language","pricing","fontFamily","emailTheme","emailDirection","senderProfileId","fromEmail","fromName","replyProfileId","replyTo","replyToName","replyTrackingEnabled","replyTrackingDomainMode","forwardReplies","defaultSubscriberListIds"]},{"name":"get_shopify_automation_settings","description":"Get the connected Shopify store's automation settings: browse abandonment (emails shoppers who viewed a product but didn't buy), cart abandonment (fires ecommerce.cart_abandoned with the full cart after the cart sits inactive), and price drop alerts (emails recent viewers when a product's price falls). Returns the effective values with platform defaults applied.","params":["companyId"]},{"name":"update_shopify_automation_settings","description":"Update the connected Shopify store's browse-abandonment, cart-abandonment, and/or price-drop automation settings. Partial update: omitted sections are untouched, omitted fields within a section keep their current value, and passing null for a section resets it to the platform defaults (browse abandonment: on, 2h delay, 24h cooldown; cart abandonment: on, 1h inactivity, 24h cooldown; price drop: on, 5% minimum drop, 30-day viewer lookback, 7-day cooldown).","params":["companyId","browseAbandonment","cartAbandonment","priceDrop"]},{"name":"get_sync_rules","description":"Get the company's sync rules: the automatic tag changes applied when events fire (e.g. order placed -> add a tag). New companies start with the payment and ecommerce lifecycle rules; some older ones have none. Returns the effective rules plus isDefault, which is true when the company has explicitly opted into the inherited SaaS/ecommerce platform preset.","params":["companyId"]},{"name":"update_sync_rules","description":"Replace the company's sync rules. Pass the FULL rule set (fetch with get_sync_rules first and edit it - this is not a partial update), [] to disable rules, or null to opt into the inherited SaaS/ecommerce platform preset. Each rule: { triggerEvent, actions: { addTags, removeTags }, conditions? }. Conditions support requiresTags, requiresNotTags, and purchasedProduct ({ tags?, collectionIds?, productTypes?, vendors? }) which matches products on commerce events - e.g. tag buyers of products carrying a given product tag.","params":["companyId","syncRules"]},{"name":"get_email_design_system","description":"Get the company's email design system: the visual identity every AI-generated email (campaigns and sequence steps) renders inside - design code (kicker style, title alignment, button shape, divider style, density, sanctioned opener treatments) plus the composition spine (hero-led | editorial | product-spec) that anchors email structure. The identity is stored as the company's emailDesignPrompt direction text; this tool returns the structured tokens parsed from that text (falling back to brand derivation per unstated token), the raw directionText, and isDefault (true while the identity is still purely derived from brand context).","params":["companyId"]},{"name":"update_email_design_system","description":"Adjust the company's email design system (partial update - only pass the fields to change). Affects every future AI-generated email and sequence enrichment. designCode tokens: kickerStyle (chip | letterspaced | none), titleAlignment (left | center), buttonShape (rounded | pill), dividerStyle (line | space), density (airy | compact), openerTreatments (subset of hero-image, hero-color, header-hero, editorial-masthead, title-led). compositionSpine: hero-led | editorial | product-spec. The adjustment is written into the company's emailDesignPrompt direction text (the single source of truth): the new identity's sentences are prepended and any custom prose the text carried is preserved below them. Pass reset: true to clear the direction text and return to brand-derived defaults. Free-form prose edits belong on update_company's emailDesignPrompt instead.","params":["companyId","designCode","compositionSpine","reset"]},{"name":"get_design_md","description":"Get the company's design.md: its email design brief as one Markdown document. YAML frontmatter holds the exact values Sequenzy applies when rendering AI-generated emails (logo, colors, fonts.body/heading, buttons.style/radius, cornerRadius, layout tokens); prose sections hold the Voice and the Design direction the AI writer follows, plus a read-only Reference email naming the saved AI style. Values shown are the ones emails actually get. Returns markdown, version (pass it to update_design_md as expectedVersion), and the parsed designSystem. Read this before writing or redesigning emails for the company.","params":["companyId"]},{"name":"update_design_md","description":"Save an edited design.md (full document from get_design_md). Only values you changed are written: a frontmatter value left as returned is not written and keeps its current behavior, a changed radius or heading font is pinned, and a changed layout token is written into the design direction ahead of its prose. Removing a key or section leaves it unchanged; an empty Voice or Design direction section clears it (an empty direction returns to brand-derived defaults). The Reference email section is read-only. Invalid values fail with line-numbered issues; unknown keys are ignored with warnings. Pass dryRun: true to preview changes and warnings without saving. Pass expectedVersion from get_design_md; on a 409 conflict, read again and reapply your edits.","params":["companyId","markdown","expectedVersion","dryRun"]},{"name":"create_api_key","description":"Create a new API key for a company, typically when setting up a Sequenzy integration in a project. The CLI reads the key from the SEQUENZY_API_KEY environment variable; SDK clients accept it through the apiKey option, such as apiKey: process.env.SEQUENZY_API_KEY. The key is returned only once at creation time and cannot be retrieved later.","params":["companyId","name","preset","scopes"]},{"name":"request_api_key_handoff","description":"Prepare an owner-confirmed handoff link for creating or rotating an API key. Intended for when key management fails because the active key is missing api_keys:manage; that scope fails closed on purpose, and this handoff is the supported path. Returns a URL that opens the dashboard's create-key form with the requested name and permissions already filled in. This tool creates nothing and never returns a key: the workspace owner opens the URL, reviews the form, clicks Create, and copies the new key from the browser. To rotate, pass replaceApiKeyId (or the literal string 'current' for the key you are authenticated with) and the dashboard offers to revoke the predecessor after the replacement is created. Requires only account:read.","params":["companyId","name","preset","scopes","replaceApiKeyId"]},{"name":"list_api_keys","description":"List company-scoped API keys as non-secret metadata. Returns IDs, names, prefixes, permissions, usage timestamps, and whether each key is the active credential. It never returns a plain key or stored key hash. Use this before revoke_api_key or delete_api_key to identify the exact unused key.","params":["companyId"]},{"name":"update_api_key","description":"Rename a company-scoped API key or replace its permissions in place, without issuing a new key. Use this when a call fails with a missing-scope error: the key value stays the same, so no client has to be re-wired, and added permissions apply on the next retry. Removed permissions may remain usable for up to five minutes while API caches expire. preset and scopes REPLACE the current selection rather than merging into it - call list_api_keys first and pass the full set you want. Returns non-secret metadata only.","params":["companyId","apiKeyId","name","preset","scopes"]},{"name":"revoke_api_key","description":"Permanently revoke a company-scoped API key by ID. The response contains non-secret metadata only. Call list_api_keys first and compare the ID, name, prefix, and isCurrent flag because revoking a key cannot be undone and may invalidate the active credential.","params":["companyId","apiKeyId"]},{"name":"delete_api_key","description":"Compatibility alias for revoke_api_key. Permanently delete a company-scoped API key by ID and return non-secret metadata only. Call list_api_keys first to verify the exact target.","params":["companyId","apiKeyId"]},{"name":"list_websites","description":"List configured sending domains with separate DNS verification, sending readiness, and SPF, DKIM, and MAIL FROM status.","params":["companyId","label"]},{"name":"add_sending_domain","description":"Add and configure a sending domain. A domain belongs to exactly one company and cannot be moved or removed through the API, CLI or MCP afterwards, so confirm the target company with the user before adding. Before calling verify_sending_domain, publish the DKIM record from website.dnsRecords (when dnsRecords.platformDnsRecords is present, publish those CNAMEs instead: active and spare DKIM selectors plus a recommended bounces CNAME; only required entries block verification), the bounce records described by website.bounceRecords (its cnameRecord when style is cname, otherwise spf.record and mailFrom.mxRecord; never both at the same name), and DMARC when present. Tracked links use the company tracking domain shared by every sending domain; the first domain creates it under itself (links.<domain>) and returns its CNAME as dnsRecords.trackingRecord. It is optional and never blocks verification or sending: until it verifies, links use the shared Sequenzy domain. Manage it with set_tracking_domain.","params":["companyId","domain","mailFromPrefix","trackingPrefix"]},{"name":"add_website","description":"Compatibility alias for add_sending_domain. Adds a sending domain and returns the DNS records required for setup. The domain cannot be moved to another company afterwards; confirm the target company first.","params":["companyId","domain","mailFromPrefix","trackingPrefix"]},{"name":"check_website","description":"Read a sending domain's separate DNS verification and sending readiness. Use verify_sending_domain to run a fresh check. dnsUpgrade.status: available (see upgrade_sending_domain_dns), in_progress (records to add), completed (oldRecords to delete) or unavailable. Receiving mail (inbox addresses and replies) is set up on receiving domains instead: see list_receiving_domains.","params":["companyId","domain"]},{"name":"verify_sending_domain","description":"Run a fresh DNS check for a configured sending domain and return DNS verification separately from sending readiness. When readyToSend is false, read readiness.reason. Receiving mail (inbox addresses and replies) is checked on receiving domains instead: see verify_receiving_domain.","params":["companyId","domain"]},{"name":"upgrade_sending_domain_dns","description":"Recommended, optional one-time upgrade of a verified sending domain to the current per-domain CNAME DNS records, for better deliverability and security, without removing it; it keeps sending on current records and sending is normally not interrupted at the switch. Once started it runs to the switch. Needs website.dnsUpgrade.status available; an older SES-only domain also needs a DMARC record (400 otherwise). Publish the returned dnsUpgrade.records CNAMEs next to the current records, removing nothing; the domain switches by itself about an hour after the required ones are public (verify_sending_domain checks now, no skip). Removing dnsUpgrade.oldRecords (listed beforehand as replacedRecords) after deleteOldRecordsAfter (8 days) is optional; each is marked removed once gone from public DNS.","params":["companyId","domain","mailFromPrefix"]},{"name":"configure_sending_domain","description":"Deprecated: tracking is company-wide; prefer set_tracking_domain. Sets <trackingPrefix>.<domain> as the company tracking domain when the company has none. Repeating the company's current tracking hostname is a no-op; a different one changes nothing and the response message says so (use set_tracking_domain to change it). Publish the returned website.tracking.cnameRecord; sending never waits for it.","params":["companyId","domain","trackingPrefix"]},{"name":"list_integrations","description":"List connected integrations (Stripe, Shopify, Supabase, Clerk, WooCommerce, ad platforms, and so on) with connection status, sync state, last sync time, and last sync error. Read-only: credentials, access tokens, and webhook secrets are never returned. Use this to audit which external systems feed this account and whether their syncs are healthy.","params":["companyId","includeInactive"]},{"name":"list_sender_profiles","description":"List sender (From) profiles and reply-to profiles for the company, including which are the account defaults and whether each sender address has verified DNS plus a ready home transport. Use this to audit sending identity before scheduling, or to pick a valid senderProfileId/replyProfileId for create_campaign or update_campaign.","params":["companyId"]},{"name":"update_sender_profile","description":"Rename one sender (From) or reply-to profile in place, without changing which profile is the account default. Use this to standardize a display name across the several identities a mailbox may carry, e.g. renaming 'Viraj from SnapCount' to 'SnapCount'. Get IDs from list_sender_profiles. Only the display name changes: the address, its sending domain, and the account-wide default From/Reply-To selection are untouched, and existing campaigns and sequences pinned to this profile pick up the new name. To change which profile is the default instead, use update_company with senderProfileId/replyProfileId. A company cannot have two sender identities with the same name on one address, so a colliding rename is rejected and reports the ID already using that name. Requires the companies:manage scope.","params":["profileId","name","type","companyId"]},{"name":"delete_sender_profile","description":"Permanently delete one sender (From) profile. This cannot be undone. Deletion is refused when this is the company's last sender or when a live campaign, active sequence (including a step-level override), or transactional email still uses it. Draft and rejected campaigns plus the account default are reassigned to the best remaining sender when needed; read fallbackSenderProfileId in the result and review that identity before sending. Reply-to profiles are not supported by this tool. Get the profile ID from list_sender_profiles. Requires the companies:manage scope.","params":["profileId","companyId"]},{"name":"get_sending_status","description":"Check whether company-level email sending is active, paused, or suspended, and what it takes to restore it. Relevant whenever a send, test send, or sequence step fails for a reason that is not a validation error, and whenever the account reports a bounce or complaint rate problem.\n\nReturns the pause reason and reason kind, when it was paused, the automated sender-health review state, whether the one-click resume is currently available (and if not, which gate is blocking it), the enforcement counts and thresholds for permanent bounces, temporary bounces, and complaints, and ordered remediation steps.\n\nThere is no rolling window and no expiry. Enforcement uses all-time totals counted from a reset watermark, so a paused rate does NOT decay over time. Waiting does not restore sending. The rate only changes as real (non-test) sends accumulate or when a resume moves the watermark. `metricsWindow` contains the exact watermark timestamps.\n\nRequires the account:read scope, so a read-only key can diagnose a blocked account. resume_sending restores sending once the underlying problem is fixed.","params":["companyId"]},{"name":"resume_sending","description":"Request that paused company-level sending be restored after fixing the cause. This is the supported remediation path for an account paused by the permanent-bounce rate limit - it is not a bypass and it never removes suppressions.\n\nIntended for after the bad source (import, form, or integration) is actually fixed while permanent bounces remain suppressed. get_sending_status reports the current gate: for a paused workspace, resume only restores sending when `selfResume.canSelfResume` is true, which requires a hard-bounce pause reason, a cleared automated sender-health review, and no admin block. A workspace that is already active succeeds as a no-op with `resumed: false`; any other blocked state needs a support review, and the error names which one.\n\nlistSanitizationConfirmed: true is required and represents the user's confirmation that the remediation is done; it is recorded on the account's audit trail as their statement that the list is clean. On success, sending is restored, the bounce watermark resets so the rate is recalculated from later sends, and the service attempts to requeue paused campaigns plus due sequence steps. The response message contains support guidance if part of that queue handoff is temporarily unavailable.\n\nRequires the companies:manage scope and owner or admin access to the company.","params":["listSanitizationConfirmed","companyId"]},{"name":"get_tracking_domain","description":"Get the company tracking domain every sending domain uses for tracked links and opens: hostname, status, whether links use it now (active), the CNAME record to publish, and the last check. trackingDomain is null when none is set and links use the shared Sequenzy domain.","params":["companyId"]},{"name":"set_tracking_domain","description":"Set or change the company tracking domain: one hostname every sending domain uses for tracked links and opens, for example links.example.com. Any subdomain the user controls works; a bare root domain is rejected. Publish the returned trackingDomain.cnameRecord. It never blocks sending: until it verifies, links use the shared Sequenzy domain. Changing it keeps the previous hostname serving links in emails already sent while its old CNAME stays. Confirm the hostname with the user first.","params":["companyId","domain"]},{"name":"verify_tracking_domain","description":"Check the company tracking domain's CNAME and HTTPS certificate now instead of waiting for the automatic check. Returns verified, a message with the next step, and the tracking domain status.","params":["companyId"]},{"name":"remove_tracking_domain","description":"Remove the company tracking domain. New emails use the shared Sequenzy tracking domain, and links and images in emails already sent through the removed domain stop working. Confirm with the user first.","params":["companyId"]},{"name":"get_frequency_cap","description":"Get the company frequency cap: the most marketing emails (campaigns plus marketing sequence emails) one contact may receive in a rolling window. frequencyCap is null when no cap is set. Only sequences with frequencyCapEnabled respect it: their email steps are skipped for a contact already at the cap, and the contact moves to the next step. Campaigns count toward the cap but always send. Transactional emails never count and are never skipped.","params":["companyId"]},{"name":"set_frequency_cap","description":"Set or change the company frequency cap: at most maxEmails marketing emails per contact in any windowHours. Applies from the next email step onward to sequences with frequencyCapEnabled (set it with create_sequence or update_sequence). Campaigns count toward the cap but always send. Transactional emails never count and are never skipped.","params":["companyId","maxEmails","windowHours"]},{"name":"clear_frequency_cap","description":"Turn the company frequency cap off. Sequences keep their frequencyCapEnabled setting, but nothing is skipped until a cap is set again with set_frequency_cap.","params":["companyId"]},{"name":"get_tracking_settings","description":"Get the company's email tracking and signup consent configuration: account-wide and Transactional API open/click defaults, unsubscribe tracking, opt-in strict bot filtering, default attribution window, automatic UTM tagging, the company tracking domain (shared by every sending domain) and its verification status, inbound reply-tracking settings, and whether double opt-in is required for new contacts. Use this to audit measurement readiness, to explain why opens or clicks may not be recorded, and to check how contacts enter the list before investigating bot or alias signups.","params":["companyId"]},{"name":"update_tracking_settings","description":"Update the company's email tracking defaults: account-wide open and click tracking, narrower open and click defaults for Transactional API sends, unsubscribe tracking, opt-in strict bot filtering, the default attribution window, and automatic UTM tagging, plus the account-wide double opt-in requirement for new contacts. Applies to emails sent afterwards; already-sent emails keep the links they were rendered with. Transactional API defaults cannot enable an account-wide setting that is off, and an individual send may opt out again. Provide at least one field. Reply tracking (inbound email, reply domain mode, reply forwarding) is on update_company. The company tracking domain is managed with set_tracking_domain, verify_tracking_domain and remove_tracking_domain.","params":["companyId","openTrackingEnabled","clickTrackingEnabled","transactionalOpenTrackingEnabled","transactionalClickTrackingEnabled","strictBotFilteringEnabled","unsubscribeTrackingEnabled","emailContentStorageEnabled","defaultAttributionWindowHours","doubleOptInEnabled","doubleOptInRedirectUrl","autoUtmEnabled","autoUtmSettings"]},{"name":"get_notification_preferences","description":"Get the account notification settings for the API key's own user in this company: whether Sequenzy emails them when a new subscriber joins, when a form is submitted, when a campaign finishes sending, and whether they get the Monday weekly report (last week's sends, engagement, new subscribers, revenue, goals, and sequence trends versus the week before; on by default for the workspace owner, off by default for invited members, only sent for weeks with more than 10 emails sent), whether they get the account health check's findings (account_health: on by default for the owner, opt-in for members; carried inside the Monday report when they get it, otherwise sent as their own email), and whether each arrives per-occurrence, as a daily summary, or weekly. Instant form-submission notifications stop after 50 per workspace per UTC day. Returns the supported modes and the platform defaults for this user's role alongside the current values. These are per-person settings - this never reads a teammate's preferences.","params":["companyId"]},{"name":"update_notification_preferences","description":"Change which account notifications Sequenzy emails the API key's own user for this company. Requires the companies:manage scope. Useful before a bulk import or a large migration, when per-signup notifications would otherwise flood the inbox, or to turn the Monday weekly report off (it is on by default only for the workspace owner; invited members set weekly_report to 'weekly' to receive it), or to opt in or out of the account health check's findings (account_health 'instant' or 'off'). Modes are 'off', 'instant' (one email per occurrence), 'daily' (one summary per day), and 'weekly' (the Monday report); 'daily' is only valid for new_subscriber, because a campaign finishes once and each form submit is its own lead, and 'weekly' is only valid for weekly_report; account_health accepts only 'off' or 'instant'. Instant form-submission notifications stop after 50 per workspace per UTC day. New-subscriber notifications already fall back to a daily summary automatically on high-volume days, and imports never trigger them at all.","params":["companyId","notificationPreferences"]},{"name":"get_integration_guide","description":"Get code examples for integrating Sequenzy into your project.\n\nSaaS and subscription apps: when the app uses Stripe, Polar, Paddle, Dodo, Lemon Squeezy, or Creem, the native integration in the Sequenzy dashboard (Settings -> Integrations) handles payment events and customer tags automatically, so no code is needed for those.\n\nE-commerce stores: Shopify and WooCommerce stores use the native integration in the dashboard, which syncs products, orders, and customers automatically. Other e-commerce stacks (custom checkouts, CheckoutChamp, Sticky.io, headless storefronts) integrate through the 'ecommerce' use case and the Commerce API.\n\nManual event tracking code is an opt-in use case for custom events only.\n\nUse cases:\n- 'transactional': Sending one-off emails (welcome, password reset, receipts)\n- 'subscribe_form': Adding subscribers from signup forms\n- 'event_tracking': Tracking CUSTOM events only (not payment events - those come from the integration)\n- 'ecommerce': Connecting a custom e-commerce platform via the Commerce API (sync products, push orders/checkouts, power abandoned cart + back-in-stock automations)\n\nProtected server-side API work needs an API key (create_api_key), passed to the SDK as apiKey: process.env.SEQUENZY_API_KEY. Non-Webflow static-site saved forms are the exception: list_forms/create_form/get_form_embed return public embed code, and secret keys must never be placed in browser code. Webflow-connected companies use explicitly selected native forms in Settings -> Integrations -> Webflow; custom embed code is disabled.","params":["framework","use_case"]},{"name":"get_account_health","description":"Read the company's account health report: what to fix in its email setup. Returns eligibility (checks need more than 1,000 active subscribers and an email sent in the last 14 days; hasMinimumSubscribers and sentRecently say which is missing), settings (enabled, autonomy), nextRunAt, the latest run (status, AI summary, stats snapshot of this period vs the one before) and runInProgress, plus open and snoozed insights, most severe first. Each insight has a detector (unhandled_event, stalled_sequence, campaign_gap, stale_campaign_drafts, underperforming_sequence_email, deliverability_spike, sending_domain_failing, missing_sequence: a standard lifecycle sequence such as welcome or re-engagement the workspace does not run yet, with the suggested playbook, name, goal, trigger and steps in evidence; over_emailing: people who got 4+ marketing emails within 24 hours in the last 7 days, with overloadedSubscribers, recipients, peakPerDay, frequencyCap and the campaigns, sequences and marketing Send API email (type api, which the cap does not limit) behind it as sources in evidence, where a sequence with enrollsEveryTime and peakEnrollmentsPerPerson 3 or more re-enrolls the same people and is fixed first with update_sequence enrollmentMode one_time; neglected_subscribers: active subscribers who got no marketing email in 90 days, with neglectedSubscribers, eligibleSubscribers and estimated in evidence; unengaged_signups: contacts who joined in the last 60 days with the same consumer mailbox provider (Gmail, Yahoo, Outlook; business domains are never reported) and first list, got 2+ emails each and almost never opened or clicked while other new signups do, usually a bot filling a signup form or a bought list, with provider, providerLabel, listId, listName, emailed, sends, engaged, baselineEmailed and baselineEngaged in evidence), severity, title, detail, recommendation fixAutomationId when the agent drafted an inactive sequence to fix it, and actions: what to do about it, primary first. Each action has kind (create_sequence, open_sequence, activate_sequence, pause_sequence, create_campaign, review_campaign_drafts, open_campaign, verify_sending_domain, open_domain_settings, review_deliverability, open_frequency_cap_settings, apply_frequency_cap, review_subscribers), label, targetId, a dashboard path for screens, a confirm prompt for changes to live sending, and the api call that performs it: create_sequence -> create_account_health_fix, activate_sequence -> enable_sequence, pause_sequence -> disable_sequence, verify_sending_domain -> verify_sending_domain, open_frequency_cap_settings -> set_frequency_cap (for example maxEmails 1, windowHours 16) when evidence.frequencyCap is null, otherwise get_frequency_cap and only tighten it (the cap only holds back sequences, so when the sources are only campaigns or api it does not help; suggest spacing those out instead), apply_frequency_cap -> update_sequence with frequencyCapEnabled true on targetId (only on sequences th","params":["companyId"]},{"name":"update_account_health_settings","description":"Turn the weekly account health check on or off and choose whether it drafts fixes. Pass only the fields to change. Checks never send email to subscribers or activate anything: autonomy draft_fixes only creates inactive draft sequences. Checks run every Monday at 05:00 UTC, before the Monday weekly report that carries the findings; the schedule is fixed. Who gets the findings is each person's own account_health notification preference (update_notification_preferences), not a workspace setting. Owner or admin only. Requires companies:manage.","params":["companyId","enabled","autonomy"]},{"name":"run_account_health_check","description":"Queue an account health check now and return the run. If a check is already queued or running it is returned with alreadyInProgress true instead. Manual checks are limited to one every 10 minutes and wait a day after a check that left findings open (both 429 RATE_LIMITED with retryAfterSeconds), need more than 1,000 active subscribers and an email sent in the last 14 days (409 NOT_ELIGIBLE), and never send the report email. The check usually finishes within a minute; poll get_account_health until runInProgress is false. Requires sequences:write.","params":["companyId"]},{"name":"update_account_health_insight","description":"Act on one account health insight by id (from get_account_health): dismiss hides it for good, snooze hides it for snoozeDays (default 7, up to 90), resolve marks it fixed (it reopens if the next check still finds it), reopen brings back a snoozed or resolved one. Requires sequences:write.","params":["companyId","insightId","action","snoozeDays"]},{"name":"submit_account_health_feedback","description":"Tell the Sequenzy team whether an account health insight (id from get_account_health) was useful to the user: rating useful or not_useful, with an optional comment on why. Use it when the user says a finding or suggestion helped or missed, in their words; do not rate on their behalf. It records the API key owner's own answer and changes nothing in the workspace (to hide a finding use update_account_health_insight). One answer per person per insight: submitting again replaces the rating and keeps the earlier comment unless comment is passed (null clears it). Works for insights of any status. 404 for an unknown insight. Requires analytics:read.","params":["companyId","insightId","rating","comment"]},{"name":"create_account_health_fix","description":"Build the draft sequence an account health insight asks for, from an unhandled_event or missing_sequence insight (its primary action kind is create_sequence). Creates an inactive sequence with its timing and empty, titled email steps: for unhandled_event, triggered by the event and named for the moment (for example New customer onboarding for saas.purchase); for missing_sequence, with the name, trigger (contact added, an event, or manual enrollment) and steps from the insight's evidence. Like a sequence from a template, a new draft has its emails written with AI: enrichmentStatus is processing while they are written (get_sequence reports progress), or not_queued when writing could not start (opening the sequence in the dashboard starts it; do not build again). Running it again returns the same draft with created false; steps that still have no email (for example a check's own draft nobody opened yet) are written then, with enrichmentStatus, and existing emails are never rewritten. 409 IN_PROGRESS when another build of the same insight is running; 400 for other insight types. Show it with get_sequence; enable_sequence only works once every email step has an email, and only after the user approves. Requires sequences:write.","params":["companyId","insightId"]},{"name":"get_email_ai_style","description":"Get the company's saved AI email appearance, revisionId and canManage. Read this before replacing or clearing a style. No active style returns null; an unsupported version can still have a revisionId for recovery.","params":["companyId"]},{"name":"save_email_ai_style","description":"Save an email's appearance as the company default for future AI generation. Captures fonts, colors, spacing and block treatments, plus detected layout habits (for example dotted dividers around every button) and optional notes, without copying its content or modifying existing emails. Requires emails:write and access to the source email. Replaces only expectedStyleId; get and review the current style before replacing. All detected habits are kept unless layoutRuleIds narrows them; review style.layout.rules in the response and re-save with a subset if needed. Plain-text choices and explicit style requests take precedence during generation.","params":["companyId","emailId","expectedStyleId","canvas","layoutRuleIds","notes"]},{"name":"clear_email_ai_style","description":"Clear the company's saved AI appearance and restore normal defaults for future generations. Existing emails stay unchanged. Requires emails:write. Get and review the current style first; a conflict must not be retried automatically.","params":["companyId","expectedStyleId"]},{"name":"disconnect_integration","description":"Disconnect a Lemon Squeezy or SparkLoop integration and stop live ingestion and sync. Deletes only the managed provider webhook; manual webhooks remain. Local disconnection succeeds even if provider cleanup fails: inspect cleanupWarning. Repeating the call retries Lemon Squeezy cleanup; for SparkLoop, delete the leftover webhook in SparkLoop. Other providers require the dashboard. Requires integrations:manage and owner/admin access.","params":["integrationId","companyId"]},{"name":"connect_integration","description":"Connect an API-key / webhook-secret integration: polar, paddle, dodo, lemon_squeezy, whop, revenuecat, superwall, adapty, creem, chargebee, clerk, posthog, segment, mixpanel, amplitude, affonso, attio, or sparkloop. Check list_integration_capabilities first - each connectable provider lists its exact connectFields there. Credentials are validated, stored encrypted, and never returned; payment providers queue their initial revenue backfill automatically. Lemon Squeezy creates a managed signed webhook when webhookSecret is omitted, or uses the supplied secret for manual setup. RevenueCat is webhook-only (no backfill): webhookSecret is the authorization header value configured on the RevenueCat webhook, or its HMAC signing secret. Superwall is webhook-only too and needs only webhookSecret: the whsec_ signing secret of the Superwall webhook pointed at the returned webhookUrl. Mixpanel and Amplitude need only webhookSecret, a strong random value you choose: Mixpanel sends it as the Basic auth password of its webhook destination (any username, the dashboard suggests sequenzy) and syncs cohorts as mixpanel-<cohort> tags; Amplitude sends it in an X-Webhook-Secret header and streams events (product.*), user properties, and cohorts (amplitude-<cohort> tags). Sequenzy cannot show the secret again, so give it to the user once. Attio is outbound-only and has no webhookUrl. SparkLoop needs only apiKey; Sequenzy registers the SparkLoop webhook itself with a secret in its URL (webhookSecret, the account's SparkLoop-Token, is optional), and an account with several publications needs providerAccountId (the 400 error lists them in publications). Reconnecting replaces stored credentials. OAuth and app-install providers (Stripe, Shopify, Supabase, GitHub, WooCommerce, Meta) are rejected with guidance: their flows need a human in the dashboard. SECURITY: only pass credentials the user explicitly provided for this purpose; suggest the CLI (`sequenzy integrations connect`) or dashboard when the user prefers keeping secrets out of the conversation.","params":["provider","apiKey","webhookSecret","providerAccountId","settings","historyImport","companyId"]},{"name":"get_integration","description":"Inspect one connected integration in depth: what the provider syncs, every event it can emit and when, every matching tag rule, which sequences trigger on those events, recent integration-specific activity, and prioritized recommendations. For Webflow, `webflowCapture` reports the exact selected native forms, retained field names, double-opt-in policy, list IDs, sequence toggle, webhook status, and schema fetch time; capture is off when its forms array is empty. `observedByAccount` and `accountLastSeenAt` are account-wide because event definitions can also be updated by another integration or the public events API; use the retained activity log for connection-specific delivery diagnosis. For Attio, an `attio_lists_unmapped` recommendation means nothing is mapped so nothing syncs, and `attio_inbound_sync_error` means changes made in Attio are not reaching Sequenzy — use get_attio_mapping then update_attio_settings; do not reconnect for that. Read-only; credentials are never returned. Get the id from list_integrations.","params":["integrationId","companyId"]},{"name":"list_integration_capabilities","description":"Describe what Sequenzy's integration providers do, whether or not they are connected. For each provider: category, how it connects, what it syncs, every event it emits with the real-world moment that triggers it, the subscriber attributes it writes, supported actions, availability, and caveats. Use this to answer 'what would connecting Stripe give me?', to compare providers before recommending one, or to check whether an event a sequence needs actually exists for that provider. Coverage differs sharply between providers - only Shopify has storefront browse tracking, and only Stripe, Chargebee, and RevenueCat cover the full trial lifecycle - so check here rather than assuming.","params":["provider","category","companyId"]},{"name":"list_integration_suggestions","description":"Suggest integrations to connect next, based on what Sequenzy found on the company's website during onboarding: tools on the homepage or the sign-in page it links to (Clerk, Supabase, PostHog, Segment, Mixpanel, Amplitude, Webflow, Wix, WordPress, WooCommerce) or a Shopify storefront, minus anything already connected. Payment providers are never guessed from the site: when the website lists pricing and no payment or commerce integration is connected, `paymentProviders` lists every payment provider so the user can pick theirs. `scanComplete` is false while the website is still being read, so an empty list then means 'not scanned yet', not 'nothing found'. Use list_integration_capabilities to explain what a suggested provider gives and how it connects. Read-only.","params":["companyId"]},{"name":"list_integration_activity","description":"Read recent integration webhook and sync activity, newest first. This is the log to check when an integration reports connected but contacts or events are not appearing: each row carries the action, status, event type, matched contact, and error. Payloads are sanitized at write time, so no credentials or secrets appear here. Activity is retained for 24 hours only.","params":["integrationId","provider","status","limit","companyId"]},{"name":"set_integration_sync_enabled","description":"Turn a supported integration's future bulk imports and backfills on or off. THIS DOES NOT STOP AN INTEGRATION CREATING CONTACTS: disabling sync only pauses full imports and backfills, while the provider's live webhook keeps writing every new signup or customer as it happens. To change where those contacts land, use set_integration_list_targeting; to stop them arriving at all, use disconnect_integration for Lemon Squeezy or SparkLoop, or disconnect from the dashboard for other providers. Check get_integration.availableActions first; providers without enable_sync or disable_sync are dashboard-managed. Disabling keeps the connection, credentials, and live webhook delivery active, and requires any in-flight sync to finish first. It does not disconnect the integration. Idempotent: setting the current state succeeds with `changed: false`. Requires an API key with the `integrations:manage` scope, which agent-safe keys deliberately do not carry - without it, report the dashboard path (Settings -> Integrations) instead of retrying.","params":["integrationId","syncEnabled","companyId"]},{"name":"set_integration_list_targeting","description":"Choose which lists the contacts a connected integration creates join. This is the tool for 'stop this integration adding people to my marketing lists' - set_integration_sync_enabled only pauses bulk backfills and leaves the provider's live webhook writing. Scope: this changes list membership only, and it takes effect on future provider writes. It does not stop contacts being created, does not stop their attributes syncing, does not stop sync-rule tags, and does not stop `contact_added` sequences using the default `any_contact` scope, which fire precisely because the contact joined no list. Explicit `any_list` and specific-list sequences require a matching membership and do not enroll a list-less contact. Nobody is ever removed from a list and nothing is applied retroactively. Provider behavior for existing contacts differs: Wix or Webflow submissions, Shopify customer updates, and Supabase resubscriptions can add an existing contact to the new target lists; Stripe applies targeting only when its webhook creates a subscriber. Webflow is deliberately fail-closed: `null` is rejected, so pass `[]` or explicit list IDs; form selection, field allowlists, required double opt-in, and sequence enrollment remain dashboard-only under Settings -> Integrations -> Webflow. With no selected forms, Webflow capture is off and no contacts are created. If the goal is to stop `any_contact` enrollments too, pair this tool with pause_sequence_enrollments on the affected sequences. Check get_integration first - `ingestion` reports the current targeting with list names, and `availableActions` says whether this provider honors set_list_targeting. Supported for Supabase, Stripe, Shopify, Wix, Webflow, and SparkLoop. Dodo Payments, PostHog, Polar, Paddle, and other providers without that action reject this tool; their live contacts follow defaultSubscriberListIds on get_company/update_company instead (null = every list, [] = none), which is workspace-wide. PostHog history imports are an exception and create contacts without list memberships. Idempotent: asking for the current state succeeds with `changed: false`. Requires an API key with the `integrations:manage` scope, which agent-safe keys deliberately do not carry - without it, report the dashboard path (Settings -> Integrations) instead of retrying.","params":["integrationId","listIds","companyId"]},{"name":"get_integration_pixel","description":"Check whether a Shopify store's storefront tracking pixel is installed and reporting to this account. Read live from Shopify on every call, because a merchant can remove the pixel without Sequenzy hearing about it. Check this before telling the user that browse abandonment, cart recovery, product views, collection views, or storefront search will work: without a live pixel those events never arrive, the sequences built on them never fire, and nothing anywhere reports an error. Returns `pixel.healthy`, the endpoint and signed configuration state, and `dependentEvents` - the event names that rely on this pixel. When `pixel.error` is null and `pixel.healthy` is false, those events are confirmed dark; an error means Shopify could not confirm their state. Fix a confirmed unhealthy state with activate_integration_pixel. Shopify only; other providers return a clear error.","params":["integrationId","companyId"]},{"name":"activate_integration_pixel","description":"Install the Shopify storefront tracking pixel on the connected store, or repoint an existing one at this account. This is what turns on product views, cart activity, and browse abandonment - the data every browse-abandonment and cart-recovery sequence depends on. Idempotent: an already-live pixel returns `changed: false`. Events start flowing on the next storefront visit and nothing is backfilled for the period the pixel was off, so run it before, not after, building the sequence. If the store granted an older permission set, this fails with a message naming the reconnect step rather than silently doing nothing. Shopify only.","params":["integrationId","companyId"]},{"name":"sync_integration","description":"Queue a manual re-sync for an integration: customers and revenue for a payment provider (Stripe, Polar, Paddle, Dodo, Lemon Squeezy, Creem, Chargebee, Whop), the user backfill for Supabase, or the event-history import for PostHog and Segment. Use this for Supabase before a campaign that depends on names or plan attributes - the live trigger only sends rows that change after it was installed, so existing users have no attributes until a backfill runs. The Supabase sync reads the project, schema, and table already configured for the integration and cannot be pointed at a different table; if none is configured yet it fails saying so. This is also the supported way to retry a failed PostHog or Segment history import: it restarts from the beginning using the stored credentials, and already-imported events dedupe, so a re-run cannot duplicate them. Returns immediately - poll get_integration to watch `syncStatus` and `lastSyncAt`, and list_integration_activity for per-row outcomes. Fails with a conflict if a sync is already queued or running; terminal BullMQ failures release history imports for retry. Providers whose backfill is not API-triggerable (Shopify products, Affonso affiliates) return a clear error naming the dashboard. Check `availableActions` on get_integration to see whether this is supported before calling.","params":["integrationId","companyId"]},{"name":"get_attio_mapping","description":"Inspect a connected Attio integration's two-way sync: every Sequenzy list, every Attio people-list the stored token can write (id, api slug, name), the saved maps in both directions (listMap and tagMap push Sequenzy lists and tags to Attio lists; inboundListMap and inboundTagMap pull Attio lists into Sequenzy lists and tags), syncRemovals, whether company matching from work-email domains is on, and `inbound` (whether the Attio webhook is listening, and the error when it is not). Use it when Attio is connected but nothing is mapped, and call it before update_attio_settings so you have Attio list ids or slugs instead of asking the user to paste UUIDs. Reads Attio live on every call. Credentials are never returned. Attio only; other providers return a clear error. Check get_integration first — availableActions includes update_attio_settings when mapping can be saved without reconnecting.","params":["integrationId","companyId"]},{"name":"update_amplitude_settings","description":"Choose which events a connected Amplitude integration records, without the webhook secret (reconnecting would replace the secret and stop deliveries until the destination is updated). syncAllEvents false plus eventAllowlist records only those types. skipInternalEvents (on for new connections) drops session, [Amplitude] autocapture, and other $ events unless allowlisted; identify always passes. Applies to later deliveries; dropped events are not replayed. Amplitude only. Requires the `integrations:manage` scope; otherwise use the dashboard (Settings -> Integrations -> Amplitude).","params":["integrationId","syncAllEvents","eventAllowlist","skipInternalEvents"]},{"name":"update_attio_settings","description":"Set the two-way sync of an already-connected Attio integration, using the stored access token, so changing mappings does not require connect_integration or the Attio access token again. Sequenzy → Attio: listMap (Sequenzy list id → Attio list) and tagMap (Sequenzy tag → Attio list) upsert the person and add them to the Attio list when they join the list or get the tag. Attio → Sequenzy: inboundListMap (Attio list → Sequenzy list id) and inboundTagMap (Attio list → Sequenzy tag) create or update the subscriber and add them to the list or tag when someone is added to the Attio list, which triggers list and tag automations. Saving an inbound map makes Sequenzy register the Attio webhook itself; that needs the webhook:read-write scope on the token, and the call fails with instructions when it is missing. Each map is a full replacement: pass the complete desired map, `{}` to clear it, or omit it to leave it unchanged. syncRemovals (default false) mirrors removals in every mapped direction; off keeps sync add-only. Optionally set syncCompanyFromDomain. Provide at least one field. Idempotent: asking for the current state succeeds with changed: false. Only changes after saving sync; existing members are not backfilled. Check get_attio_mapping first for Sequenzy list ids and live Attio list ids/slugs, and list_tags for tag names. Attio only. Requires an API key with the `integrations:manage` scope, which agent-safe keys deliberately do not carry; without it, the same settings are available in the dashboard at Settings -> Integrations -> Attio -> Sync settings.","params":["integrationId","listMap","tagMap","inboundListMap","inboundTagMap","syncRemovals","syncCompanyFromDomain","companyId"]},{"name":"get_event_sample","description":"Read the latest actual received event in the selected workspace, across all subscribers. Requires subscribers:read. Returns sample: null when none exists. Copy sample.properties into start_sequence_test_run customVariables, editing as needed. This read does not fire an event or change the selected test recipient. Unlike get_event_schema, this is recorded account data, with no age cutoff.","params":["eventName","companyId"]},{"name":"get_event_schema","description":"Read the published payload of a built-in event: a real example payload per provider, plus every property path with its type, the merge tag that resolves it, and a note wherever the example alone is ambiguous. Call this BEFORE writing {{event.*}} merge tags or event property filters - an unrecognized merge tag renders as an empty string rather than an error, so a guessed property name ships silently broken. It is also the only place that spells out the traps the sample cannot: money fields ending in `Cents` are minor units while `predictedLtv` is whole currency units, `price` is a preformatted display string that must not be parsed, `churnRisk` is a 0-95 percent and not a probability, and `orderId` is a string on Shopify but a number on WooCommerce. Omit eventName to list every documented event, or pass provider to get one provider's payload instead of all of them. Custom events are first-class and deliberately absent from this list: `documented: false` means no sample is published, never that the event name is invalid or will be rejected. Static reference data - it describes the event shape, not what this account has received. Use get_event_sample to read the latest actual received payload.","params":["eventName","provider","companyId"]},{"name":"create_template_from_example","description":"Remix a public Sequenzy email gallery email into a new email template for this company. The new email keeps the example's exact layout and design; AI rewrites every piece of text for the company and its logo, brand color and links are swapped in. The example brand is never named and none of its copy, offers or claims are reused. Saved as an HTML template. Requires templates:write. Takes 5-20 seconds. Creates no template if generation fails (a company's first AI generation still saves its inferred email design direction); each successful call creates another template. Accepts a gallery email URL (https://sequenzy.com/email-examples/brands/{brand}/emails/{email}, or for an email in a sequence the sequence page URL ending in #email-{email}) or brand plus email slugs. For a whole sequence use create_sequence_from_example.","params":["companyId","url","brand","brief","name","email"]},{"name":"preview_template_from_example","description":"Preview how a public Sequenzy email gallery email would read for this company without saving any email (a company's first AI generation saves its inferred email design direction, like generate_email): the same rewrite as create_template_from_example (the example's layout, every word written for the company, its logo, brand color and links swapped in), returned as subject, previewText and HTML. Pass website to write it for another site's brand instead, such as a prospect or client; it is looked up like the gallery's public preview. Requires templates:write. Takes 5-20 seconds. Call create_template_from_example to keep it as a template. Accepts a gallery email URL or brand plus email slugs.","params":["companyId","url","brand","brief","email","website"]},{"name":"preview_sequence_from_example","description":"Preview the first 3 emails of a public Sequenzy email gallery sequence written for this company, without creating a sequence or email (a company's first AI generation saves its inferred email design direction, like generate_email). Each email keeps the example's layout with every word rewritten; returns subject, previewText, HTML and the original day for each, plus how many emails were left out. Pass website to write it for another site's brand instead. Requires sequences:write. Takes 10-30 seconds. Call create_sequence_from_example to create the draft sequence with every email. Accepts a gallery sequence URL or brand plus sequence slugs.","params":["companyId","url","brand","brief","sequence","website"]},{"name":"create_sequence_from_example","description":"Clone a public Sequenzy email gallery sequence into a draft sequence for this company, with the example's trigger family (signup, abandoned cart, order placed, or inactive tag) and send timing, up to 12 emails (the first 12 unless stepNumbers picks which; each kept email keeps its original timing from the trigger). AI then writes every email in the company's brand in the background (usually 30-60 seconds); poll get_sequence until enrichmentStatus is complete. If this tool returns enrichmentStatus not_queued with a warning, the draft exists but writing did not start: open it in the dashboard and do not call this tool again. The sequence stays a draft and sends nothing until enabled. Requires sequences:write. Each call creates another sequence. Accepts a gallery sequence URL (https://sequenzy.com/email-examples/brands/{brand}/sequences/{sequence}) or brand plus sequence slugs.","params":["companyId","url","brand","brief","name","sequence","stepNumbers","emailStyle"]},{"name":"list_email_references","description":"List real emails from the Sequenzy email gallery to model a new email on, for the kind of email being written: campaign (promotions, newsletters, product updates), sequence (lifecycle emails plus whole sequences) or transactional. By default (scope similar) they come from the gallery brands most like the company: brands whose businesses (what each sells, and to whom) are closest in meaning to the company description, closest first (returned as brands; rankings are reused for up to 10 minutes). To rank them, the company description and any search text are sent to an embeddings service; nothing is saved. Each item has a gallery url that create_template_from_example (or create_sequence_from_example for a sequence) accepts, and emails carry an analysis (main button, length, layout, voice, structure and why it works; null until analyzed) to choose a model by. With scope all it browses the whole gallery instead; search narrows either. profile is missing (and the list empty) when the company has no description or company context yet; use scope all then. Requires templates:read.","params":["companyId","kind","scope","search","page","subtype","limit"]},{"name":"list_gallery_brand_requests","description":"List this company's requests to add brands (usually competitors) to the Sequenzy email gallery, newest first. Each has a status: requested (not added yet), collecting (the brand is added and its emails are being collected), available (its emails are in the gallery; brand.url links to them and list_email_references can return them) or declined (with declineReason). Requires templates:read.","params":["companyId"]},{"name":"request_gallery_brand","description":"Ask for a brand, usually a competitor, to be added to the Sequenzy email gallery so its real emails can be used as references. Pass its website or domain. Asking again for the same domain keeps the one request (a new note replaces the old) and returns created false. If the brand is already in the gallery, the request comes back with status available. A company can keep up to 50 requests. It is not your own website. Requires templates:write.","params":["companyId","website","note"]},{"name":"remove_gallery_brand_request","description":"Withdraw one of this company's brand requests by id (from list_gallery_brand_requests). The brand stays in the gallery if it was already added. Requires templates:write.","params":["companyId","id"]},{"name":"list_watched_brands","description":"List the brands (usually competitors) this company watches, newest watch first. Each has a status: available (its emails are in the gallery; emailCount and latestEmailAt say how many and how recent), requested (not in the gallery yet), collecting (added, emails on the way) or declined (with declineReason). Use list_watched_brand_emails to read what they sent. Requires templates:read.","params":["companyId"]},{"name":"watch_brand","description":"Watch a brand, usually a competitor, by its website or domain. A brand already in the Sequenzy email gallery is watched at once (status available) and its emails can be read with list_watched_brand_emails; any other brand is requested and its emails show up once it is added and they are collected. New emails arrive a few hours after they are sent. Watching again keeps the one watch (a new note replaces the old) and returns created false. A company can keep up to 50 watches and brand requests together. It is not your own website. Requires templates:write.","params":["companyId","website","note"]},{"name":"unwatch_brand","description":"Stop watching a brand by its watch id (from list_watched_brands). This also withdraws the brand request with the same id. The brand stays in the gallery. Requires templates:write.","params":["companyId","id"]},{"name":"list_watched_brand_emails","description":"Read emails the watched brands sent, newest first, a page at a time: subject, type, subtype, sentAt, collectedAt, brand, url and a breakdown (analysis, null until analyzed). Pass domain for one brand and since for emails sent at or after a time (for example the start of this week). Emails arrive a few hours after they are sent, so when polling set since about a day before the last check and skip ids already seen. Pass nextCursor back as cursor for older emails. Each url also works as the url of create_template_from_example to remix it. Requires templates:read.","params":["companyId","domain","since","limit","cursor"]},{"name":"start_subscriber_operation","description":"Add tags to a whole filtered audience in the background. Returns a durable operation ID; poll get_subscriber_operation or list_subscriber_operations. Reuse requestKey after an uncertain response; changing inputs with the same key is rejected. Tagging needs subscribers:tag, new definitions need tags:write, and triggerAutomations needs automations:trigger. Existing synchronous bulk tag tools remain suitable for up to 500 explicit contacts.","params":["companyId","kind","requestKey","audience","tags","triggerAutomations"]},{"name":"list_subscriber_operations","description":"List the company's 20 most recent background tagging operations, including progress and failures.","params":["companyId"]},{"name":"get_subscriber_operation","description":"Read background operation progress and state. A completed tagging operation may have per-contact failures; inspect failed and failures.","params":["companyId","operationId"]},{"name":"cancel_subscriber_operation","description":"Stop future work for a queued/running tagging operation. Already applied tags are retained. Tagging cancellation requires subscriber tagging access.","params":["companyId","operationId"]},{"name":"add_subscriber","description":"Add one subscriber. Status is only applied when creating a new contact; use update_subscriber to change an existing contact's status. The subscribers:write scope covers listIds in this call. Matching sequences enroll by default (REST enrollInSequences), including tag_added when tags are set in this call, without requiring a list; pass enrollInSequences false to skip, and automations:trigger is required for enrollment. Without automations:trigger the call succeeds but starts no sequence (sequenceTriggersRan false, reason missing_scope). For multiple contacts or CRM records, use create_subscriber_import instead of looping this tool. For an email-only batch going into one list, add_subscribers_to_list is also available.","params":["companyId","email","externalId","phone","phoneCountry","smsConsent","firstName","lastName","timezone","attributes","customAttributes","tags","listIds","status","optInMode","enrollInSequences","createdAt"]},{"name":"create_subscriber_import","description":"Queue one CRM-grade subscriber import with up to 5,000 full contact records. Supports names, external IDs, phones, statuses, tags, lists, and custom attributes. Prefer this over repeated add_subscriber calls. Returns an import ID for get_subscriber_import. Use optInMode='confirmed' only when the contacts already gave verified email consent. Rows are imported only after a list check, usually under a minute. When the list has too many addresses that don't exist or look risky (temporary inboxes, or mostly shared addresses like info@), nothing is imported and the finished import has listQuality (status 'needs_cleaning', with issues): relay listQuality.message and suggest cleaning the list (listQuality.cleaningUrl) and importing the cleaned list.","params":["companyId","subscribers","duplicateStrategy","fileName","listIds","enrollInSequences","defaultPhoneCountry","smsConsent","optInMode","idempotencyKey"]},{"name":"get_subscriber_import","description":"Get progress, counts, skipped reasons, and failure summaries for a queued subscriber import. Every excluded row is explained: skippedReasons sums to skippedCount and failedReasons sums to failedCount, so a finished import can be reconciled without inspecting individual contacts. If the reason counts fall short of the totals, report it with the import ID rather than guessing what the missing rows were. listQuality is null unless the list needs cleaning; then nothing was imported (rows skipped as list_needs_cleaning) and you should relay its message and cleaningUrl. An import stays running until its list check finishes.","params":["companyId","importId"]},{"name":"update_subscriber","description":"Update an existing subscriber's profile, phone, status, attributes, or tags. Names and phones are native profile fields - set them here rather than as custom attributes. Setting status to unsubscribed suppresses the contact from all marketing, deactivates list memberships, and cancels active sequence enrollments while preserving the record and suppression history. Without automations:trigger, added tags start no sequence (sequenceTriggersRan false).","params":["companyId","email","externalId","firstName","lastName","timezone","phone","phoneCountry","smsConsent","status","attributes","customAttributes","addTags","removeTags"]},{"name":"remove_subscriber","description":"Unsubscribe a subscriber while preserving the record and suppression history: the contact is suppressed from all marketing, list memberships are deactivated and active sequence enrollments are cancelled. With hardDelete true the contact is permanently deleted and its history erased, which cannot be undone. Identify the contact by email or externalId.","params":["companyId","email","externalId","hardDelete"]},{"name":"get_subscriber","description":"Get the full subscriber profile, including tags, notes, list memberships, sequence enrollments, email stats, and recent activity. For commerce customers, customAttributes include nightly predictive analytics: predictedLtv (next-12-month spend), churnRisk (percent), expectedNextOrderAt, avgDaysBetweenOrders, and predictionConfidence.","params":["companyId","email","externalId","includeMachineEngagement"]},{"name":"list_subscriber_notes","description":"List internal notes for a subscriber. Provide email or externalId to identify the subscriber.","params":["companyId","email","externalId"]},{"name":"list_subscriber_attributes","description":"List the custom attribute names in use across the account, each with its value type (string, number, or boolean), whether it holds a list (isArray), an example value, and how many of the sampled recent contacts carry it. Call this before add_subscriber or update_subscriber to reuse existing names and match their types, e.g. send a zip code as the string \"02134\" rather than a number. Names only older contacts carry are included with sampledContacts 0. mixedTypes is true when contacts hold different types for a key; valueType is then string. Always send values with leading zeros as strings, whatever valueType says.","params":["companyId","includeNested"]},{"name":"add_subscriber_note","description":"Add an internal note to a subscriber. Provide email or externalId to identify the subscriber.","params":["companyId","email","externalId","body"]},{"name":"delete_subscriber_note","description":"Delete one internal subscriber note by note ID.","params":["companyId","noteId"]},{"name":"trigger_subscriber_event","description":"Emit a custom event for one subscriber, exactly as an integration or the public API would. This is the supported way to exercise event triggers, matching-field idempotency, branch conditions, and stop conditions end to end without waiting for real traffic. The event is recorded, sync rules apply, and matching event_received sequences enroll. Without automations:trigger the call succeeds but starts no sequence (sequenceTriggersRan false, reason missing_scope). Creates the subscriber if they do not exist. Use trigger_subscriber_events for several events on the same contact.","params":["companyId","email","externalId","event","account","properties","firstName","lastName","attributes","occurredAt","eventId"]},{"name":"trigger_subscriber_events","description":"Emit several custom events for one subscriber in order, exactly as an integration would: each event is recorded, sync rules apply, and matching event_received sequences enroll. Creates the subscriber if they do not exist. Events are processed independently and sequentially, so a partial failure can still leave earlier events recorded; retry with the same eventIds. Returns the subscriber and the recorded events. Without automations:trigger the call succeeds but starts no sequence (sequenceTriggersRan false, reason missing_scope).","params":["companyId","email","externalId","events","firstName","lastName","attributes"]},{"name":"import_subscriber_events","description":"Record a bounded batch of events for many subscribers in one call, built for data pipeline and warehouse syncs. Each event carries its own email or externalId and a required source-owned eventId; externalId-only rows must identify an existing contact because email is required for creation. Contacts whose events are all more than an hour old are imported silently as history (including no double-opt-in email); any recent event makes that contact's whole group live. Retries keep one receipt and re-attempt any downstream recovery that has not finished. Accepts at most 25 events. Without automations:trigger the call succeeds but starts no sequence for live rows (sequenceTriggersRan false, reason missing_scope).","params":["companyId","events"]},{"name":"bulk_add_subscriber_tags","description":"Many contacts, one or more tags: add tags to up to 500 existing subscribers in one call, identified by emails, externalIds, or subscriberIds. Never creates contacts. Built for reconciling historical or derived tags: subscribers that do not exist are reported in notFound instead of being created, and tag automations do NOT run unless triggerAutomations is true. Returns the normalized tags and counts of requested, matched, updated, unchanged and failed subscribers, with notFound identifiers and up to 50 failures. Needs the subscribers:tag scope; a tag name that does not exist yet also needs tags:write. The agent_safe key preset includes both. Use add_subscriber or update_subscriber for single-contact changes.","params":["companyId","tags","emails","externalIds","subscriberIds","triggerAutomations"]},{"name":"bulk_remove_subscriber_tags","description":"Many contacts, one or more tags: remove tags from up to 500 existing subscribers in one call, identified by emails, externalIds, or subscriberIds. Never creates contacts: subscribers that do not exist are reported in notFound. Needs the subscribers:tag scope; the broader subscribers:write scope also satisfies it. Use this to roll back or reconcile a derived-tag backfill. Returns the normalized tags and counts of requested, matched, updated, unchanged and failed subscribers, with notFound identifiers and up to 50 failures.","params":["companyId","tags","emails","externalIds","subscriberIds"]},{"name":"search_subscribers","description":"Search subscribers by free-text query, tags, list, segment, custom attribute, or opt-out date. Each subscriber carries unsubscribedAt, the date the contact opted out - use it rather than updatedAt, which any later tag or attribute write overwrites. If you omit limit, the tool fetches all pages and returns every match in one call - that is the fastest way to enumerate an audience. To walk a large audience in chunks instead, pass limit and then follow pagination.nextCursor (or pagination.nextOffset) until pagination.hasMore is false. Default searches are newest first; searches with attribute use stable subscriber-ID ascending order. Returns the matching subscriber records, the count returned, and pagination with total, hasMore, nextCursor and nextOffset.","params":["companyId","query","tags","list","listId","listName","segmentId","status","unsubscribedAfter","unsubscribedBefore","attribute","attributeValue","attributeOperator","limit","offset","page","cursor"]},{"name":"list_accounts","description":"List your customers' organizations (B2B accounts such as companies, workspaces or teams) in the workspace. The dashboard shows them under Subscribers > Organizations; these tools keep the account names. Not your Sequenzy account, workspace or login: use get_account for that. Search matches name, external ID and domain. Organizations group contacts; their attributes reach every member as `organization.<name>` for segment attribute filters and sequence conditions, and as `{{organization.<name>}}` merge tags (`account.*` is an older alias).","params":["companyId","search","page","limit","sort","order","withoutEventRecipients"]},{"name":"get_account_by_external_id","description":"Get one customer organization (Subscribers > Organizations in the dashboard) by its external ID, including up to 100 member contacts with their roles (owner, admin, member). Not your Sequenzy account: use get_account for that.","params":["companyId","externalId"]},{"name":"upsert_account","description":"Create or update a customer organization (Subscribers > Organizations in the dashboard) by external ID. Attributes merge into the stored attributes (a null value deletes a key; set replaceAttributes to replace them all). Optional members are added in the same call. Use this to model companies, workspaces or teams so segments can filter on `organization.plan` and emails can use `{{organization.name}}` (`account.*` still works). The first organization turns Organizations on for the workspace; it fails with a 409 error when contacts already use a custom attribute named `account` or `account.*`, which must be renamed first.","params":["companyId","externalId","name","domain","attributes","replaceAttributes","members"]},{"name":"delete_account","description":"Delete one customer organization (a B2B account your contacts belong to, shown under Subscribers > Organizations) and its memberships. Contacts are kept; their `organization.*` attributes are cleared. It never deletes the user's Sequenzy account, workspace (company), login or API keys. If the user asks to delete their own Sequenzy account or workspace, do not call this tool: that is only possible in the Sequenzy dashboard. Permanent; confirm the organization's externalId with the user first.","params":["companyId","externalId"]},{"name":"list_account_members","description":"List the contacts that belong to a customer organization with their roles. Owners first, then admins, then members.","params":["companyId","externalId","limit"]},{"name":"add_account_member","description":"Add a contact to a customer organization (creating the contact when the email is new). Re-adding an existing member with a role updates the role; without a role keeps the current one.","params":["companyId","externalId","email","subscriberExternalId","role","firstName","lastName"]},{"name":"remove_account_member","description":"Remove a contact from a customer organization. The contact is kept; its `organization.*` attributes are cleared or replaced by another organization it belongs to.","params":["companyId","externalId","email","subscriberExternalId"]},{"name":"trigger_account_event","description":"Record an event on a customer organization (for example trial_ending, plan_changed, seat_limit_reached) and deliver it as a contact event to the chosen recipients: owners (default; falls back to admins when there is no owner), admins (includes owners), all members, or none (timeline only). Each delivery runs sync rules and sequence triggers with `event.organization.*` properties (also available as `event.account.*`). To start a sequence once per organization rather than once per recipient, create it with enrollmentMode matching_field and enrollmentFieldPath organization.externalId. Pass eventId to make retries idempotent.","params":["companyId","externalId","event","properties","recipients","occurredAt","eventId"]},{"name":"list_account_events","description":"List recent events on a customer organization's timeline, newest first.","params":["companyId","externalId","limit"]},{"name":"list_account_suggestions","description":"Suggest accounts from work email domains that several contacts share (for example 7 contacts at acme.com). Personal and disposable providers (gmail.com, outlook.com, yopmail.com, ...), the workspace's own sending domains, domains where any contact already belongs to an account, and domains an account already uses are skipped. Each suggestion includes up to 10 sampleEmails for review. Read-only; show the list to the user and accept only the domains they confirm with accept_account_suggestions.","params":["companyId","minContacts","limit"]},{"name":"accept_account_suggestions","description":"Create accounts from suggested email domains. Each domain becomes an account (externalId and domain set to the domain, name derived from it) with the domain's contacts that belong to no account as members. When one account already uses the domain, contacts are added to it; with several, the domain is skipped (multiple_accounts). A domain whose contacts already partly belong to another account is skipped (already_in_account); domains without eligible contacts are skipped (no_contacts). Up to 25 domains per call; personal, disposable and the workspace's own sending domains are rejected. Keeps existing roles, runs no sync rules or segment-entered sequences, and a retry does not duplicate accounts or members; truncated means contacts were left out because an account holds at most 5,000 members. Fails with a 409 error while contacts use a custom attribute named `account` or `account.*`.","params":["companyId","domains"]},{"name":"detect_account_organization_ids","description":"Find the organization ID the app already sends, so accounts can be created from existing data without code. Looks at event properties from the last 180 days and contact attributes named like workspaceId, organization_id, team_id or account_id. Each candidate has source (event or attribute), propertyKey, nameKey (a sibling name property or null), eventCount (events for event, contacts for attribute), accountCount (distinct organizations) and eventNames. Read-only; next, preview a candidate with preview_accounts_from_organization_id and show it to the user.","params":["companyId"]},{"name":"preview_accounts_from_organization_id","description":"Preview the biggest accounts create_accounts_from_organization_id would make, before anything is written. Each organization has externalId (its ID), name (from nameKey, otherwise from the work email domain most of its contacts share, null when neither exists), domain, contactCount and up to 3 sampleEmails. Read-only; always show this preview to the user and get confirmation before creating accounts.","params":["companyId","propertyKey","source","nameKey","limit"]},{"name":"create_accounts_from_organization_id","description":"Start a background job that creates one account per distinct propertyKey value and adds each contact seen with it as a member. Accounts are named from nameKey, otherwise after the work email domain most of their contacts share; existing names, domains and roles are kept. No emails are sent, no sync rules run and no segment-entered sequences start. Returns jobId, alreadyRunning (a run for the same key was already queued or running, so none was started) and job; check progress with get_account_organization_id_job. Reruns update the same accounts instead of duplicating them. Only call after the user confirmed the preview. Fails with a 409 error while contacts use a custom attribute named `account` or `account.*`.","params":["companyId","propertyKey","source","nameKey"]},{"name":"get_account_organization_id_job","description":"Check a create_accounts_from_organization_id run. state is queued, running, completed or failed. A completed job has result with accountsCreated, accountsUpdated, membershipsCreated, membershipsUpdated, skipped and truncated (history was larger than one run covers; start it again to continue). A failed job has error. Finished jobs expire after a while (404); the accounts stay.","params":["companyId","jobId"]},{"name":"list_recipient_suppressions","description":"List the recipients this company cannot reach: protected global invalid-recipient suppressions for addresses associated with the company, protected workspace hard bounces without conclusive invalid-inbox evidence, removable workspace soft-bounce escalations, and protected spam complaints. Each row includes a stable suppressionType, and the response echoes the applied sortBy/sortOrder. Sort by `status` to surface the suppressions you can actually remove. Start here when a customer reports missing email; use get_recipient_suppression for one exact address.","params":["companyId","search","page","limit","sort","order"]},{"name":"get_recipient_suppression","description":"Check whether one recipient is suppressed by Sequenzy's bounce/complaint safeguards. Suppression comes solely from Sequenzy's own bounce records; the email provider's suppression list is not consulted. This exact-address lookup never exposes other recipients.","params":["companyId","email","region"]},{"name":"remove_recipient_suppression","description":"Remove a workspace-scoped soft-bounce escalation for an exact recipient associated with the company, then reactivate bounced company subscribers. Global invalid-recipient, workspace hard-bounce, complaint, and unsubscribe suppressions are protected.","params":["companyId","email","region"]},{"name":"list_products","description":"List synced products (Stripe, Shopify, WooCommerce) including any attached digital delivery file. Useful before attaching a file or building a purchase sequence for a specific product. For Stripe products, variants are the product's active prices (variantId = Stripe price ID), so an exact price can be targeted even when it is not the default. Returns one page: check pagination.total and pagination.hasMore, and page with offset to read the whole catalog.","params":["companyId","provider","search","limit","offset"]},{"name":"upsert_products","description":"Create or update products in the catalog (Commerce API, keyed by your productId, stored under the api provider). Use this to add products that are not synced from Stripe/Shopify/WooCommerce, then attach a deliverable file with attach_product_file and build a purchase sequence for them.","params":["companyId","products"]},{"name":"delete_product","description":"Delete a product previously pushed via upsert_products (Commerce API products only), identified by your productId.","params":["companyId","productId"]},{"name":"attach_product_file","description":"Attach a distributable file to a product, either by public URL or by uploading a local file (filePath, local MCP server only). After a purchase of the product, sequence emails can link to it with {{event.download.url}} and {{event.download.name}}.","params":["companyId","productId","url","filePath","fileName"]},{"name":"remove_product_file","description":"Remove the attached distributable file from a product.","params":["companyId","productId"]},{"name":"sync_products","description":"Queue a sync of the Stripe product catalog into the products list. Requires an active Stripe integration with bulk sync enabled. Pass integrationId when more than one Stripe account is connected; otherwise the most recently connected enabled account is used.","params":["companyId","integrationId"]},{"name":"get_push_settings","description":"Get push notification readiness: whether web push is enabled (with its VAPID public key), whether APNs (iOS) and Firebase (Android) credentials are connected, the last credential error for each, and active device counts per platform. Check this before creating push campaigns or push sequence steps.","params":["companyId"]},{"name":"update_web_push_settings","description":"Enable or disable web push, or set the default notification icon. The first enable generates the workspace's VAPID keys; disabling keeps them so existing browser subscriptions stay valid. The site must serve /sequenzy-sw.js (importScripts of the hosted worker) and call sequenzy.subscribeToPush() from a click.","params":["companyId","enabled","defaultIconUrl"]},{"name":"set_apns_credentials","description":"Connect iOS push by saving an APNs auth key (.p8). The key is encrypted at rest and never returned. Requires the integrations:manage scope and a role that can edit workspace settings (marketer keys cannot).","params":["companyId","keyId","teamId","bundleId","privateKey","environment"]},{"name":"remove_apns_credentials","description":"Remove APNs credentials. iOS devices stop receiving push until a key is saved again; registered devices are kept.","params":["companyId"]},{"name":"set_fcm_credentials","description":"Connect Android push by saving a Firebase service account key (the JSON file from Firebase project settings > Service accounts). Encrypted at rest and never returned.","params":["companyId","serviceAccount"]},{"name":"remove_fcm_credentials","description":"Remove Firebase credentials. Android devices stop receiving push until a key is uploaded again; registered devices are kept.","params":["companyId"]},{"name":"list_push_devices","description":"List registered push devices (browsers and app installs) in a stable order; pass nextCursor to page. Filter by contact (email or subscriberId), platform or status. Tokens are never returned in full.","params":["companyId","email","subscriberId","platform","status","limit","cursor"]},{"name":"register_push_device","description":"Register (or refresh) a push device for a contact, the way an app backend would after the app receives its token. Re-registering a token reactivates it and moves it to the given contact. Unknown emails become contacts quietly (no lists, no contact_added sequences).","params":["companyId","platform","token","keys","email","subscriberId","deviceName","appVersion","osVersion","locale","timezone","permissionStatus"]},{"name":"remove_push_device","description":"Unsubscribe a push device and unlink it from its contact so it stops receiving push. A browser or app that still allows notifications can register again (browsers come back unlinked).","params":["companyId","deviceId"]},{"name":"send_test_push","description":"Send a real test push to one device (deviceId) or to every active device of a contact (email or subscriberId). Provide title and/or body. Limited to 200 per company per rolling 24 hours; excluded from stats.","params":["companyId","deviceId","email","subscriberId","title","body","url","imageUrl","iconUrl","platforms"]},{"name":"list_push_campaigns","description":"List push campaigns, newest first.","params":["companyId","status","limit","offset"]},{"name":"get_push_campaign","description":"Get a push campaign's content, audience, status and (after sending) delivery stats.","params":["companyId","campaignId"]},{"name":"create_push_campaign","description":"Create a push campaign draft. Content and audience can be set now or later with update_push_campaign; send with send_push_campaign.","params":["companyId","name","title","body","url","imageUrl","iconUrl","platforms","localizations","targetLists"]},{"name":"update_push_campaign","description":"Update a draft or scheduled push campaign. Only the fields you pass change. A scheduled campaign keeps its schedule; timing fields can only change on drafts (reschedule with send_push_campaign instead).","params":["companyId","campaignId","name","title","body","url","imageUrl","iconUrl","platforms","localizations","targetLists","sendInRecipientTimezone","scheduledTimezone","sendTimeOptimization","sendTimeWindowHours"]},{"name":"estimate_push_campaign_recipients","description":"Count how many contacts in an audience have an active push device (eligibleCount) versus the whole audience (audienceCount).","params":["companyId","targetLists","platforms","includeTimingCoverage"]},{"name":"send_push_campaign","description":"Send a push campaign now, or schedule it with scheduledAt (future ISO 8601). Optionally deliver in each contact's local time (sendInRecipientTimezone + scheduledTimezone) or at each contact's optimal hour (sendTimeOptimization); omitted timing fields keep the draft's saved values. Delivers real notifications to every contact in the audience with an active device on a set-up platform. Confirm with the user before calling.","params":["companyId","campaignId","scheduledAt","sendInRecipientTimezone","scheduledTimezone","sendTimeOptimization","sendTimeWindowHours"]},{"name":"unschedule_push_campaign","description":"Move a scheduled push campaign back to draft.","params":["companyId","campaignId"]},{"name":"cancel_push_campaign","description":"Stop a scheduled or sending push campaign. Unsent notifications are skipped; delivered ones cannot be recalled.","params":["companyId","campaignId"]},{"name":"duplicate_push_campaign","description":"Copy a push campaign (content and audience) into a new draft.","params":["companyId","campaignId","name"]},{"name":"get_push_campaign_stats","description":"Get push campaign delivery stats: sent, displayed (device-reported), clicked, failed and skipped contacts, devices targeted/accepted, and skip/failure reasons.","params":["companyId","campaignId"]},{"name":"translate_push_campaign","description":"Translate a draft or scheduled push campaign's title and message with AI into the workspace's languages and save the versions. Contacts then get the version for their language attribute or device language. Versions a person wrote are kept unless overwrite is true. Returns the campaign plus translated, skipped and failed languages.","params":["companyId","campaignId","locales","overwrite"]},{"name":"translate_push_content","description":"Translate a push title and message with AI into the workspace's languages without saving anything. Use the returned localizations for a sequence push step (update_sequence_node changes.localizations, or localizations on a push step in create_sequence/insert_sequence_step) or a push campaign.","params":["companyId","title","body","localizations","locales","overwrite"]},{"name":"get_push_import_preflight","description":"Check push settings before importing devices: warns when APNs or Firebase is not set up, or APNs is on sandbox. Imported tokens only work with the same bundle ID, Apple team and Firebase project the app used with the previous provider. Show these warnings to the user before starting an import.","params":["companyId","source","platforms"]},{"name":"list_push_imports","description":"List recent push imports with status, progress and counts (imported, matched, unsubscribed, skipped, invalid, contacts created).","params":["companyId","limit"]},{"name":"get_push_import","description":"Get one push import: status (draft, queued, exporting, importing, completed, failed, canceled), progress, counts, skip/invalid reasons, warnings and whether it can be resumed. Poll this while it runs.","params":["companyId","importId"]},{"name":"create_push_import","description":"Create a draft push import and return its warnings; nothing is read until start_push_import. Requirements by source: onesignal needs apiKey (App API key) and onesignalAppId; braze needs apiKey (REST key with users.export.segment), brazeRestEndpoint and brazeSegmentId; customer_io needs apiKey (App API key), customerIoSegmentId and optionally customerIoRegion; csv takes the file as csv (token and platform columns, plus external_id or email; at most 5 MB, send more with add_push_import_rows and set csvParts to the total part count so a partial upload can never start). Opted-in devices are linked to contacts by external ID or email (unmatched devices get a new contact, quietly: no lists, no sequences; push-only with no email or phone when the device has only an external ID); opted-out devices are kept as unsubscribed.","params":["companyId","source","apiKey","onesignalAppId","brazeRestEndpoint","brazeSegmentId","customerIoRegion","customerIoSegmentId","platforms","importAttributes","appIds","csv","csvParts"]},{"name":"add_push_import_rows","description":"Add another part of a CSV file to a draft csv import (at most 5 MB per part; every part starts with the header row). Parts are imported in the order they are added.","params":["companyId","importId","csv"]},{"name":"start_push_import","description":"Start a draft push import, or resume a failed or stalled one from where it stopped. Runs in the background; poll get_push_import. One import runs per workspace at a time.","params":["companyId","importId"]},{"name":"cancel_push_import","description":"Stop a push import, or discard a draft or failed one. Devices already imported stay; staged rows and the stored source key are deleted. Cannot be undone.","params":["companyId","importId"]},{"name":"list_live_activities","description":"List iOS Live Activity and Android Live Update tokens (push-to-start tokens per device and activity type, update tokens per running activity) with a per-type summary of devices that can start activities and running activities. Each token has platform ios or android. Tokens are masked.","params":["companyId","email","subscriberId","platform","activityType","activityId","kind","status","limit","cursor"]},{"name":"start_live_activity","description":"Start a Live Activity remotely on the devices that registered a push-to-start token for activityType: iOS 17.2+ through APNs, and Android Live Updates through FCM on apps that observe the same type name with the Sequenzy Android SDK (promoted on Android 16, an ongoing notification before). Target one contact (email or subscriberId), or every contact in a segment, list or tag (exactly one of segmentId, listId, tag; up to 100,000 devices, needs campaigns:send), then update and end it with broadcast: true. Requires an alert. Returns tokenCount 0 without sending when no device can start it; contactCount and platforms count contacts and devices per platform. Repeating the call starts another copy.","params":["companyId","email","subscriberId","segmentId","listId","tag","activityType","activityId","attributes","contentState","alert","staleDate","relevanceScore"]},{"name":"update_live_activity","description":"Update every running copy of a contact's Live Activity (one per device, iOS and Android Live Updates) with new content state. Requires email or subscriberId, or broadcast: true to update every signed-in device running the activityId (for activities started for a segment, list or tag). Add an alert to light the screen. Returns tokenCount 0 when no running copy has reported an update token.","params":["companyId","email","subscriberId","broadcast","activityId","contentState","alert","priority","staleDate","relevanceScore"]},{"name":"end_live_activity","description":"End a contact's Live Activity on every device running it (iOS and Android Live Updates), with its final content state and optionally a dismissal date. Requires email or subscriberId, or broadcast: true to end it on every signed-in device running the activityId. Without dismissalDate iOS keeps it on the Lock Screen and Android in the shade for up to four hours.","params":["companyId","email","subscriberId","broadcast","activityId","contentState","alert","priority","dismissalDate","staleDate","relevanceScore"]},{"name":"list_in_app_messages","description":"List a contact's in-app messages and content cards (created by type \"in_app\" sequence steps). status \"open\" (default) is what their app should show now; \"all\" is history. Identify the contact by email, externalId or subscriberId.","params":["companyId","email","externalId","subscriberId","kind","status","formats","limit","actions"]},{"name":"record_in_app_event","description":"Record that the app displayed, clicked, dismissed or read an in-app item. Repeats change nothing except clickCount. Clicks, dismissals and reads also count as a display. Messages leave the open feed once displayed, clicked or dismissed; cards once dismissed.","params":["companyId","messageId","type","pushPermission","buttonId"]},{"name":"delete_in_app_message","description":"Delete an in-app message or card so the app stops showing it.","params":["companyId","messageId"]},{"name":"get_in_app_step_stats","description":"Created, displayed, clicked and dismissed counts for one in-app sequence step, plus how many contacts allowed (pushPermissionGranted) or declined (pushPermissionDenied) notifications from a push primer.","params":["companyId","stepId"]},{"name":"list_in_app_templates","description":"Starting points for in-app sequence steps (trial ending, welcome, new feature, milestone, a push primer that asks for notification permission, and more). Each has a complete step config: pass it as a type \"in_app\" step to create_sequence or insert_sequence_step after adding the urls its link buttons open.","params":["companyId"]},{"name":"validate_in_app_html","description":"Check a custom HTML in-app message document before using it as a format \"html\" in-app step. Returns its size against the 100 KB limit, Braze Liquid conversions (e.g. {{${email_address}}} becomes {{email}}, {{${braze_id}}} becomes {{contactId}}), script hosts a website CSP must allow, whether it closes itself, warnings and blocking errors. Nothing is saved.","params":["companyId","html"]},{"name":"write_in_app_copy","description":"Write in-app message copy with AI from a short brief: eyebrow, title, message and button labels sized for the layout. Returns text only; nothing is saved. Button links are never invented, so add urls before using the copy in a step.","params":["companyId","brief","kind","format","hasImage"]},{"name":"list_in_app_campaigns","description":"List in-app campaigns, newest first. Each has a stored status and a state: draft, scheduled, live, ended (past endsAt) or stopped.","params":["companyId","status","limit","offset"]},{"name":"get_in_app_campaign","description":"Get an in-app campaign's message, audience, priority, schedule, end time and state, plus reach and engagement stats once it has launched.","params":["companyId","campaignId"]},{"name":"create_in_app_campaign","description":"Create an in-app campaign draft: one in-app message or content card for an audience, shown inside the customer's app. Set the message and audience now or later with update_in_app_campaign; launch with send_in_app_campaign.","params":["companyId","name","message","priority","endsAt","targetLists"]},{"name":"update_in_app_campaign","description":"Update a draft or scheduled in-app campaign. Only the fields you pass change; message fields merge over the stored message. Live campaigns can't be edited: stop and duplicate them instead.","params":["companyId","campaignId","name","message","priority","endsAt","targetLists"]},{"name":"estimate_in_app_campaign_recipients","description":"Count contacts who match an audience now (audienceCount) and how many are known to have your app connected (appUserCount, a lower bound). Everyone in the audience gets the campaign the next time their app fetches the feed, including contacts who join while it is live. If appUserCount is 0, say Sequenzy hasn't seen their app connect yet; if in-app isn't set up, point to Settings > In-app.","params":["companyId","targetLists"]},{"name":"send_in_app_campaign","description":"Launch an in-app campaign now, or schedule it with scheduledAt (future ISO 8601). While live, every contact in the audience sees the message the next time their app fetches its feed. Confirm with the user before calling.","params":["companyId","campaignId","scheduledAt"]},{"name":"unschedule_in_app_campaign","description":"Move a scheduled in-app campaign back to draft.","params":["companyId","campaignId"]},{"name":"stop_in_app_campaign","description":"Stop a scheduled or live in-app campaign. Nobody new gets it and it leaves every feed that still has it, including seen cards; stats are kept. Stopping is final (duplicate to run it again); stopping again succeeds.","params":["companyId","campaignId"]},{"name":"duplicate_in_app_campaign","description":"Copy an in-app campaign (message, priority, audience and a future end time) into a new draft.","params":["companyId","campaignId","name"]},{"name":"get_in_app_campaign_stats","description":"Get in-app campaign results: delivered (contacts whose app received it), displayed, clicked, totalClicks, dismissed, push permission results for primer buttons, and first clicks per custom HTML button, plus the audience size at launch.","params":["companyId","campaignId"]},{"name":"list_in_app_placements","description":"List the workspace's in-app placements: named slots in the customer's app or website that show in-app content inline (key, name, description, size hints) with all-time counts (created, live, displayed, clicked, dismissed). Fill one from a sequence step with type \"in_app\", kind \"placement\" and placement set to its key.","params":["companyId"]},{"name":"get_in_app_placement","description":"Get one in-app placement by key, with its all-time counts: items created, live (open now), and contacts who displayed, clicked or dismissed their item.","params":["companyId","key"]},{"name":"create_in_app_placement","description":"Create an in-app placement: a slot in the customer's app that shows in-app content inline, such as a home screen hero. The key is what app code passes to the SDK and never changes. Up to 50 per workspace.","params":["companyId","key","name","description","width","height"]},{"name":"update_in_app_placement","description":"Rename an in-app placement or change its description or size hints. The key cannot change. Provide at least one field.","params":["companyId","key","name","description","width","height"]},{"name":"delete_in_app_placement","description":"Delete an in-app placement. Its slots collapse in the app on the next refresh, and in-app steps that target it skip contacts until a placement with the same key exists again. Items already created stay in contact history.","params":["companyId","key"]},{"name":"get_in_app_placement_content","description":"What each placement shows one contact now: for each key, the contact's highest-priority open placement item (ties: newest), or null when the slot collapses. Identify the contact by email, externalId or subscriberId. Reading marks nothing displayed.","params":["companyId","email","externalId","subscriberId","placements","actions"]},{"name":"list_tags","description":"List every tag defined in the company, with each tag's ID, normalized name and color. Use it to reuse existing tag names before tagging contacts, or to find a tagId.","params":["companyId"]},{"name":"create_tag","description":"Create a new tag definition. The name is normalized to lowercase with hyphens (e.g. 'VIP Customer' becomes 'vip-customer'). Color defaults to gray. Returns the created tag with its ID, normalized name and color. Creating a tag does not apply it to any contact.","params":["companyId","name","color"]},{"name":"update_tag","description":"Update a tag's color. System tags cannot be updated.","params":["companyId","tagId","color"]},{"name":"delete_tag","description":"Permanently delete a tag and remove it from all subscribers. This cannot be undone. System tags and tags used by sequences cannot be deleted.","params":["companyId","tagId"]},{"name":"list_lists","description":"List all subscriber lists. Each list includes subscriberCount (current members of any status) and activeSubscriberCount (current members with status=active). Members who unsubscribed from the list are not counted. Use these fields for list audience size instead of paging search_subscribers.","params":["companyId"]},{"name":"create_list","description":"Create a new subscriber list. Lists are public by default: public lists appear to subscribers in the email preference center, where they can join or leave them. Set isPrivate to keep the list internal.","params":["companyId","allowMemberUnsubscribe","name","description","isPrivate"]},{"name":"update_list","description":"Update a subscriber list's name, description, or privacy. Only the provided fields are changed. A public list's name is shown to subscribers in the email preference center, and making a list public lets subscribers join it there.","params":["companyId","listId","allowMemberUnsubscribe","name","description","isPrivate"]},{"name":"delete_list","description":"Permanently delete a subscriber list and remove all of its memberships. Subscribers themselves are kept. This cannot be undone.","params":["companyId","listId"]},{"name":"add_subscribers_to_list","description":"Bulk add subscribers to a subscriber list from an email array. Existing subscribers are added to the list without a per-subscriber update call; addresses not yet in the account are created as new subscribers, using optInMode for their consent. Returns the list plus added and skipped counts. Get listId from list_lists or create_list.","params":["companyId","listId","emails","duplicateStrategy","enrollInSequences","optInMode"]},{"name":"remove_subscribers_from_list","description":"Remove subscribers from a list by email address. Maximum 500 emails per call. Subscribers stay in the account; only the list membership is removed. Returns the removed count plus a notFound array of emails that did not match a subscriber.","params":["companyId","listId","emails"]},{"name":"list_segments","description":"List every saved segment in the company with its ID and name. Use the IDs with get_segment_count, search_subscribers segmentId, or campaign targeting.","params":["companyId"]},{"name":"create_segment","description":"Create a new segment from explicit filter rules. Use `filters` plus `filterJoinOperator` for flat legacy rules, or `root` for nested AND/OR groups such as `{ \"kind\": \"group\", \"joinOperator\": \"and\", \"children\": [{ \"kind\": \"filter\", \"field\": \"attribute\", \"operator\": \"gte\", \"value\": \"mrr:50\" }, { \"kind\": \"group\", \"joinOperator\": \"or\", \"children\": [{ \"kind\": \"filter\", \"field\": \"tag\", \"operator\": \"contains\", \"value\": \"vip\" }, { \"kind\": \"filter\", \"field\": \"event\", \"operator\": \"is_not\", \"value\": \"saas.purchase:30d\" }] }] }`. AND of two or more positive attribute filters on the same array path (e.g. `history_events[].eventvenue_id` and `history_events[].showing_date`) requires one array element to satisfy every condition — a 2010 visit at that venue plus an unrelated recent booking elsewhere does not match. Negative filters (`is_not`, `not_contains`, `is_empty`) are exempt: they assert no element matches and combine independently. Supports `event` and `segment` fields, Stripe product purchase/current/trial/date filters, and campaign- or delivery-policy-scoped engagement filters such as `emailOpened is marketing:all`.","params":["companyId","name","filterJoinOperator","filters","root"]},{"name":"update_segment","description":"Update a segment's name and/or filter rules. Use the same `filters` plus `filterJoinOperator` or nested `root` shapes as create_segment; providing `filters` or `root` replaces the segment's existing rules.","params":["companyId","segmentId","name","filterJoinOperator","filters","root"]},{"name":"delete_segment","description":"Permanently delete a segment. This cannot be undone. Subscribers are not affected. Deleting is never blocked when the segment is in use: the result lists `affectedSequences` (with how each uses it), `affectedCampaigns`, `affectedSegments` and `affectedAudienceSyncs`, which from then on treat every contact as not in the segment. Requires the segments:delete scope; segments:write is not enough.","params":["companyId","segmentId"]}],"toolsHash":"79832296e6fe0164a04b19a32b762f15e935bcb48ef2a61c1483e01c86dddc36","wrote":[],"callsAt":"2026-11-16T11:33:23.568Z","calls":[{"tool":"get_account","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: Sequenzy MCP error: Missing MCP API key\nDescription: The MCP server started without a Sequenzy API key, so it cannot authenticate any tool or resource request.\nHow to fix: If you do not have a Sequenz"},{"tool":"get_app_urls","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: Sequenzy MCP error: Missing MCP API key\nDescription: The MCP server started without a Sequenzy API key, so it cannot authenticate any tool or resource request.\nHow to fix: If you do not have a Sequenz"},{"tool":"get_shopify_automation_settings","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Sequenzy MCP error: Missing MCP API key\nDescription: The MCP server started without a Sequenzy API key, so it cannot authenticate any tool or resource request.\nHow to fix: If you do not have a Sequenz"},{"tool":"get_design_md","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: Sequenzy MCP error: Missing MCP API key\nDescription: The MCP server started without a Sequenzy API key, so it cannot authenticate any tool or resource request.\nHow to fix: If you do not have a Sequenz"},{"tool":"list_websites","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Sequenzy MCP error: Missing MCP API key\nDescription: The MCP server started without a Sequenzy API key, so it cannot authenticate any tool or resource request.\nHow to fix: If you do not have a Sequenz"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"very-long","tool":"get_account_health","quote":"3000 characters or more"}],"tools":200,"wrote":0,"callsTried":5,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@sequenzy/mcp","version":"0.0.255","ranAt":"2026-11-16T11:33:18.947Z","outcome":"started","tools":200,"contacts":0,"flags":1,"serious":0,"toolsHash":"79832296e6fe0164a04b19a32b762f15e935bcb48ef2a61c1483e01c86dddc36"},{"package":"@sequenzy/mcp","version":"0.0.254","ranAt":"2026-11-12T17:52:13.761Z","outcome":"started","tools":200,"contacts":0,"flags":1,"serious":0,"toolsHash":"79832296e6fe0164a04b19a32b762f15e935bcb48ef2a61c1483e01c86dddc36"}],"page":"https://bragproof.smaverk.com/r/%40sequenzy/mcp"}