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 分