Ictcontact Mcp

io.github.ictinnovationsPublished by GitHub account ictinnovationsv0.1.1Updated Oct 26, 2026

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

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Monitors ICTContact / ICTDialer outbound calling campaigns and, when writes are enabled, starts and stops them.

What you can do
  • List outbound campaigns with their ids and names
  • Check a campaign's live status, such as running or stopped
  • Read campaign totals: answered, failed, human versus machine, optionally scoped to one agent
  • Review per-call results including contact, response, answering-machine detection and DNC, filtered by call status
  • Start or stop a campaign, only when write access is explicitly enabled
When to use it
Useful when you run an ICTContact or ICTDialer contact center and want an assistant to check on outbound campaigns, poll status while a campaign runs, or pull call-level results without opening the admin UI.
Requirements
Runs locally via npx or a global npm install and needs Node.js 18 or newer. Requires the ICTCONTACT_BASE_URL, ICTCONTACT_USERNAME and ICTCONTACT_PASSWORD environment variables for the server account. Optional settings: ICTCONTACT_MCP_ALLOW_WRITE, ICTCONTACT_TIMEOUT_MS and ICTCONTACT_TLS_INSECURE. Network access to the ICTContact server is needed.
Before you install
The account password is passed as ICTCONTACT_PASSWORD and sent with every API call, so use a dedicated account and keep it out of shared configs. Setting ICTCONTACT_MCP_ALLOW_WRITE=true registers start and stop tools; starting a campaign begins live outbound calling and can cost real money. ICTCONTACT_TLS_INSECURE disables certificate checks and should only be used with a self-signed test server.

Installation

In SourceWeft

  1. Open Ictcontact Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: README.md at commit b7162a9

Tools

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.

Takes no parameters.

ictcontact_campaign_status

Campaign status

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

Parameterscampaign_idrequired

ictcontact_campaign_summary

Campaign summary

Totals for a campaign: answered, failed, human vs machine and so on. Optionally scope to one agent/user id.

Parametersusr_idcampaign_idrequired

ictcontact_campaign_result

Campaign call results

Per-call results for a campaign (contact, response, answering-machine detection, DNC), optionally filtered by call status.

Parametersstatuscampaign_idrequired

Version history

2
  1. v0.1.1LatestOct 26, 2026
  2. v0.1.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts