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 分