Ictdialer Mcp

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

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

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to an ICTDialer auto-dialer server to list outbound campaigns, check status, read summaries and per-call results, and optionally start…

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
  • Read per-call results including contact, response, answering-machine detection and DNC, filterable by call status
  • Start or stop campaigns, only when write mode is explicitly enabled
When to use it
Useful when you run outbound calling campaigns on ICTDialer and want an assistant to report on their progress, summarize results, or trigger start and stop from a chat session instead of the web console.
Requirements
Runs locally via npx or a global npm install and needs Node.js 18 or newer. Requires the ICTDialer base URL without the /rest suffix, an API account username and password (ICTDIALER_PASSWORD), and network access to that server. Optional settings: ICTDIALER_MCP_ALLOW_WRITE, ICTDIALER_TIMEOUT_MS and ICTDIALER_TLS_INSECURE.
Before you install
The account password is passed in ICTDIALER_PASSWORD and sent with every API call, so store it carefully. Setting ICTDIALER_MCP_ALLOW_WRITE=true registers start and stop tools; starting a campaign begins live outbound calling and can cost real money, so leave it off unless intended. ICTDIALER_TLS_INSECURE disables certificate verification and should only be used with a self-signed test server.

Installation

In SourceWeft

  1. Open Ictdialer 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

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.

Source: README.md at commit c8e687d

Tools

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.

Takes no parameters.

ictdialer_campaign_status

Campaign status

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

Parameterscampaign_idrequired

ictdialer_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

ictdialer_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