Machfive

io.github.Bluecraft-AIPublished by GitHub account Bluecraft-AIv1.0.1Updated Oct 26, 2026

Generate hyper-personalized cold email sequences via MachFive API.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to a MachFive account to list campaigns, generate personalized cold email sequences for single leads or batches, and export results.

What you can do
  • List campaigns in the workspace and get the campaign IDs needed for generation
  • Generate a personalized cold email sequence for one lead, synchronously over several minutes
  • Submit multiple leads for background batch generation and get a list ID
  • Browse lead lists and batch jobs, and poll a batch's processing status
  • Export the generated sequences of a completed batch as JSON or CSV
When to use it
Useful when you already run cold email outreach in MachFive and want to trigger sequence generation, check batch progress and pull results from a conversation instead of logging in and uploading CSVs.
Requirements
A MachFive account and subscription, plus a MachFive API key created in the account settings. The server is a remote Streamable HTTP endpoint; the key is passed either in the URL path or in an Authorization header (Bearer prefix optional). Network access to the MachFive endpoint is required.
Before you install
The API key is a password-like credential to the MachFive account and is placed in the connection URL or an Authorization header, so keep it private and out of shared configs. Generation consumes the account's credits. The tools create new email sequences and batch jobs in the workspace, and lead details you submit are sent to MachFive for research.

Installation

In SourceWeft

  1. Open Machfive in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Bluecraft-AI%2Fmachfive/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "machfive": {
      "type": "http",
      "url": "https://mcp.machfive.io/mcp"
    }
  }
}

README

MachFive MCP Server

[MCP Badge] [smithery badge]

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 [email protected] 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.co
  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.co/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):
json
{  "mcpServers": {    "machfive": {      "url": "https://mcp.machfive.co/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):
json
{  "mcpServers": {    "machfive": {      "url": "https://mcp.machfive.co/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.co/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.co/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:

MethodFormatBest For
URL pathhttps://mcp.machfive.co/mcp/YOUR_API_KEYClients without header support, n8n
Authorization headerAuthorization: Bearer YOUR_API_KEYClaude Desktop, Cursor
Authorization header (no prefix)Authorization: YOUR_API_KEYSimplified integrations

The Bearer prefix is optional for the Authorization header.


Available Tools

MachFive MCP provides 6 tools for cold email generation:

📋 Campaigns

ToolDescription
list_campaignsList all campaigns in your workspace. Call this first — you need a campaign ID for generation.

✉️ Email Generation

ToolDescription
generate_sequenceGenerate a personalized email sequence for one lead (synchronous, 3-10 min).
generate_batchSubmit multiple leads for batch generation (async, returns immediately with a list ID).

📦 List Management

ToolDescription
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.

What Can You Do?

✉️ Email Generation

  • "Generate a cold email sequence for [email protected] 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"

📦 Batch Processing

  • "Submit these 20 leads for batch email generation"
  • "Check the status of my latest batch"
  • "Export my completed batch as CSV"

📋 Campaign Management

  • "List my MachFive campaigns"
  • "What campaigns do I have?"
  • "Show me my campaign IDs"

📊 Results & Export

  • "Export the results from my last batch as JSON"
  • "Download the CSV for my SaaS Founders list"
  • "Show me the generated emails for list xyz"

Example Conversations

Quick Single Lead Generation

You: "Generate a 3-email sequence for [email protected] using my Marketing Agencies campaign. Her name is Jane Doe and she's the VP of Growth."

AI: "I'll generate that sequence now. This typically takes 3-5 minutes since MachFive researches the prospect and crafts personalized emails..."

[3 minutes later]

AI: "Here's your 3-email sequence for Jane Doe at Acme:

Email 1 — Subject: Quick question, Jane Hi Jane, I noticed Acme's recent expansion into..."

Batch Processing Workflow

You: "I have 25 leads to process. Here they are: [paste leads]. Use my SaaS Founders campaign."

AI: "Batch submitted! I got list ID abc-123. Let me check the status..."

[polls automatically]

AI: "Your batch is complete — all 25 leads processed with 75 emails generated. Would you like me to export as CSV or JSON?"

Morning Workflow Check

You: "What campaigns do I have, and are there any batches still processing?"

AI: "You have 3 campaigns: First Campaign, Gator 100, and Marketing Agencies. All current batches are completed — no pending jobs."


Troubleshooting

ProblemSolution
Connection failedDouble-check your API key is correct
"Invalid API key" errorRegenerate your API key in MachFive settings
No responseRestart your AI client
Timeout on generate_sequenceNormal — generation takes 3-10 minutes. Don't retry.
Server unavailableCheck your internet connection and try again

Frequently Asked Questions

1. Do I need to know how to code?

No. Setup takes about 5 minutes and just requires pasting your API key into your AI assistant's settings.

2. Which AI assistants work with this?

Any MCP-compatible client, including:

  • Claude Desktop (Anthropic)
  • Cursor (AI code editor)
  • n8n (AI agent workflows)
  • Any app supporting Streamable HTTP transport

3. Is my data safe?

Yes. 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.

4. What can my AI do with MachFive?

Your AI can:

  • List your campaigns
  • Generate personalized cold email sequences for individual leads
  • Submit batches of leads for bulk generation
  • Check batch processing status
  • Export completed results as CSV or JSON

5. How much does it cost?

The MCP server is free with your MachFive subscription. Email generation uses your account's credits as normal.

6. What's the connection URL?

https://mcp.machfive.co/mcp

7. How long does email generation take?

Single 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.

8. What if something goes wrong?

Generation is non-destructive — it creates new email sequences without affecting existing data. If a batch fails, simply submit a new one.


API Endpoint

EndpointURL
Health checkhttps://mcp.machfive.co/
MCP protocolhttps://mcp.machfive.co/mcp
MCP with API keyhttps://mcp.machfive.co/mcp/YOUR_API_KEY

Need help? Contact us at [email protected]

MCP Documentation: modelcontextprotocol.io

Source: README.md at commit 45c1370

Tools

6

list_campaigns

List Campaigns

List campaigns in the user's MachFive workspace. CALL THIS FIRST before generate_sequence or generate_batch — you need a campaign ID to generate emails. If the user hasn't specified a campaign, call this and ask them to pick one. Returns JSON array of campaigns with id, name, and created_at. Use the 'id' field as campaign_id in generate calls.

Parametersquery

generate_sequence

Generate Email Sequence

Generate a personalized cold email sequence for ONE lead. This is SYNCHRONOUS — the request takes 3-10 minutes because MachFive researches the prospect and crafts unique emails. Do NOT retry if it seems slow; wait for the response. You must have a campaign_id first. Call list_campaigns if you don't have one. If the request times out, use the returned list_id with get_list_status and export_list to recover results.

Parametersnameemailrequiredtitlecompanylist_namecampaign_idrequiredemail_countlinkedin_urlapproved_ctascampaign_anglecompany_websiteemail_signature

generate_batch

Generate Batch

Submit multiple leads for batch email sequence generation (ASYNC). Returns IMMEDIATELY with a list_id. Processing runs in the background. After calling this, poll get_list_status every 15-30 seconds until processing_status is 'completed' or 'failed', then call export_list. You must have a campaign_id first. Call list_campaigns if you don't have one.

Parameterslist_nameleads_jsonrequiredcampaign_idrequiredemail_countapproved_ctascampaign_angleemail_signature

list_lists

List Lead Lists

List lead lists (batch jobs) in the user's MachFive workspace. Useful for browsing past batches, checking what's in progress, or finding a list_id to export. Results are ordered newest first.

Parameterslimitoffsetstatuscampaign_id

get_list_status

Get List Status

Check the processing status of a lead list. Use this to POLL after calling generate_batch. Call every 15-30 seconds until processing_status is 'completed' or 'failed'. When completed, call export_list. When failed, submit a new batch.

Parameterslist_idrequired

export_list

Export List

Download the generated email sequences for a COMPLETED list. Only call this AFTER get_list_status shows processing_status = 'completed'. If the list is not yet completed, you'll get a 409 error — poll first.

Parametersformatlist_idrequired

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts