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 分