Articles on: Integrations

Connect SuperSend MCP to Claude

Connect SuperSend MCP to Claude


Purpose


This article walks through connecting SuperSend's MCP (Model Context Protocol) server to Claude — both Claude Desktop (the macOS/Windows app) and Claude Code (the terminal CLI). Once connected, you can manage contacts, campaigns, senders, deliverability, and more by talking to Claude directly.


Prerequisites


  • A SuperSend account with at least one team.
  • A SuperSend API key (see How to get your API key below).
  • For Claude Desktop: Claude Desktop installed on your machine.
  • For Claude Code: Claude Code CLI installed and authenticated.
  • Node.js installed (required for Claude Desktop's mcp-remote bridge).


How to Get Your SuperSend API Key


Your organization already has an API key in SuperSend. You do not create or rotate it—it stays the same for your account. Copy it whenever you connect a new tool.


  1. Log in to SuperSend and go to Admin → System tab.
  2. In the IDs section, find the API Key field (next to Org ID).
  3. Click Copy to copy the key to your clipboard. Use it wherever the steps below say YOUR-API-KEY.


If you do not see Admin or the API Key field, you may need org admin access—ask a workspace admin.



Shortcut: Let Claude Set Itself Up


If you already have Claude open, you can skip the manual steps below. Claude can read SuperSend's setup docs and configure the connection for you.


  1. Open a conversation with Claude (Desktop or Code).
  2. Paste the following URL and prompt:


> Read the setup docs at https://docs.supersend.io/docs/mcp-server and configure the SuperSend MCP server for me.


Claude will fetch the page, follow the installation instructions for its platform, and guide you through any remaining steps — including where to paste your API key.


You'll still need your SuperSend API key ready (see How to Get Your SuperSend API Key above). The manual steps below are here if you prefer to do it yourself or need to troubleshoot.



Option A: Claude Desktop


Claude Desktop connects to remote MCP servers via the mcp-remote bridge package (installed automatically via npx).


Step 1: Open the Claude Desktop config file


Open the config file for your operating system in any text editor:


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


If the file doesn't exist yet, create it.


Step 2: Add the SuperSend MCP server


Paste the following into the config file, replacing YOUR-API-KEY with your SuperSend API key:


{
  "mcpServers": {
    "supersend": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.supersend.io/mcp",
        "--header",
        "Authorization: Bearer YOUR-API-KEY"
      ]
    }
  }
}


If you already have other MCP servers configured, add the "supersend" block inside the existing "mcpServers" object — don't replace the whole file.


Step 3: Restart Claude Desktop


Fully quit and relaunch Claude Desktop. On macOS, right-click the Dock icon and choose Quit before reopening.


Step 4: Verify the connection


In a new Claude conversation, type:


List my SuperSend teams


Claude will use the list_teams tool and return your teams. If you see your team names, the connection is working.



Option B: Claude Code (CLI)


Step 1: Run the setup command


In your terminal, run:


claude mcp add --transport http supersend https://mcp.supersend.io/mcp --header "Authorization: Bearer YOUR-API-KEY"


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


Step 2: Verify the connection


Start a Claude Code session and type:


List my SuperSend teams


Claude will call the list_teams tool and return your team list. If you see your teams, you're connected.



What You Can Do Once Connected


Here are some example prompts to get started:


  • List my SuperSend campaigns — see all active and inactive campaigns
  • Add john@example.com to my "Q4 Outreach" campaign — enroll a contact
  • Why is my reply rate so low? — runs a deliverability diagnosis
  • When will my campaigns finish? Do I have enough capacity? — capacity forecast
  • Which senders are at risk? — per-sender health and bounce analysis
  • Show me bounce insights for sender@example.com — AI bounce breakdown


If Claude asks for a Team ID or Campaign ID, just say "List my SuperSend teams first" and it will fetch the IDs automatically.



Expected Result


After completing setup, Claude has access to SuperSend tools covering contacts, campaigns, senders, conversations, deliverability intelligence, domain health, and more. The SuperSend tools appear in Claude's tool list and are called automatically when relevant.


Troubleshooting


  • Issue: Claude says it doesn't have access to SuperSend tools.

Fix: Confirm the config file is valid JSON (no trailing commas, no missing brackets) and that you fully quit and relaunched Claude Desktop. Use a JSON validator if unsure.


  • Issue: npx mcp-remote error or "command not found."

Fix: Confirm Node.js is installed (node --version in terminal). If Node is missing, install it from nodejs.org.


  • Issue: Authentication error or "Unauthorized" response.

Fix: Copy the key again from Admin → System → API Key → Copy. Ensure you pasted the full key with no extra spaces or line breaks in the config file or terminal command.


  • Issue: Config file changes aren't taking effect.

Fix: Make sure you fully quit Claude Desktop (not just closed the window) before relaunching. On macOS, use right-click → Quit from the Dock.


  • Issue: Claude Code says the MCP server is unreachable.

Fix: Confirm you have internet access and that https://mcp.supersend.io/mcp is reachable. Run curl https://mcp.supersend.io/health — it should return {"status":"ok"}.




Updated on: 07/04/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!