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.