Name: Sequenzy Mcp
Author: Sequenzy

Sequenzy MCP Server

Official MCP server for Sequenzy, the AI-powered email marketing platform.

Connect Sequenzy to Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw, and other MCP clients so your AI assistant can manage email operations with structured tools instead of hand-written API calls.

What You Can Do

Manage subscribers, tags, lists, and dynamic segments.
Sync segments to Meta custom audiences for Facebook and Instagram retargeting.
Manage products and attach digital delivery files for purchase automations.
Draft, update, schedule, and inspect campaigns.
Create and edit email sequences, including event-triggered and segment-entry automations.
Cancel, pause, resume, duplicate, or delete campaigns and enroll contacts into sequences.
Manage transactional email templates and send single transactional emails.
Create, edit, publish, unpublish, and delete landing pages.
Connect and verify custom domains for published landing pages.
Manage team invitations, inbox conversations, and outbound webhook endpoints.
Generate email copy, subject lines, and multi-step sequences.
Inspect analytics, subscriber activity, deliverability health, and dashboard URLs.
Configure company product info, sender websites, and integration examples for common frameworks.

Every published MCP tool includes explicit readOnlyHint, destructiveHint, and openWorldHint annotations so compatible clients can display accurate tool-use affordances. Tools also publish outputSchema definitions and return structuredContent, giving clients and models machine-readable result shapes for follow-up calls.

Quick Setup

The easiest setup path is the Sequenzy wizard:

npx @sequenzy/setup

The wizard opens the browser login flow, creates a personal API key, detects supported AI clients, and configures them automatically when possible.

Hosted Remote MCP

For clients that support Streamable HTTP MCP, use Sequenzy's hosted endpoint instead of running a local stdio process:

https://api.sequenzy.com/v1/mcp

Remote clients should authenticate with the Sequenzy OAuth flow when supported. Local and automation clients can still use the stdio package below with SEQUENZY_API_KEY.

Machine-readable discovery files:

MCP server manifest: server.json
Agent card: .well-known/agent-card.json
Agent capability manifest: agent-capability.json
OpenClaw skill metadata: openclaw/skill.json

Manual Setup

All stdio MCP clients use the same command:

Command: npx
Args: -y @sequenzy/mcp
Required env: SEQUENZY_API_KEY=seq_user_your_key_here

Optional environment variables:

SEQUENZY_API_URL - Sequenzy API base URL. Defaults to https://api.sequenzy.com.
SEQUENZY_APP_URL - Sequenzy dashboard base URL used by app URL helpers. Defaults to https://sequenzy.com.

Claude Desktop

Add this to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Restart Claude Desktop after editing the config.

Claude Code

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- npx -y @sequenzy/mcp

On native Windows, wrap npx with cmd /c:

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- cmd /c npx -y @sequenzy/mcp

For a shared project config, use .mcp.json:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Codex

codex mcp add sequenzy --env SEQUENZY_API_KEY=seq_user_your_key_here -- npx -y @sequenzy/mcp
codex mcp list

Manual Codex config in ~/.codex/config.toml:

[mcp_servers.sequenzy]
command = "npx"
args = ["-y", "@sequenzy/mcp"]

[mcp_servers.sequenzy.env]
SEQUENZY_API_KEY = "seq_user_your_key_here"

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Windsurf

Use the same JSON shape as Cursor.

macOS: ~/Library/Application Support/Windsurf/mcp.json
Windows: %APPDATA%\Windsurf\mcp.json

VS Code Copilot

VS Code uses a servers object:

{
  "servers": {
    "sequenzy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Other MCP Clients

For OpenClaw, Hermes, and other MCP-compatible clients, point the client at npx -y @sequenzy/mcp and set SEQUENZY_API_KEY.

Getting an API Key

Open the Sequenzy dashboard.
Go to Settings -> API Keys.
Create a personal key.
Add the key to your MCP client config.

Personal keys start with seq_user_. You can revoke them any time in the dashboard.

Tools

This server currently exposes 120 MCP tools.

Account, Companies, Setup

Tool	Description
`get_account`	Get account info, available companies, and the current company.
`select_company`	Set the active company for future tool calls.
`get_app_urls`	Build dashboard URLs for campaigns, landing pages, sequences, emails, settings, domains, and sent email details.
`create_company`	Create a new company or brand.
`get_company`	Read company details, product info, brand colors, AI writing context, and localization settings.
`update_company`	Edit product info and brand context AI uses for generated emails.
`create_api_key`	Create an API key for a company.
`list_websites`	List configured sender websites and domains.
`add_website`	Add a sender website. Processing can take around 30 seconds.
`check_website`	Check whether a website is processed and ready.
`get_integration_guide`	Get framework-specific integration examples.

Subscribers

Tool	Description
`add_subscriber`	Add a subscriber with attributes, tags, status, opt-in mode, and optional list IDs.
`update_subscriber`	Update attributes, add tags, or remove tags.
`remove_subscriber`	Unsubscribe a subscriber or hard-delete them.
`get_subscriber`	Fetch subscriber details by email or external ID.
`search_subscribers`	Search by query, tags, list, status, segment, or pagination.

Products & Digital Delivery

Tool	Description
`list_products`	List synced products from Stripe, Shopify, WooCommerce, manual, or Commerce API data.
`upsert_products`	Create or update up to 100 Commerce API products keyed by your product ID.
`delete_product`	Delete a product previously pushed through the Commerce API.
`attach_product_file`	Attach a hosted or locally uploaded delivery file to a product.
`remove_product_file`	Remove an attached product delivery file.
`sync_products`	Queue a Stripe product catalog sync.

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

Lists, Tags, Segments

Tool	Description
`list_tags`	List all tags.
`create_tag`	Create a tag definition with an optional color.
`update_tag`	Update a tag color.
`delete_tag`	Delete a tag and remove it from subscribers.
`list_lists`	List subscriber lists.
`create_list`	Create a subscriber list.
`update_list`	Rename or describe a subscriber list.
`delete_list`	Delete a subscriber list.
`add_subscribers_to_list`	Add up to 500 subscribers to a list from an email array.
`remove_subscribers_from_list`	Remove up to 500 subscribers from a list.
`list_segments`	List saved segments and counts.
`create_segment`	Create saved segments from filters or nested AND/OR groups.
`update_segment`	Update segment name, filters, root group, or join operator.
`delete_segment`	Delete a saved segment.
`get_segment_count`	Preview the active subscriber count for a segment.

For subscriber exports, search_subscribers accepts listId, exact listName, or list (ID first, then exact name). If limit is omitted, the tool fetches all matching subscribers using 100-row API pages.

For bulk list population, use add_subscribers_to_list; the backing API endpoint is POST /api/v1/lists/{listId}/subscribers with no /bulk suffix:

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

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

Segment filters support attributes, events, saved segment membership, engagement events, Stripe product purchase rules, and commerce product purchase rules. Us

…

Sequenzy Mcp

Installation

Configuration

How to use

README