MachFive Cold Email MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add --transport http -H "Authorization: Bearer YOUR_API_KEY" machfive-cold-email https://mcp.machfive.io/mcp
Required:YOUR_API_KEY
README.md

Generate hyper-personalized cold email sequences per lead via AI.

MachFive MCP Server

What is MachFive MCP Server?

MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude connect to external apps. Think of it as a universal translator between AI and software.

MachFive MCP Server is a connector that lets your AI assistants communicate directly with your MachFive account. Your AI can list campaigns, generate hyper-personalized cold email sequences, manage lead lists, and export results — all through natural conversation.

Instead of logging into MachFive, uploading CSVs, and waiting for results, you can simply tell your AI what you need:

  • "Generate a 3-email sequence for jane@acme.com using my SaaS Founders campaign"
  • "Show me my MachFive campaigns"
  • "Submit these 50 leads for batch processing"
  • "Check the status of my latest batch and export the results"

Your AI understands the request, connects to MachFive through MCP, and executes the action — all in seconds.


How to Set Up MachFive MCP

Step 1: Get Your API Key (2 min)

  1. Log in to your MachFive account at app.machfive.io
  2. Go to Settings → API Keys
  3. Click Create API Key
  4. Copy your key and store it securely

⚠️ Keep this key private — it's like a password to your MachFive account.


Step 2: Connect Your AI Client

Option A: Claude Desktop (Easiest)
  1. Open the Claude Desktop app
  2. Go to Settings → Connectors
  3. Click Add custom connector
  4. Enter:
    • Name: MachFive
    • Remote MCP server URL: https://mcp.machfive.io/mcp/YOUR_API_KEY
  5. Replace YOUR_API_KEY with the API key you created
  6. Click Add — no restart needed!
Option B: Claude Desktop (Config File)

If you prefer editing the config file directly:

  1. Go to Settings → Developer → Edit Config
  2. Add this to your config file (replace YOUR_API_KEY):
{
  "mcpServers": {
    "machfive": {
      "url": "https://mcp.machfive.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. Save and restart Claude Desktop
Option C: Cursor
  1. Open Cursor → Settings (⌘ + ,)
  2. Search for MCP
  3. Click Edit in settings.json
  4. Add the following (replace YOUR_API_KEY):
{
  "mcpServers": {
    "machfive": {
      "url": "https://mcp.machfive.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. Save and restart Cursor
Option D: n8n (AI Agents & Workflows)

For automating workflows with AI agents in n8n:

  1. Add the MCP Client node to your workflow
  2. Select Streamable HTTP as the transport option
  3. Enter the URL: https://mcp.machfive.io/mcp/YOUR_API_KEY
  4. Connect to your AI agent node
Option E: Other MCP Clients

For any MCP-compatible client, use the URL with your API key:

https://mcp.machfive.io/mcp/YOUR_API_KEY

This URL works with any client that supports Streamable HTTP transport.


Step 3: Test It! (30 sec)

Open your AI assistant and try:

"List my MachFive campaigns"

If you see your campaign list, you're connected! 🎉


Authentication

MachFive MCP supports three authentication methods:

Method Format Best For
URL path https://mcp.machfive.io/mcp/YOUR_API_KEY Clients without header support, n8n
Authorization header Authorization: Bearer YOUR_API_KEY Claude Desktop, Cursor
Authorization header (no prefix) Authorization: YOUR_API_KEY Simplified integrations

The Bearer prefix is optional for the Authorization header.


Available Tools

MachFive MCP provides 6 tools for cold email generation:

📋 Campaigns

Tool Description
list_campaigns List all campaigns in your workspace. Call this first — you need a campaign ID for generation.

✉️ Email Generation

Tool Description
generate_sequence Generate a personalized email sequence for one lead (synchronous, 3-10 min).
generate_batch Submit multiple leads for batch generation (async, returns immediately with a list ID).

📦 List Management

Tool Description
list_lists Browse lead lists and batch jobs.
get_list_status Poll a batch job's status until completed or failed.
export_list Download results as JSON or CSV when a batch is complete.

What Can You Do?

✉️ Email Generation

  • "Generate a cold email sequence for sarah@notion.so using my Gator 100 campaign"
  • "Write 5 personalized emails for John Smith, VP of Sales at Acme Corp"
  • "Generate emails for this lead with a focus on our ROI case study angle"

📦 Batc

Tools (6)

list_campaignsList all campaigns in your workspace.
generate_sequenceGenerate a personalized email sequence for one lead.
generate_batchSubmit multiple leads for batch generation.
list_listsBrowse lead lists and batch jobs.
get_list_statusPoll a batch job's status until completed or failed.
export_listDownload results as JSON or CSV when a batch is complete.

Environment Variables

YOUR_API_KEYrequiredThe API key generated from your MachFive account settings.

Configuration

claude_desktop_config.json
{"mcpServers": {"machfive": {"url": "https://mcp.machfive.io/mcp", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}}

Try it

List my MachFive campaigns
Generate a 3-email sequence for jane@acme.com using my SaaS Founders campaign
Submit these 50 leads for batch processing
Check the status of my latest batch and export the results

Frequently Asked Questions

What are the key features of MachFive Cold Email?

List and manage MachFive email campaigns. Generate hyper-personalized cold email sequences for individual leads. Submit batch processing jobs for large lead lists. Monitor batch job status in real-time. Export campaign results as JSON or CSV.

What can I use MachFive Cold Email for?

Automating personalized outreach for sales teams directly from an AI chat interface. Managing large-scale cold email campaigns without manual CSV uploads. Streamlining the workflow between lead list management and email sequence generation. Tracking the performance and status of email batch jobs via natural language queries.

How do I install MachFive Cold Email?

Install MachFive Cold Email by running: Edit settings.json to include the mcpServers configuration block.

What MCP clients work with MachFive Cold Email?

MachFive Cold Email works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep MachFive Cold Email docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare