{
  "markdown": "# MachFive MCP Server\n\n[![MCP Badge](https://lobehub.com/badge/mcp/bluecraft-ai-machfive-mcp)](https://lobehub.com/mcp/bluecraft-ai-machfive-mcp)\n[![smithery badge](https://smithery.ai/badge/machfive-cold-email)](https://smithery.ai/server/machfive/cold-email)\n\n## What is MachFive MCP Server?\n\nMCP (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.\n\nMachFive 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.\n\nInstead of logging into MachFive, uploading CSVs, and waiting for results, you can simply tell your AI what you need:\n\n- \"Generate a 3-email sequence for jane@acme.com using my SaaS Founders campaign\"\n- \"Show me my MachFive campaigns\"\n- \"Submit these 50 leads for batch processing\"\n- \"Check the status of my latest batch and export the results\"\n\nYour AI understands the request, connects to MachFive through MCP, and executes the action — all in seconds.\n\n---\n\n## How to Set Up MachFive MCP\n\n### Step 1: Get Your API Key (2 min)\n\n1. Log in to your MachFive account at [app.machfive.io](https://app.machfive.io)\n2. Go to **Settings → API Keys**\n3. Click **Create API Key**\n4. Copy your key and store it securely\n\n> ⚠️ Keep this key private — it's like a password to your MachFive account.\n\n---\n\n### Step 2: Connect Your AI Client\n\n#### Option A: Claude Desktop (Easiest)\n\n1. Open the Claude Desktop app\n2. Go to **Settings → Connectors**\n3. Click **Add custom connector**\n4. Enter:\n   - **Name:** MachFive\n   - **Remote MCP server URL:** `https://mcp.machfive.io/mcp/YOUR_API_KEY`\n5. Replace `YOUR_API_KEY` with the API key you created\n6. Click **Add** — no restart needed!\n\n#### Option B: Claude Desktop (Config File)\n\nIf you prefer editing the config file directly:\n\n1. Go to **Settings → Developer → Edit Config**\n2. Add this to your config file (replace `YOUR_API_KEY`):\n\n```json\n{\n  \"mcpServers\": {\n    \"machfive\": {\n      \"url\": \"https://mcp.machfive.io/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n3. Save and restart Claude Desktop\n\n#### Option C: Cursor\n\n1. Open Cursor → **Settings** (⌘ + ,)\n2. Search for **MCP**\n3. Click **Edit in settings.json**\n4. Add the following (replace `YOUR_API_KEY`):\n\n```json\n{\n  \"mcpServers\": {\n    \"machfive\": {\n      \"url\": \"https://mcp.machfive.io/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n5. Save and restart Cursor\n\n#### Option D: n8n (AI Agents & Workflows)\n\nFor automating workflows with AI agents in n8n:\n\n1. Add the **MCP Client** node to your workflow\n2. Select **Streamable HTTP** as the transport option\n3. Enter the URL: `https://mcp.machfive.io/mcp/YOUR_API_KEY`\n4. Connect to your AI agent node\n\n#### Option E: Other MCP Clients\n\nFor any MCP-compatible client, use the URL with your API key:\n\n```\nhttps://mcp.machfive.io/mcp/YOUR_API_KEY\n```\n\nThis URL works with any client that supports Streamable HTTP transport.\n\n---\n\n### Step 3: Test It! (30 sec)\n\nOpen your AI assistant and try:\n\n> \"List my MachFive campaigns\"\n\nIf you see your campaign list, you're connected! 🎉\n\n---\n\n## Authentication\n\nMachFive MCP supports three authentication methods:\n\n| Method | Format | Best For |\n|--------|--------|----------|\n| **URL path** | `https://mcp.machfive.io/mcp/YOUR_API_KEY` | Clients without header support, n8n |\n| **Authorization header** | `Authorization: Bearer YOUR_API_KEY` | Claude Desktop, Cursor |\n| **Authorization header (no prefix)** | `Authorization: YOUR_API_KEY` | Simplified integrations |\n\nThe Bearer prefix is optional for the Authorization header.\n\n---\n\n## Available Tools\n\nMachFive MCP provides **6 tools** for cold email generation:\n\n### 📋 Campaigns\n\n| Tool | Description |\n|------|-------------|\n| `list_campaigns` | List all campaigns in your workspace. **Call this first** — you need a campaign ID for generation. |\n\n### ✉️ Email Generation\n\n| Tool | Description |\n|------|-------------|\n| `generate_sequence` | Generate a personalized email sequence for **one lead** (synchronous, 3-10 min). |\n| `generate_batch` | Submit **multiple leads** for batch generation (async, returns immediately with a list ID). |\n\n### 📦 List Management\n\n| Tool | Description |\n|------|-------------|\n| `list_lists` | Browse lead lists and batch jobs. |\n| `get_list_status` | Poll a batch job's status until completed or failed. |\n| `export_list` | Download results as JSON or CSV when a batch is complete. |\n\n---\n\n## What Can You Do?\n\n### ✉️ Email Generation\n- \"Generate a cold email sequence for sarah@notion.so using my Gator 100 campaign\"\n- \"Write 5 personalized emails for John Smith, VP of Sales at Acme Corp\"\n- \"Generate emails for this lead with a focus on our ROI case study angle\"\n\n### 📦 Batch Processing\n- \"Submit these 20 leads for batch email generation\"\n- \"Check the status of my latest batch\"\n- \"Export my completed batch as CSV\"\n\n### 📋 Campaign Management\n- \"List my MachFive campaigns\"\n- \"What campaigns do I have?\"\n- \"Show me my campaign IDs\"\n\n### 📊 Results & Export\n- \"Export the results from my last batch as JSON\"\n- \"Download the CSV for my SaaS Founders list\"\n- \"Show me the generated emails for list xyz\"\n\n---\n\n## Example Conversations\n\n### Quick Single Lead Generation\n\n> **You:** \"Generate a 3-email sequence for jane@acme.com using my Marketing Agencies campaign. Her name is Jane Doe and she's the VP of Growth.\"\n>\n> **AI:** \"I'll generate that sequence now. This typically takes 3-5 minutes since MachFive researches the prospect and crafts personalized emails...\"\n>\n> *\\[3 minutes later\\]*\n>\n> **AI:** \"Here's your 3-email sequence for Jane Doe at Acme:\n>\n> **Email 1** — Subject: Quick question, Jane\n> Hi Jane, I noticed Acme's recent expansion into...\"\n\n### Batch Processing Workflow\n\n> **You:** \"I have 25 leads to process. Here they are: \\[paste leads\\]. Use my SaaS Founders campaign.\"\n>\n> **AI:** \"Batch submitted! I got list ID abc-123. Let me check the status...\"\n>\n> *\\[polls automatically\\]*\n>\n> **AI:** \"Your batch is complete — all 25 leads processed with 75 emails generated. Would you like me to export as CSV or JSON?\"\n\n### Morning Workflow Check\n\n> **You:** \"What campaigns do I have, and are there any batches still processing?\"\n>\n> **AI:** \"You have 3 campaigns: First Campaign, Gator 100, and Marketing Agencies. All current batches are completed — no pending jobs.\"\n\n---\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| Connection failed | Double-check your API key is correct |\n| \"Invalid API key\" error | Regenerate your API key in MachFive settings |\n| No response | Restart your AI client |\n| Timeout on generate_sequence | Normal — generation takes 3-10 minutes. Don't retry. |\n| Server unavailable | Check your internet connection and try again |\n\n---\n\n## Frequently Asked Questions\n\n### 1. Do I need to know how to code?\nNo. Setup takes about 5 minutes and just requires pasting your API key into your AI assistant's settings.\n\n### 2. Which AI assistants work with this?\nAny MCP-compatible client, including:\n- **Claude Desktop** (Anthropic)\n- **Cursor** (AI code editor)\n- **n8n** (AI agent workflows)\n- Any app supporting Streamable HTTP transport\n\n### 3. Is my data safe?\nYes. The connection uses your personal API key over encrypted HTTPS. Your AI can only access what your API key permits. Each user authenticates with their own key — MachFive never stores or shares API keys on the MCP server.\n\n### 4. What can my AI do with MachFive?\nYour AI can:\n- List your campaigns\n- Generate personalized cold email sequences for individual leads\n- Submit batches of leads for bulk generation\n- Check batch processing status\n- Export completed results as CSV or JSON\n\n### 5. How much does it cost?\nThe MCP server is free with your MachFive subscription. Email generation uses your account's credits as normal.\n\n### 6. What's the connection URL?\n`https://mcp.machfive.io/mcp`\n\n### 7. How long does email generation take?\nSingle lead generation (`generate_sequence`) takes 3-10 minutes because MachFive researches the prospect and crafts truly personalized emails. Batch generation (`generate_batch`) returns immediately — processing happens in the background, and you poll for completion.\n\n### 8. What if something goes wrong?\nGeneration is non-destructive — it creates new email sequences without affecting existing data. If a batch fails, simply submit a new one.\n\n---\n\n## API Endpoint\n\n| Endpoint | URL |\n|----------|-----|\n| Health check | `https://mcp.machfive.io/` |\n| MCP protocol | `https://mcp.machfive.io/mcp` |\n| MCP with API key | `https://mcp.machfive.io/mcp/YOUR_API_KEY` |\n\n---\n\n**Need help?** Contact us at [support@machfive.io](mailto:support@machfive.io)\n\n**MCP Documentation:** [modelcontextprotocol.io](https://modelcontextprotocol.io)\n",
  "bytes": 9027,
  "sha": "93c68725a812a036f15aec9034f094169289a070fd92f9cfd9425fe5b5a95242",
  "repo_slug": "bluecraft-ai/machfive-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bluecraft_ai_cold_email_0ab4c021/readme"
}