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 分