# SuperSend MCP

SuperSend MCP connects your AI assistant (Cursor, Claude, Windsurf) to SuperSend’s outreach and email platform. Manage contacts, campaigns, and senders; analyze deliverability, bounce rates, and plac…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add SuperSend/supersend

# Browse available tools
npx -y @smithery/cli@latest tool list SuperSend/supersend

# Get full schema for a tool
npx -y @smithery/cli@latest tool get SuperSend/supersend get_health

# Call a tool
npx -y @smithery/cli@latest tool call SuperSend/supersend get_health '{}'
```

## Direct MCP Connection

Endpoint: `https://supersend--supersend.run.tools`

## Tools (48)

- `get_health` — Check SuperSend API health and connectivity
- `list_teams` — List teams the user has access to
- `get_team` — Get a single team by ID
- `analyze_capacity_and_schedule` — Get capacity planning and campaign completion forecasts for a team. Returns when campaigns will finish, allocated capac…
- `diagnose_deliverability` — Get deliverability diagnosis for a team. Use when the user asks about reply rate, bounce rate, why campaigns underperfo…
- `analyze_sender_health` — Get sender health for a team. Use when the user asks which senders are at risk, sender bounce rates, or sender performa…
- `get_outbound_summary` — Get outbound summary for a team. Use when the user asks how their outreach is performing, overall send/reply stats, or …
- `analyze_domain_health` — Get domain health for a team. Use when the user asks which domains have DNS issues, SPF/DKIM/DMARC problems, or deliver…
- `list_contacts` — List contacts in a team. Run list_teams first to get TeamId, then pass the team id (UUID) here.
- `get_contact` — Get a single contact by ID
- `create_contact` — Create or update a contact (upsert by email). Requires TeamId, CampaignId, and at least one of email, linkedin_url, or …
- `update_contact` — Update a contact. Only provided fields are updated.
- `delete_contact` — Delete a contact by ID (soft delete)
- `create_campaign` — Create a new campaign in a team. Run list_teams first to get TeamId. Campaign starts inactive/draft. Creates ContactCon…
- `list_campaigns` — List campaigns in a team. Run list_teams first to get TeamId. Use status to filter: "active" (1) or "inactive" (2).
- `get_campaign` — Get a single campaign by ID
- `activate_campaign` — Activate a campaign (turn it on). Campaign will start sending. Requires campaign to have a sequence. Get campaign ID fr…
- `deactivate_campaign` — Deactivate a campaign (turn it off / pause). Campaign will stop sending. Get campaign ID from list_campaigns.
- `get_campaign_sequence` — Get the campaign sequence (nodes and edges) for a campaign. Nodes are steps like start, email, wait, if, switch; edges …
- `update_campaign_sequence` — Update campaign sequence nodes and/or edges. Pass nodes array (steps: startNode, emailNode, waitNode, ifNode, etc.) and…
- `list_campaign_categories` — List campaign categories (folders) for a team. Categories organize campaigns. Run list_teams first to get teamId.
- `create_campaign_category` — Create a campaign category (folder) for organizing campaigns. Run list_teams first to get TeamId. Category names must b…
- `update_campaign_category` — Rename a campaign category. Get category ID from list_campaign_categories.
- `delete_campaign_category` — Delete a campaign category. Campaigns in this category become uncategorized. Get category ID from list_campaign_categor…
- `list_senders` — List email senders. Optionally filter by team (get TeamId from list_teams).
- `get_sender` — Get a sender by ID
- `update_sender` — Update a sender. Pass only fields to change (disabled, max_per_day, signature, etc.).
- `list_events` — List events (sends, opens, clicks, replies, bounces). Get TeamId from list_teams.
- `get_event` — Get a single event by ID
- `list_conversations` — List conversations from email inbox or LinkedIn inbox. Use channel to pick inbox: "email" or "linkedin". Use last_messa…
- `get_conversation` — Get a conversation by ID
- `get_conversation_messages` — Get messages in a conversation
- `send_conversation_message` — Send a message in a conversation. For email, include sender_id and subject.
- `bulk_import_contacts` — Bulk import contacts. Requires TeamId and CampaignId (from list_teams, list_campaigns). Each contact needs at least one…
- `list_labels` — List conversation labels. Requires team_id from list_teams.
- `list_blacklist` — List blacklisted emails, domains, or LinkedIn URLs.
- `add_to_blacklist` — Add email, domain, or LinkedIn URL to blacklist.
- `remove_from_blacklist` — Remove an item from the blacklist by ID
- `list_webhooks` — List webhooks. Requires team_id from list_teams.
- `create_webhook` — Create a webhook. Requires team_id from list_teams.
- `list_domains` — List managed domains.
- `get_domain` — Get a domain by ID with health and sender info
- `purchase_domain` — ⚠️ CHARGES REAL MONEY. Always confirm with the user before calling. Only proceed when they explicitly say "yes, purchas…
- `purchase_mailbox` — ⚠️ CHARGES REAL MONEY. Always confirm with the user before calling. Only proceed when they explicitly say "yes, purchas…
- `purchase_domains_and_mailboxes` — ⚠️ CHARGES REAL MONEY. Always confirm with the user before calling. Only proceed when they explicitly say "yes, purchas…
- `list_placement_tests` — List placement tests (deliverability tests).
- `get_sender_bounce_insights` — Get AI-categorized bounce breakdown for a sender (invalid_email, seg_block, reputation_block, etc.). Get sender ID from…
- `get_domain_bounce_insights` — Get AI-categorized bounce breakdown for a domain. Requires V2 domain bounce-insights endpoint.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get SuperSend/supersend <tool-name>
```

## Prompts (6)

- `diagnose_deliverability` — Get deliverability diagnosis: reply rate, bounce rate, placement test results, and recommendations.
- `analyze_capacity` — Get capacity planning and when campaigns will finish.
- `check_inbox_replies` — List conversations with replies needing response (inbound messages).
- `team_overview` — Get a comprehensive overview: teams, campaigns, outbound summary, and deliverability.
- `sender_health_check` — Identify senders at risk (high bounce rate, underperforming).
- `domain_health_check` — Identify domains with DNS (SPF/DKIM/DMARC) or deliverability issues.
