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 分