Ictcontact Mcp

io.github.ictinnovations由 GitHub 帳號 ictinnovations 發布v0.1.1更新於 Oct 26, 2026

Monitor ICTContact / ICTDialer outbound campaigns, and start and stop them when writes are on.

已驗證STDIO僅桌面溝通與協作商業與電商

概覽

AI 產生的概覽

監控 ICTContact / ICTDialer 外撥活動，並在開啟寫入後啟動或停止活動。

可以做什麼
  • 列出外撥活動及其 id 與名稱
  • 查看某個活動的即時狀態，例如執行中或已停止
  • 讀取活動彙總資料：已接聽、失敗、真人與機器接聽，可依客服人員篩選
  • 查看逐通通話結果，包括聯絡人、回應、答錄機偵測與 DNC，可依通話狀態過濾
  • 僅在明確開啟寫入時啟動或停止活動
適用情境
適用於使用 ICTContact 或 ICTDialer 客服中心、希望讓助理查看外撥活動、在活動執行期間輪詢狀態，或不必開啟管理後台就能取得逐通通話結果的情境。
執行需求
透過 npx 或全域 npm 安裝在本機執行，需要 Node.js 18 或更新版本。需設定 ICTCONTACT_BASE_URL、ICTCONTACT_USERNAME 與 ICTCONTACT_PASSWORD 環境變數以提供伺服器帳號。選用設定包括 ICTCONTACT_MCP_ALLOW_WRITE、ICTCONTACT_TIMEOUT_MS 與 ICTCONTACT_TLS_INSECURE。需要能連線至 ICTContact 伺服器的網路。
安裝前請注意
帳號密碼透過 ICTCONTACT_PASSWORD 傳入，並隨每次 API 呼叫送出，建議使用專用帳號並避免寫入共用設定。設定 ICTCONTACT_MCP_ALLOW_WRITE=true 會註冊啟動與停止工具；啟動活動會開始真實外撥，可能產生實際費用。ICTCONTACT_TLS_INSECURE 會關閉憑證驗證，僅應搭配自簽章的測試伺服器使用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ictcontact Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ictcontact-mcp

A Model Context Protocol server for ICTContact and its hosted edition ICTDialer.com — the same contact-center engine 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 ictcontact-mcp      # no installnpm install -g ictcontact-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTCONTACT_BASE_URLyesServer base URL, without the /rest suffix, e.g. https://your-ictcontact
ICTCONTACT_USERNAMEyesAPI account username
ICTCONTACT_PASSWORDyesPassword for that account
ICTCONTACT_MCP_ALLOW_WRITEnofalseUnlock start/stop campaign (see Safety)
ICTCONTACT_TIMEOUT_MSno30000Per-request timeout
ICTCONTACT_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

json
{  "mcpServers": {    "ictcontact": {      "command": "npx",      "args": ["-y", "ictcontact-mcp"],      "env": {        "ICTCONTACT_BASE_URL": "https://your-ictcontact",        "ICTCONTACT_USERNAME": "admin",        "ICTCONTACT_PASSWORD": "your-password"      }    }  }}

Tools

Read tools are always available:

ToolWhat it does
ictcontact_list_campaignsList campaigns (id and name)
ictcontact_campaign_statusLive status of a campaign (running, stopped)
ictcontact_campaign_summaryTotals: answered, failed, human vs machine
ictcontact_campaign_resultPer-call results (contact, response, AMD, DNC)

Write tools appear only when ICTCONTACT_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictcontact_start_campaignLaunch a campaign — begins live outbound calling
ictcontact_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 ictcontact_start_campaign and ictcontact_stop_campaign are not registered at all unless you set ICTCONTACT_MCP_ALLOW_WRITE=true.

How it connects

ICTContact and ICTDialer expose 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.

About

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

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

來源：README.md，提交 b7162a9

工具

4

ictcontact_list_campaigns

List campaigns

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

無需輸入參數。

ictcontact_campaign_status

Campaign status

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

輸入參數campaign_id必填

ictcontact_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必填

ictcontact_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 分