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)
- Log in to your MachFive account at app.machfive.io
- Go to Settings → API Keys
- Click Create API Key
- 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)
- Open the Claude Desktop app
- Go to Settings → Connectors
- Click Add custom connector
- Enter:
- Name: MachFive
- Remote MCP server URL:
https://mcp.machfive.io/mcp/YOUR_API_KEY
- Replace
YOUR_API_KEYwith the API key you created - Click Add — no restart needed!
Option B: Claude Desktop (Config File)
If you prefer editing the config file directly:
- Go to Settings → Developer → Edit Config
- Add this to your config file (replace
YOUR_API_KEY):
{
"mcpServers": {
"machfive": {
"url": "https://mcp.machfive.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
- Save and restart Claude Desktop
Option C: Cursor
- Open Cursor → Settings (⌘ + ,)
- Search for MCP
- Click Edit in settings.json
- Add the following (replace
YOUR_API_KEY):
{
"mcpServers": {
"machfive": {
"url": "https://mcp.machfive.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
- Save and restart Cursor
Option D: n8n (AI Agents & Workflows)
For automating workflows with AI agents in n8n:
- Add the MCP Client node to your workflow
- Select Streamable HTTP as the transport option
- Enter the URL:
https://mcp.machfive.io/mcp/YOUR_API_KEY - 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
{"mcpServers": {"machfive": {"url": "https://mcp.machfive.io/mcp", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}}