MCP Server

Connect AI assistants to SuperSend via Model Context Protocol (MCP)

SuperSend MCP Server connects AI assistants (Cursor, Claude Desktop, VS Code, etc.) to SuperSend's API, enabling you to manage contacts, campaigns, senders, and more directly from your AI assistant.

ℹ️

Get Your API Key

Get your API key from Organization Admin Settings before configuring the MCP server.

Installation

Add to ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "supersend": {
      "url": "https://mcp.supersend.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-API-KEY"
      }
    }
  }
}

Replace YOUR-API-KEY with your SuperSend API key.

Available Tools

Health

Tool	Description
`get_health`	Check SuperSend API health and connectivity

Teams

Tool	Description
`list_teams`	List teams the user has access to
`get_team`	Get a team by ID

Contacts

Tool	Description
`list_contacts`	List contacts in a team (TeamId required)
`get_contact`	Get a contact by ID
`create_contact`	Create/upsert a contact (TeamId, CampaignId, email or linkedin_url required)
`update_contact`	Update a contact
`delete_contact`	Delete a contact (soft delete)
`bulk_import_contacts`	Bulk import contacts (JSON array)

Campaigns

Tool	Description
`list_campaigns`	List campaigns in a team. Filter by status: `active` or `inactive`
`get_campaign`	Get a campaign by ID
`activate_campaign`	Turn a campaign on (start sending)
`deactivate_campaign`	Turn a campaign off (pause sending)
`get_campaign_sequence`	Get campaign sequence (nodes and edges)
`update_campaign_sequence`	Update campaign sequence (nodes and/or edges)

Senders

Tool	Description
`list_senders`	List email senders
`get_sender`	Get a sender by ID
`update_sender`	Update a sender
`get_sender_bounce_insights`	AI bounce type breakdown per sender

Events

Tool	Description
`list_events`	List events (sends, opens, clicks, replies, bounces)
`get_event`	Get an event by ID

Conversations

Tool	Description
`list_conversations`	List conversations. Use `channel`: email or linkedin. Use `last_message_direction`: inbound (replies) or outbound (our sent)
`get_conversation`	Get a conversation by ID
`get_conversation_messages`	Get messages in a conversation
`send_conversation_message`	Send a message in a conversation

Labels

Tool	Description
`list_labels`	List conversation labels

Blacklist

Tool	Description
`list_blacklist`	List blacklisted emails/domains
`add_to_blacklist`	Add to blacklist
`remove_from_blacklist`	Remove from blacklist

Webhooks

Tool	Description
`list_webhooks`	List webhooks
`create_webhook`	Create a webhook

Domains & Deliverability

Tool	Description
`list_domains`	List managed domains
`get_domain`	Get a domain by ID
`purchase_domain`	Purchase domains (requires payment method, contact details)
`purchase_mailbox`	Purchase mailboxes for existing domains
`purchase_domains_and_mailboxes`	Purchase domains and mailboxes in one transaction
`list_placement_tests`	List placement tests
`get_domain_bounce_insights`	AI bounce breakdown per domain

Usage Examples

List Your Teams

List my SuperSend teams

The AI will use list_teams to fetch your teams and display them.

Check API Health

Check if my SuperSend API connection is healthy

The AI will use get_health to verify connectivity.

List Campaigns

List my active campaigns

The AI will first fetch your teams using list_teams, then use list_campaigns with status: "active" to show your running campaigns.

Add a Contact

Add john@example.com to my "Outreach Campaign" campaign as a contact

The AI will:

Use list_teams to get your teams

Use list_campaigns to find "Outreach Campaign"

Use create_contact with the email and campaign ID

View Campaign Sequence

Show me the sequence for my "Product Launch" campaign

The AI will use get_campaign_sequence to display the campaign's nodes (steps) and edges (connections).

List Contacts in a Team

List contacts in my "Sales Team" team

The AI will:

Use list_teams to find "Sales Team"

Use list_contacts with the team ID to show contacts

Check Sender Bounce Insights

Show me bounce insights for sender john@example.com

The AI will:

Use list_senders to find the sender

Use get_sender_bounce_insights to show AI-categorized bounce breakdown

List Conversations Needing Response

Show me email conversations that need a response

The AI will use list_conversations with channel: "email" and last_message_direction: "inbound" to show replies from contacts.

Send a Message in a Conversation

Reply to conversation [conversation-id] with "Thanks for your interest!"

The AI will use send_conversation_message to send your reply.

Tips

Team and Campaign IDs: If the AI asks for a Team ID or Campaign ID, ask it to "List my SuperSend teams first" — it will fetch the IDs and use them automatically.

Search by Name: Many tools support searching by name. For example, "List campaigns named 'Outreach'" will search for campaigns matching that name.

Bulk Operations: Use bulk_import_contacts to add multiple contacts at once instead of creating them one by one.

Campaign Status: Use activate_campaign and deactivate_campaign to start or pause campaigns programmatically.