​

MCP Integration

​

What You Can Do

• Manage subscribers - Add, update, search, and remove subscribers
• Create sequences - Generate and configure email automation sequences
• Draft campaigns - Create and edit campaign drafts
• Send transactional emails - Send single emails via template or HTML
• View analytics - Get stats for campaigns, sequences, and overall performance
• Inspect localization - Read company localization settings and localized template variants
• Generate content - AI-powered email and sequence generation

​

Quick Setup

npx @sequenzy/setup

1. Open your browser to log in
2. Create a personal API key
3. Auto-detect supported installed AI clients
4. Configure those clients automatically

​

Manual Setup

• Command: npx
• Args: -y @sequenzy/mcp
• Env: SEQUENZY_API_KEY=seq_user_your_key_here

​

Claude Desktop

1. Open Claude Desktop settings file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add Sequenzy MCP:

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

3. Restart Claude Desktop

​

Cursor

1. Open ~/.cursor/mcp.json (create if it doesn’t exist)
2. Add Sequenzy:

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

3. Restart Cursor

​

Windsurf

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

​

Claude Code

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

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

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

​

Codex

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

codex mcp list

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

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

​

Other MCP Clients

• Command: npx
• Args: -y @sequenzy/mcp
• Env: SEQUENZY_API_KEY=seq_user_your_key_here

​

Getting Your API Key

1. Go to the Sequenzy dashboard
2. Open Settings → API Keys
3. Click “Create Personal Key”
4. Copy the key (starts with seq_user_)

​

Available Tools

​

Subscribers

• add_subscriber - Add a new subscriber
• update_subscriber - Update subscriber attributes/tags
• remove_subscriber - Unsubscribe or delete
• get_subscriber - Get subscriber details
• search_subscribers - Search by tags, attributes, segments

​

Campaigns

• list_campaigns - List all campaigns
• get_campaign - Get campaign details and stats
• create_campaign - Create a draft campaign
• update_campaign - Edit a draft
• send_test_email - Send test to single address

​

Company

• get_company - Get company details plus effective localization settings

​

Sequences

• list_sequences - List all sequences
• get_sequence - Get sequence details plus sequence.emails, which includes each step’s nodeId, linked emailId, subject, preview text, and blocks
• create_sequence - Create a sequence with:
  • trigger: "segment_entered" plus segmentId for saved-segment entry automations
  • goal - AI generates email content
  • steps with blocks - Sequenzy JSON block format
  • steps with html - Any HTML (React Email, MJML, etc.) - auto-converted
  • For event_received sequences, step content can use {{event.amount}}, {{event.order.id}}, or other {{event.*}} merge tags from the event payload that enrolled the subscriber
• update_sequence - Modify a sequence, targeting a specific step with the emailId or nodeId returned by get_sequence
• enable_sequence / disable_sequence - Control status

​

Transactional

• send_email - Send a single email (template or HTML)

​

Segments

• list_segments - List saved segments
• create_segment - Create a segment from explicit filters, including Stripe product purchase filters
• get_segment_count - Preview how many active subscribers match a segment

• {"id":"filter-1","field":"stripeProduct","operator":"is","value":"prod_pro"} for “bought product”
• {"id":"filter-1","field":"stripeProduct","operator":"is_not","value":"prod_pro"} for “didn’t buy product”
• {"id":"filter-1","field":"stripeProduct","operator":"at_least","value":"prod_pro:3"} for “at least 3 payments”
• {"id":"filter-1","field":"stripeProduct","operator":"less_than_count","value":"prod_pro:3"} for “fewer than 3 payments”

​

Templates

• list_templates - List all email templates with localization status by locale
• get_template - Get a template’s details, content, and localized variants

​

Analytics

• get_stats - Overview stats (7d/30d/90d)
• get_campaign_stats - Campaign performance
• get_sequence_stats - Sequence performance
• get_subscriber_activity - Individual activity

​

AI Generation

• generate_email - Create email from prompt
• generate_sequence - Create multi-email sequence from goal
• generate_subject_lines - Generate A/B subject variants

​

Example Conversations

​

Set up email for a new SaaS

You: "Set up email sequences for my SaaS that has a 14-day trial"

Claude: I'll help set that up. First, let me check your current sequences...
[Uses list_sequences]

You don't have any sequences yet. I'll create three for you:
1. Welcome sequence (triggered on signup)
2. Trial nurture (days 1, 3, 7, 10, 13)
3. Trial ending reminder (day 12)

[Uses generate_sequence and create_sequence for each]

Done! I've created 3 sequences with 8 emails total.

​

Add a subscriber

You: "Add john@example.com as a VIP subscriber"

Claude: [Uses add_subscriber]
Added john@example.com with the VIP tag.

​

Create a Stripe product segment

You: "Create a segment for subscribers who bought Stripe product prod_pro at least 3 times"

Claude: [Uses create_segment with filters:
{"id":"filter-1","field":"stripeProduct","operator":"at_least","value":"prod_pro:3"}]
Done. I created the segment and saved it for future campaigns.

​

Check performance

You: "How did my last campaign perform?"

Claude: [Uses list_campaigns then get_campaign_stats]
Your "Product Launch" campaign sent yesterday had:
- 2,451 sent
- 67.2% open rate
- 12.3% click rate
That's above your average!

​

Create a sequence with specific content

You: "Create a 3-email welcome sequence with specific content.
Email 1 (immediate): Subject 'Welcome!' - 'Thanks for joining us.'
Email 2 (1 day later): Subject 'Getting Started' - 'Here's how to begin.'
Email 3 (3 days later): Subject 'Pro Tips' - 'Unlock advanced features.'"

Claude: [Uses create_sequence with steps]
Done! I've created the welcome sequence with 3 emails:
1. "Welcome!" - sends immediately
2. "Getting Started" - sends after 1 day
3. "Pro Tips" - sends after 3 days

The sequence is in draft mode. Would you like me to enable it?

​

Migrate a sequence from another platform

You: "I have these React Email templates for my onboarding sequence.
Can you create a sequence that sends them?"

[Pastes HTML content]

Claude: [Uses create_sequence with steps using html field]
Done! I've created your onboarding sequence with the HTML content
you provided. The HTML was automatically converted to Sequenzy's
block format so you can edit it in the visual editor later.

The sequence is ready in draft mode with 3 emails.

​

Event-Personalized Sequences

• Trigger payload: {"event":"weather.wind_alert","properties":{"city":"Tel Aviv","alert":{"maxSpeed":75}}}
• Sequence subject: Wind alert for {{event.city}}
• Sequence body: Winds may reach {{event.alert.maxSpeed}} km/h.

​

Resources

​

Security

• Personal API keys are tied to your user account
• Keys can only access companies you have access to
• You can revoke keys anytime in Settings → API Keys
• Keys are never shared between users

​

Troubleshooting

​

”SEQUENZY_API_KEY environment variable is required”

​

”Invalid API key”

​

Changes not appearing