Skip to main content

Saleshandy MCP (Model Context Protocol)

The complete guide on how to use the Saleshandy MCP to create sequences directly through LLMs.

Yashal Vagadia avatar
Written by Yashal Vagadia
Updated this week

What is Saleshandy MCP Server?

MCP (Model Context Protocol) is an open protocol that enables AI assistants like Claude to interact directly with external applications. It bridges the gap between conversational AI and your business tools.

The Saleshandy MCP Server connects your AI assistant to your Saleshandy workspace. This means you can manage your entire cold email outreach operation through natural conversation — from building sequences to analyzing deliverability metrics.

Here's what becomes possible:

  • "Set up a 7-day follow-up sequence for my product launch targeting CTOs"

  • "Which of my sequences crossed 10% reply rate last month?"

  • "Import my webinar attendees (prospects) into the nurture sequence"

  • "Show me sender accounts with deliverability issues"

  • "What's my team's total send volume this week?"

No more tab-switching or manual exports. Your AI handles the execution while you focus on strategy.

Getting Started

Step 1: Generate Your API Key

  1. Sign in at my.saleshandy.com

  2. Navigate to Settings → API Key

  3. Click Create API Key

  4. Add a descriptive label (e.g., "Claude-Integration" or "MCP-Production")

  5. Copy and securely store your key

⚠️ Security Note: Your API key is displayed only once. Treat it like a password — anyone with this key can access your Saleshandy data.

Need help? See the complete walkthrough: Generating Your Saleshandy API Key

Step 2: Configure Your AI Client

Option A: Claude Desktop — Quick Setup

  1. Launch Claude Desktop

  2. Open Settings → Connectors

  3. Select Add custom connector

  4. Fill in the details:

  5. Click Add — you're ready to go

Option B: Claude Desktop — Manual Configuration

For users who prefer direct config file editing:

  1. Open Settings → Developer → Edit Config

  2. Insert this configuration block:

{
  "mcpServers": {
    "saleshandy": {
      "transport": "https",
      "url": "https://mcp.saleshandy.com/mcp/YOUR_API_KEY"
    }
  }
}

  1. Replace YOUR_API_KEY with your actual key

  2. Save the file and restart Claude Desktop

Option C: Cursor IDE

  1. Open Cursor → Settings (⌘/Ctrl + ,)

  2. Search for MCP in settings

  3. Click Edit in settings.json

  4. Add:

{
  "mcpServers": {
    "saleshandy": {
      "transport": "https",
      "url": "https://mcp.saleshandy.com/mcp/YOUR_API_KEY"
    }
  }
}

  1. Replace YOUR_API_KEY with your actual key

  2. Save and restart Cursor

Option D: n8n Workflow Automation

Building AI-powered workflows? Here's how to connect:

  1. Add an MCP Client node to your canvas

  2. Set transport to Streamable HTTP

  3. Enter the URL: https://mcp.saleshandy.com/mcp/YOUR_API_KEY

  4. Connect to your AI agent node

Workflow ideas: Auto-pause sequences when bounce rates spike, generate weekly performance digests, sync CRM updates to prospect lists.

Option E: VS Code with MCP Extension

  1. Install an MCP-compatible extension from VS Code marketplace

  2. Open Settings (⌘/Ctrl + ,) → search for MCP

  3. Click Edit in settings.json

  4. Add this configuration:

{
  "mcpServers": {
    "saleshandy": {
      "transport": "https",
      "url": "https://mcp.saleshandy.com/mcp/YOUR_API_KEY"
    }
  }
}

  1. Replace YOUR_API_KEY with your actual key

  2. Save and reload VS Code

Alternative using mcp-remote (for stdio-based extensions):

{
  "mcp.servers": {
    "saleshandy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.saleshandy.com/mcp/YOUR_API_KEY",
        "-H",
        "api-key: YOUR_API_KEY"
      ]
    }
  }
}

Option F: Antigravity IDE

  1. Open Antigravity → Settings → MCP Servers

  2. Click Add Server or edit the config file directly

  3. Add this configuration:

{
  "mcpServers": {
    "saleshandy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.saleshandy.com/mcp/YOUR_API_KEY",
        "-H",
        "api-key: YOUR_API_KEY"
      ],
      "env": {}
    }
  }
}

  1. Replace both instances of YOUR_API_KEY with your actual API key

  2. Save and restart Antigravity

Note: This uses mcp-remote to bridge the HTTP-based MCP server. Make sure you have Node.js installed.

Option G: Any MCP-Compatible Client

Standard configuration (works with most clients):

{
  "mcpServers": {
    "saleshandy": {
      "transport": "https",
      "url": "https://mcp.saleshandy.com/mcp/YOUR_API_KEY"
    }
  }
}

Parameter

Value

Endpoint

https://mcp.saleshandy.com/mcp/YOUR_API_KEY

Transport

Streamable HTTP / HTTPS

For clients using stdio transport (via mcp-remote):

{
  "mcpServers": {
    "saleshandy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.saleshandy.com/mcp/YOUR_API_KEY",
        "-H",
        "api-key: YOUR_API_KEY"
      ],
      "env": {}
    }
  }
}

💡 Tip: Use mcp-remote when your client doesn't natively support HTTP-based MCP servers. Requires Node.js.

Step 3: Verify Your Connection

Test with a simple prompt:

"List my active sequences in Saleshandy"

See your sequences? You're connected. ✓

What You Can Control

📬 Sequences & Campaigns

  • Build multi-step sequences with custom intervals

  • Activate, pause, or archive sequences

  • Clone high-performers for A/B testing

  • Adjust sending windows and daily limits

👤 Prospect Management

  • Bulk import from CSV or direct entry

  • Tag and segment prospects

  • Transfer between sequences

  • Remove bounced or unsubscribed contacts

📈 Analytics & Insights

  • Track opens, clicks, replies, bounces

  • Compare sequence performance side-by-side

  • Identify top-performing subject lines

  • Monitor sender reputation scores

✉️ Email Accounts

  • View connected sender accounts

  • Check warmup progress and health scores

  • Rotate sending accounts

  • Troubleshoot deliverability flags

Real-World Usage Examples

Weekly Pipeline Review

You: "Break down my outreach performance for the past 7 days"

AI: "Here's your weekly snapshot:

Emails Sent: 3,847

Delivered: 3,691 (95.9%)

Opened: 1,476 (40%)

Replied: 289 (7.8%)

Bounced: 156 (4.1%)

Top Sequence: 'Series A Founders' — 12.3% reply rate

Needs Attention: 'Enterprise Q4' — 31% open rate (below your 45% average)

3 sender accounts flagged for warmup — want details?"

Building a New Sequence

You: "Create a sequence called 'Product Hunt Launch' with 5 touchpoints over 14 days"

AI: "Created 'Product Hunt Launch':

• Step 1: Day 0 (Initial outreach)

• Step 2: Day 3 (Value-add follow-up)

• Step 3: Day 6 (Social proof)

• Step 4: Day 10 (Final value)

• Step 5: Day 14 (Breakup email)

Status: Draft

Sending window: Your default (Mon-Fri, 9 AM - 6 PM)

Ready to add email templates or import prospects?"

Troubleshooting Deliverability

You: "Any sender accounts showing warning signs?"

AI: "Found 2 accounts that need attention:

1. [email protected]

• Warmup score: 67 (was 84 last week)

• Bounce rate: 8.2% (threshold: 5%)

• Recommendation: Pause outreach, continue warmup only

2. [email protected]

• Daily limit reached 3 days in a row

• Reply rate dropped to 2.1%

• Recommendation: Reduce daily volume by 30%

Want me to pause these accounts?"

Quick Prospect Addition

You: "Add these to my 'Inbound Demo Requests' sequence:

- [email protected] (CTO)

- [email protected] (Head of Sales)

- [email protected] (Founder)"

AI: "Added 3 prospects to 'Inbound Demo Requests':

✓ [email protected] — scheduled for Step 1 tomorrow 9:15 AM

✓ [email protected] — scheduled for Step 1 tomorrow 9:47 AM

✓ [email protected] — scheduled for Step 1 tomorrow 10:22 AM

All prospects verified and queued.

Performance Optimization

You: "Which sequences should I consider pausing based on engagement?"

AI: "Based on your benchmarks, these 3 sequences are underperforming:

1. 'Cold List - Manufacturing'

• Reply rate: 1.2% (your avg: 6.5%)

• 847 prospects remaining

• Running for 23 days

2. 'Old Database Re-engagement'

• Reply rate: 0.8%

• Bounce rate: 12% (critical)

• Running for 31 days

3. 'LinkedIn Event Follow-up'

• Reply rate: 2.1%

• Open rate: 22% (your avg: 44%)

• Running for 12 days

Recommend pausing all three. Want me to proceed?"

Troubleshooting Guide

Issue

Cause

Fix

Connection refused

Incorrect endpoint URL

Verify URL is exactly https://mcp.saleshandy.com/mcp

Authentication failed

Invalid or expired API key

Generate a fresh key in Settings → API Key

Request timeout

Network issues

Check your internet; retry in 30 seconds

Permission denied

API key lacks required scope

Ensure your Saleshandy plan includes API access

Empty response

No data matches query

Rephrase your request or check if data exists

Helpful Resources

Frequently Asked Questions

Do I need technical skills to set this up?

Not at all. If you can copy and paste, you can configure this in under 5 minutes.

Which AI tools support MCP?

Claude Desktop, Claude.ai, Cursor, VS Code (with MCP extension), Antigravity, Windsurf, n8n, ChatGPT, and any platform supporting HTTP-based MCP transport.

Is my data secure?

Absolutely. All communication uses HTTPS encryption. Your API key controls access; you can revoke it at any time from your Saleshandy settings.

What actions can the AI perform?

Anything available through the Saleshandy API: sequence management, prospect operations, analytics retrieval, account monitoring, and more.

Does this cost extra?

No additional charge. MCP access is included with Saleshandy plans that have API access and you also get to use it during the free trial window of seven days.

Can I restrict what the AI can do?

Yes. You can manage permissions through your API key settings and Claude's connector controls.

What happens if I make a mistake?

Most operations are reversible. For destructive actions (such as deletions), your AI will prompt for confirmation before proceeding (example: delete a sequence).

Can multiple team members use this?

Each team member should generate their own API key to maintain proper audit trails and access control.

Related Articles
Getting Started With Saleshandy - Sequence/Campaign Setup
Automate Adding Prospects from Google Sheets to Saleshandy via API
How to Import Prospect Click/Open/Email Sent Data into Google Sheets and Add a Follow-up Sequence for Engaged Prospects
How to Integrate Pitchlane with Saleshandy Using Zapier
Did this answer your question?