​

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
• 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 installed AI clients
4. Configure them automatically

​

Manual Setup

​

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

​

Getting Your API Key

1. Go to Settings → API Keys
2. Click “Create Personal Key”
3. Give it a name (e.g., “Claude Desktop”)
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

​

Sequences

• list_sequences - List all sequences
• get_sequence - Get sequence details
• create_sequence - Create a sequence with:
  • goal - AI generates email content
  • steps with blocks - Sequenzy JSON block format
  • steps with html - Any HTML (React Email, MJML, etc.) - auto-converted
• update_sequence - Modify a sequence
• enable_sequence / disable_sequence - Control status

​

Transactional

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

​

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.

​

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.

​

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