Ictbroadcast Mcp

io.github.ictinnovations由 GitHub 账号 ictinnovations 发布v0.1.1更新于 Oct 26, 2026

Monitor ICTBroadcast outbound campaigns, and start and stop them when writes are on.

已验证STDIO仅桌面沟通与协作数据与分析商业与电商

概览

AI 生成的概览

让助手连接 ICTBroadcast 服务器，列出外呼活动、查看实时状态、汇总与单次通话结果，并可选地启动或停止活动。

可以做什么
  • 列出外呼活动及其 id 和名称
  • 查看某个活动的实时状态，例如运行中或已停止
  • 读取活动汇总数据：已接听、失败、真人还是机器，可按坐席筛选
  • 读取单次通话结果，包括联系人、应答、应答机识别和 DNC，可按通话状态过滤
  • 仅在显式开启写入模式时启动或停止活动
适用场景
适用于使用 ICTBroadcast 进行外呼、短信或传真活动的场景，希望助手帮忙查找活动 id、在活动运行期间轮询进度，或在不打开网页控制台的情况下汇总结果。写入模式只适合确实要从助手中发起或中止实时外呼的操作人员。
运行要求
需要本地 Node.js 18 或更高版本，通过 npx 或全局 npm 安装以 stdio 方式运行。需要一个启用 REST API 的 ICTBroadcast 服务器（随 Service Provider 版本提供），以及不含 /rest 后缀的基础地址、API 账号用户名和密码，并能访问该服务器。
安装前请注意
账号密码通过 ICTBROADCAST_PASSWORD 传入，并随每次 API 调用发送，需妥善保管。设置 ICTBROADCAST_MCP_ALLOW_WRITE=true 会注册启动和停止工具；启动活动会开始真实外呼并可能产生费用。ICTBROADCAST_TLS_INSECURE 会跳过证书校验，只应对自签名的测试服务器使用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ictbroadcast Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ictbroadcast-mcp

A Model Context Protocol server for ICTBroadcast — the voice, SMS and fax broadcasting and call-center platform from ICT Innovations.

It lets an AI assistant monitor outbound campaigns — list them, check status, read summaries and per-call results — and, only when you turn writes on, start and stop them.

Install

bash
npx -y ictbroadcast-mcp      # no installnpm install -g ictbroadcast-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTBROADCAST_BASE_URLyesServer base URL, without the /rest suffix, e.g. https://your-ictbroadcast
ICTBROADCAST_USERNAMEyesAPI account username
ICTBROADCAST_PASSWORDyesPassword for that account
ICTBROADCAST_MCP_ALLOW_WRITEnofalseUnlock start/stop campaign (see Safety)
ICTBROADCAST_TIMEOUT_MSno30000Per-request timeout
ICTBROADCAST_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

json
{  "mcpServers": {    "ictbroadcast": {      "command": "npx",      "args": ["-y", "ictbroadcast-mcp"],      "env": {        "ICTBROADCAST_BASE_URL": "https://your-ictbroadcast",        "ICTBROADCAST_USERNAME": "admin",        "ICTBROADCAST_PASSWORD": "your-password"      }    }  }}

Tools

Read tools are always available:

ToolWhat it does
ictbroadcast_list_campaignsList campaigns (id and name)
ictbroadcast_campaign_statusLive status of a campaign (running, stopped)
ictbroadcast_campaign_summaryTotals: answered, failed, human vs machine
ictbroadcast_campaign_resultPer-call results (contact, response, AMD, DNC)

Write tools appear only when ICTBROADCAST_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictbroadcast_start_campaignLaunch a campaign — begins live outbound calling
ictbroadcast_stop_campaignStop a running campaign

Safety

The server is read-only by default. Starting a campaign begins live outbound calling and can cost real money, so ictbroadcast_start_campaign and ictbroadcast_stop_campaign are not registered at all unless you set ICTBROADCAST_MCP_ALLOW_WRITE=true.

How it connects

ICTBroadcast exposes a form-encoded RPC API at {base}/rest/<Method>. Each call carries the account username and password; the server sends those for you. There is no separate token to provision. (The ICTBroadcast REST API is bundled with the Service Provider edition.)

About

Built by Tahir Almas at ICT Innovations — the team behind ICTBroadcast, ICTContact, ICTDialer, ICTFax and ICTPBX. Learn more at ictbroadcast.com.

MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictbroadcast-mcp.

来源：README.md，提交 12692d5

工具

4

ictbroadcast_list_campaigns

List campaigns

List the outbound campaigns on the ICTBroadcast server (id and name of each). Start here to find a campaign id.

无需输入参数。

ictbroadcast_campaign_status

Campaign status

Live status of a campaign by id (for example running or stopped). Poll this while a campaign runs.

输入参数campaign_id必填

ictbroadcast_campaign_summary

Campaign summary

Totals for a campaign: answered, failed, human vs machine and so on. Optionally scope to one agent/user id.

输入参数usr_idcampaign_id必填

ictbroadcast_campaign_result

Campaign call results

Per-call results for a campaign (contact, response, answering-machine detection, DNC), optionally filtered by call status.

输入参数statuscampaign_id必填

版本历史

2
  1. v0.1.1最新Oct 26, 2026
  2. v0.1.0Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分