politicalcomms

@political-comms/mcp

用于 Political Comms REST API 的 MCP（模型上下文协议）服务。让 Claude 和其他 MCP 客户端查看组织、项目、联系人列表、分析数据和账单，并在美国创建、测试和安排符合规范的政治短信和 MMS 发送。

通过 stdio 运行。需要 Node 20 或更高版本，以及 Political Comms API 密钥（在控制面板的 Admin > API 下创建，前缀为 pc_live_）。

设置

Claude Code

claude mcp add political-comms \
  --env POLITICAL_COMMS_API_KEY=pc_live_... \
  -- npx -y @political-comms/mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "political-comms": {
      "command": "npx",
      "args": ["-y", "@political-comms/mcp"],
      "env": {
        "POLITICAL_COMMS_API_KEY": "pc_live_..."
      }
    }
  }
}

工具

只读：

工具	说明
list_organizations	列出此 API 密钥可见的组织。也可用于检查凭据。
get_hierarchy	完整的组织层级树，包含品牌。
list_projects	列出消息项目，可按组织、品牌或活动筛选。
get_project	单个项目的完整配置。
get_project_stats	单个项目的送达和互动统计数据。
get_project_throughput	单个项目的运营商限额估算：是否会在 T-Mobile 每日上限处暂停，以及需要多长时间。
get_campaign_throughput	活动的 T-Mobile 每日上限、今日用量和 AT&T 每分钟速率。
list_contact_lists	联系人列表及其数量和状态。
get_contact_list	单个联系人列表，包含导入进度、分析数据和 downloads URL。
download_contact_list	将联系人列表作为 CSV 文本返回（type 为原始或已分析），最多截取至 100,000 个字符。
get_message_stats	指定日期范围内的汇总消息统计数据。
get_ledger_usage	指定日期范围内的账单用量。
list_conversations	列出至少包含一条入站消息的对话，按最后一条入站消息排序。
get_conversation	单个对话：状态、联系人、消息数量、最后活动时间。
list_conversation_messages	列出单个对话中的消息，按时间从新到旧排序。
list_email_domains	邮件发送域名及其 DNS 验证状态。
get_email_domain	单个发送域名，包含需要发布的 DNS 记录。
list_email_senders	邮件发件人身份（发件地址）。
list_email_lists	邮件列表及其联系人数量和状态。
list_email_suppressions	组织、身份或列表范围内被抑制的地址。
list_email_campaigns	邮件活动及其状态和受众数量。
get_email_campaign	单个活动，包含 blocked：活动无法安排的原因。
get_email_campaign_stats	报告指标卡片和各链接的点击数据。
list_email_templates	已保存的邮件模板及其主题和最后更新时间。
get_email_template	单个模板，包含完整的 HTML 正文。

写入（每项均标注为非只读；create_project、test_project、schedule_project 和 reply_to_conversation 还需要 confirm: true，因为它们会暂存或发送真实消息）：

工具	说明
create_project	创建消息项目草稿。
test_project	向明确指定的电话号码发送真实测试消息。
schedule_project	将批量发送安排在指定日期和时间。
unschedule_project	移除项目的发送安排。
pause_project	暂停正在运行或已安排的发送；使用 schedule_project 恢复。
copy_project	将项目复制为新的草稿（不复制列表、安排和统计数据）。
reply_to_conversation	在现有对话中发送真实 SMS 回复。需要 confirm: true。
schedule_email_campaign	确认并安排邮件发送。需要 confirm: true。
unschedule_email_campaign	将已安排的活动恢复为草稿状态。
start_email_list_import	将联系人 CSV 导入邮件列表。需要 confirm: true。

该服务刻意不提供任何删除操作。

电子邮件工具

电子邮件写入工具需要组织拥有电子邮件权限，否则会返回 403 ENTITLEMENT_REQUIRED；读取操作则不受限制。付费且需要人工参与的电子邮件工作流（AI 草拟、结果导出）以及投递问题排查（暂停 并恢复正在进行的发送）属于控制面板功能，而非工具：这些操作需要付费，或需要人工监控发送过程。没有收件邮件或收件箱界面。

错误

API 错误会作为工具错误返回，其中包含机器可读的代码和恢复提示。请求受限时（每个密钥每分钟 600 次请求），会提示等待 X-RateLimit-Reset；身份验证失败时，会说明必须由人工在控制面板中创建密钥。

完整 API 参考：docs.politicalcomms.com。OpenAPI 规范：politicalcomms.com/openapi.json。

许可证

MIT。问题请联系：[email protected]