Machfive

io.github.Bluecraft-AI由 GitHub 帳號 Bluecraft-AI 發布v1.0.1更新於 Oct 26, 2026

Generate hyper-personalized cold email sequences via MachFive API.

已驗證Streamable HTTP可網頁執行溝通與協作商業與電商

概覽

AI 產生的概覽

將助理連接到 MachFive 帳戶，可列出活動、為單一潛在客戶或批次名單生成個人化冷郵件序列，並匯出結果。

可以做什麼
  • 列出工作區中的活動，取得生成所需的 campaign ID
  • 為單一潛在客戶生成個人化冷郵件序列，同步執行、需數分鐘
  • 提交多筆潛在客戶進行背景批次生成，並回傳清單 ID
  • 瀏覽潛在客戶清單與批次工作，輪詢批次的處理狀態
  • 將已完成批次的生成結果匯出為 JSON 或 CSV
適用情境
適合已在 MachFive 進行冷郵件開發的使用者，想在對話中直接觸發生成、查看批次進度並取回結果，而不必登入並上傳 CSV。
執行需求
需要 MachFive 帳戶與訂閱，以及在帳戶設定中建立的 MachFive API 金鑰。此伺服器是遠端 Streamable HTTP 端點，金鑰透過 URL 路徑或 Authorization 標頭傳入（Bearer 前綴可省略）。需要能連線至 MachFive 端點的網路。
安裝前請注意
API 金鑰等同 MachFive 帳戶的密碼，會出現在連線 URL 或 Authorization 標頭中，應妥善保管，避免寫入共用設定。生成會消耗帳戶額度。相關工具會在工作區建立新的郵件序列與批次工作，提交的潛在客戶資料會傳送給 MachFive 進行研究。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Machfive，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Bluecraft-AI%2Fmachfive/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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

來源：README.md，提交 45c1370

工具

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.

輸入參數query

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.

輸入參數nameemail必填titlecompanylist_namecampaign_id必填email_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.

輸入參數list_nameleads_json必填campaign_id必填email_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.

輸入參數limitoffsetstatuscampaign_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.

輸入參數list_id必填

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.

輸入參數formatlist_id必填

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分