Ballast

io.github.useballast由 GitHub 帳號 useballast 發布v1.0.2更新於 Oct 30, 2026

Cold email outreach: manage campaigns, lead sequences, mailbox warmup, and unified inbox replies.

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

概覽

AI 產生的概覽

Ballast 將 AI 助理連接到冷郵件開發工作區，用來管理活動、序列、潛在客戶名單、信箱暖身與收件匣回覆。

可以做什麼
  • 檢視工作區身分、整體彙總數據、方案與寄送額度
  • 檢查網域與信箱：DNS 與送達率診斷，列出或新增寄件網域和已連結信箱
  • 管理潛在客戶：搜尋、匯入、查看分組，並加入拒聯名單
  • 建立與執行活動：建立、更新、設定序列、加入潛在客戶、預覽寄送分布、檢查上線清單、啟動或暫停，並讀取統計與分析
  • 處理統一收件匣：列出與閱讀對話串、起草並寄送回覆、標上情緒標籤
適用情境
適合在 Ballast 中進行冷郵件開發、希望助理起草序列、檢查網域與信箱送達率、查看活動指標，或整理並回覆來信而不必切換到網頁版的場合。
執行需求
需要 Ballast 工作區帳號，以及在 Settings > API Keys 取得的 API 金鑰（本機 npm 套件透過 BALLAST_API_KEY 傳入）；託管遠端端點使用 OAuth。本機套件需 Node.js 18 以上版本，遠端端點需網路連線。
安裝前請注意
此伺服器可寄出真實郵件並修改開發資料：啟動活動、寄送回覆與刪除操作需要兩步確認權杖，核准前請先核對試執行預覽。它會接觸潛在客戶聯絡資料與信箱連結，且 API 金鑰可存取整個工作區，請妥善保管。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ballast，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "ballast": {
      "type": "http",
      "url": "https://ballast.to/api/mcp"
    }
  }
}

README

Ballast MCP Server

[Ballast - Cold Email MCP server – quality and maintenance score on Glama] [Protocol] [License: MIT]

Official Model Context Protocol (MCP) server implementation for Ballast — connect AI agents to manage cold email campaigns, deliverability warmup, lead lists, and inbox replies.

This repository contains the standalone MCP server package that runs locally via standard I/O (stdio) and connects AI assistants (Claude Desktop, Cursor, Claude Code, Zed, etc.) to your Ballast workspace.

Features

  • Deliverability & DNS Diagnostics: Inspect secondary domains for SPF, DKIM, DMARC alignment, MX configuration, and blacklist health.
  • Campaign & Sequence Management: Build multi-step outbound sequences, set A/B variants, configure sending delays, and verify launch checklists.
  • Automated Bounce Circuit Breakers: Monitor campaign placement rates and pause sends if bounce rate thresholds are crossed.
  • Unified Inbox (Unibox): Read and summarize customer email threads, check sentiment classification, and draft human-confirmed replies.
  • Safe by Default: Destructive operations (launching campaigns, sending emails, deleting data) require explicit two-step confirmation with a 10-minute HMAC token.

Installation & Setup

Requirements

Run via npx (Recommended)

You can run the server directly without manual installation:

bash
BALLAST_API_KEY="bl_your_key_here" npx -y ballast-mcp

Install from Source

bash
git clone https://github.com/useballast/ballast-mcp.gitcd ballast-mcpnpm installnpm start

Client Configuration

Claude Desktop

Add Ballast to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "ballast": {      "command": "npx",      "args": ["-y", "ballast-mcp"],      "env": {        "BALLAST_API_KEY": "bl_your_api_key_here"      }    }  }}

Cursor

Add to ~/.cursor/mcp.json (or your project's .cursor/mcp.json):

json
{  "mcpServers": {    "ballast": {      "command": "npx",      "args": ["-y", "ballast-mcp"],      "env": {        "BALLAST_API_KEY": "bl_your_api_key_here"      }    }  }}

Claude Code

bash
claude mcp add --transport stdio ballast -- npx -y ballast-mcp --key=bl_your_api_key_here

(Note: For clients that support remote Streamable HTTP directly, you can also use --transport http ballast https://ballast.to/api/mcp --header "Authorization: Bearer bl_...")

Tools Reference

The server implements 30 core tools organized by functional area:

ToolCategoryDescription
whoamiWorkspaceGet authenticated user, active workspace, and permission role.
get_overviewWorkspaceWorkspace-wide aggregate totals and trends across all campaigns (sends, replies, sentiment, bounces).
get_billingWorkspacePlan details, sending allowances, dedicated IPs, and usage limits.
check_domainDomainsLive DNS & deliverability diagnostics on any domain without adding it.
list_domainsDomainsList connected sending domains with deliverability scores and verification status.
add_domainDomainsConnect and register a new sending domain to the workspace.
list_mailboxesMailboxesList connected Google Workspace and Microsoft 365 mailboxes with daily limits.
add_mailboxMailboxesConnect an external mailbox for outbound outreach.
list_leadsLeadsSearch and filter contacts in your workspace.
import_leadsLeadsImport lead contacts with custom variables and tag assignment.
list_lead_listsLeadsList organized lead segments and member counts.
add_suppressionsLeadsAdd email addresses or root domains to workspace-wide do-not-contact lists.
list_campaignsCampaignsList outbound sequences with sending schedules and statuses.
create_campaignCampaignsCreate a new cold email campaign.
get_campaignCampaignsRetrieve campaign settings, step variants, and assigned mailboxes.
update_campaignCampaignsUpdate campaign schedule, daily quotas, or track settings.
set_sequenceCampaignsConfigure sequence steps, delays, subject lines, and body copy.
write_sequenceCampaignsGenerate or polish multi-step sequence copy using AI.
add_leads_to_campaignCampaignsEnroll lead segments into an active sequence.
preview_campaignCampaignsPreview lead send distribution across mailboxes and first send timings.
get_launch_checklistCampaignsCheck domain alignment, sender warmup, and lead hygiene before launch.
launch_campaignCampaignsLaunch sequence sending (requires confirm token).
pause_campaignCampaignsImmediately pause sending for a campaign.
get_campaign_statsCampaignsDaily time-series email metrics for a campaign or all campaigns over time.
get_campaign_analyticsCampaignsGranular performance breakdown across email providers (Google, Microsoft), mailboxes, and sentiment.
get_unibox_filtersUniboxRetrieve unified inbox filter presets and label counts.
list_threadsUniboxList incoming recipient replies and conversation threads.
get_threadUniboxInspect full thread message history, headers, and lead details.
send_replyUniboxSend an email reply from the thread's assigned mailbox (requires confirm token).
label_threadUniboxApply sentiment labels (Interested, Meeting Booked, Not Interested, Out of Office).

Safety: Two-Step Confirmations

To prevent inadvertent mass sends or data deletion:

  1. When calling launch_campaign, send_reply, or deletion tools without a confirm_token, the server generates a dry-run preview describing the exact outcome (e.g. "Will send 320 emails across 6 mailboxes") and issues an HMAC token.
  2. The AI presents the preview to the user.
  3. The action executes only when the user approves and the AI passes the confirm_token.

Development

bash
git clone https://github.com/useballast/ballast-mcp.gitcd ballast-mcpnpm installnpm test # or npm start

License

MIT © Ballast

來源：README.md，提交 e8fbd4f

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.0.2最新Oct 30, 2026

評分

已滿足適用檢查項的 85%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分