Saleshandy MCP (Model Context Protocol)

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

Saleshandy MCP uses OAuth for authentication — no API key needed for most clients. Simply connect using the MCP endpoint URL and you'll be prompted to sign in to your Saleshandy account.

MCP Endpoint: https://mcp.saleshandy.com/mcp

Need API key authentication? If you're building a custom integration or using a client that doesn't support OAuth, see Connecting with an API Key below.

---

Step 1: 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:
   • Name: Saleshandy
   • Remote MCP server URL: https://mcp.saleshandy.com/mcp
5. Click Add
6. You'll be redirected to sign in to your Saleshandy account — authorize the connection and 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"
    }
  }
}

3. Save the file and restart Claude Desktop
4. On first use, you'll be prompted to authenticate via OAuth — sign in with your Saleshandy account

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"
    }
  }
}

5. Save and restart Cursor
6. Authenticate via OAuth when prompted

Option D: 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"
    }
  }
}

5. Save and reload VS Code
6. Authenticate via OAuth when prompted

Option E: Any MCP-Compatible Client

Standard configuration (works with most clients):

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

Parameter	Value
Endpoint	https://mcp.saleshandy.com/mcp
Transport	Streamable HTTP / HTTPS
Authentication	OAuth (sign in when prompted)

---

Step 2: Verify Your Connection

Test with a simple prompt:

"List my active sequences in Saleshandy"

See your sequences? You're connected. ✓

---

Connecting with an API Key

If you're using a client that doesn't support OAuth — such as n8n, Antigravity, or any stdio-based client via mcp-remote — you can authenticate using an API key instead.

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., "n8n-Integration" or "MCP-Custom")
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

Client Configurations

n8n Workflow Automation

1. Add an MCP Client node to your canvas
2. Set transport to Streamable HTTP
3. Enter the URL: https://mcp.saleshandy.com/mcp
4. Add api-key: YOUR_API_KEY as a request header
5. 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.

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",
        "--header",
        "api-key: YOUR_API_KEY"
      ],
      "env": {}
    }
  }
}

4. Replace YOUR_API_KEY with your actual API key
5. Save and restart Antigravity

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

Any stdio-based Client (via mcp-remote)

For clients that use stdio transport and don't support OAuth:

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

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

---

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	OAuth not completed or API key invalid	Re-authenticate via OAuth, or generate a fresh API key in Settings → API Key
Request timeout	Network issues	Check your internet; retry in 30 seconds
Permission denied	Account 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

• MCP Endpoint: https://mcp.saleshandy.com/mcp
• API Reference: open-api.saleshandy.com/api-doc
• Help Center: docs.saleshandy.com
• Support: [email protected]
• MCP Protocol Spec: modelcontextprotocol.io

---

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.

Do I need an API key?

For most clients (Claude Desktop, Cursor, VS Code), no — authentication is handled automatically via OAuth when you connect. An API key is only required for custom integrations or clients that don't support OAuth, such as n8n or stdio-based setups using mcp-remote.

Is my data secure?

Absolutely. All communication uses HTTPS encryption. OAuth tokens are scoped to your session, and API keys (if used) can be revoked 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 Claude's connector controls and your Saleshandy account settings.

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?

Yes. Each team member connects their own account via OAuth, maintaining proper audit trails and access control. If using API keys, each team member should generate their own.