Ictdialer Mcp

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

Monitor ICTDialer outbound auto-dialer campaigns, and start and stop them when writes are on.

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

概覽

AI 產生的概覽

將助理連接到 ICTDialer 外撥伺服器，可列出外撥活動、查看狀態、彙總與單次通話結果，並可選擇啟動或停止活動。

可以做什麼
  • 列出外撥活動及其 id 與名稱
  • 查看活動的即時狀態，例如執行中或已停止
  • 讀取活動彙總資料：已接聽、失敗、真人與機器接聽，可依客服人員篩選
  • 讀取單次通話結果，包括聯絡人、回應、答錄機偵測與 DNC，可依通話狀態過濾
  • 僅在明確開啟寫入模式時啟動或停止活動
適用情境
適用於在 ICTDialer 上執行外撥活動、希望由助理回報進度、彙整結果，或在對話中直接啟動與停止活動而不必開啟網頁主控台的情境。
執行需求
透過 npx 或全域 npm 安裝在本機執行，需要 Node.js 18 或更新版本。需要 ICTDialer 基礎網址（不含 /rest 後綴）、API 帳號使用者名稱與密碼（ICTDIALER_PASSWORD），並能連線該伺服器。選用設定：ICTDIALER_MCP_ALLOW_WRITE、ICTDIALER_TIMEOUT_MS 與 ICTDIALER_TLS_INSECURE。
安裝前請注意
帳號密碼透過 ICTDIALER_PASSWORD 提供，並隨每次 API 呼叫送出，需妥善保管。設定 ICTDIALER_MCP_ALLOW_WRITE=true 會註冊啟動與停止工具；啟動活動會開始真實外撥並可能產生費用，除非確有需要否則不要開啟。ICTDIALER_TLS_INSECURE 會略過憑證驗證，僅應使用於自簽章的測試伺服器。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

ictdialer-mcp

A Model Context Protocol server for ICTDialer — the cloud auto-dialer and predictive-dialer platform from ICT Innovations. ICTDialer.com is the hosted edition of ICTContact and runs the same engine, so this server speaks that API.

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 ictdialer-mcp      # no installnpm install -g ictdialer-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTDIALER_BASE_URLyesServer base URL, without the /rest suffix, e.g. https://your-ictdialer
ICTDIALER_USERNAMEyesAPI account username
ICTDIALER_PASSWORDyesPassword for that account
ICTDIALER_MCP_ALLOW_WRITEnofalseUnlock start/stop campaign (see Safety)
ICTDIALER_TIMEOUT_MSno30000Per-request timeout
ICTDIALER_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

json
{  "mcpServers": {    "ictdialer": {      "command": "npx",      "args": ["-y", "ictdialer-mcp"],      "env": {        "ICTDIALER_BASE_URL": "https://your-ictdialer",        "ICTDIALER_USERNAME": "admin",        "ICTDIALER_PASSWORD": "your-password"      }    }  }}

Tools

Read tools are always available:

ToolWhat it does
ictdialer_list_campaignsList campaigns (id and name)
ictdialer_campaign_statusLive status of a campaign (running, stopped)
ictdialer_campaign_summaryTotals: answered, failed, human vs machine
ictdialer_campaign_resultPer-call results (contact, response, AMD, DNC)

Write tools appear only when ICTDIALER_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictdialer_start_campaignLaunch a campaign — begins live outbound calling
ictdialer_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 ictdialer_start_campaign and ictdialer_stop_campaign are not registered at all unless you set ICTDIALER_MCP_ALLOW_WRITE=true.

How it connects

ICTDialer 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.

About

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

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

來源：README.md，提交 c8e687d

工具

4

ictdialer_list_campaigns

List campaigns

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

無需輸入參數。

ictdialer_campaign_status

Campaign status

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

輸入參數campaign_id必填

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

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