Ictbroadcast Mcp

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

Monitor ICTBroadcast outbound campaigns, and start and stop them when writes are on.

VerifiedSTDIODesktop onlyCommunication & CollaborationData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to an ICTBroadcast server to list outbound campaigns, check live status, read summaries and per-call results, and optionally start or…

What you can do
  • List outbound campaigns with their ids and names
  • Check the live status of a campaign, 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, filtered by call status
  • Start or stop a campaign, only when write mode is explicitly enabled
When to use it
Useful when you run ICTBroadcast outbound calling, SMS or fax campaigns and want an assistant to look up campaign ids, poll progress while a campaign runs, or summarize results without opening the web console. Write mode is only for operators who intend to launch or halt live calling from the assistant.
Requirements
A local Node.js 18 or newer runtime, since it runs as a stdio process via npx or a global npm install. An ICTBroadcast server with the REST API (bundled with the Service Provider edition), plus the base URL without the /rest suffix, an API account username and password. Network access to that server.
Before you install
The account password is passed in ICTBROADCAST_PASSWORD and sent with every API call, so store it carefully. Setting ICTBROADCAST_MCP_ALLOW_WRITE=true registers start and stop tools; starting a campaign begins live outbound calling and can cost real money. ICTBROADCAST_TLS_INSECURE disables certificate checks and should only be used against a self-signed test server.

Installation

In SourceWeft

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

ictbroadcast-mcp

A Model Context Protocol server for ICTBroadcast — the voice, SMS and fax broadcasting and call-center platform 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 ictbroadcast-mcp      # no installnpm install -g ictbroadcast-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTBROADCAST_BASE_URLyesServer base URL, without the /rest suffix, e.g. https://your-ictbroadcast
ICTBROADCAST_USERNAMEyesAPI account username
ICTBROADCAST_PASSWORDyesPassword for that account
ICTBROADCAST_MCP_ALLOW_WRITEnofalseUnlock start/stop campaign (see Safety)
ICTBROADCAST_TIMEOUT_MSno30000Per-request timeout
ICTBROADCAST_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

json
{  "mcpServers": {    "ictbroadcast": {      "command": "npx",      "args": ["-y", "ictbroadcast-mcp"],      "env": {        "ICTBROADCAST_BASE_URL": "https://your-ictbroadcast",        "ICTBROADCAST_USERNAME": "admin",        "ICTBROADCAST_PASSWORD": "your-password"      }    }  }}

Tools

Read tools are always available:

ToolWhat it does
ictbroadcast_list_campaignsList campaigns (id and name)
ictbroadcast_campaign_statusLive status of a campaign (running, stopped)
ictbroadcast_campaign_summaryTotals: answered, failed, human vs machine
ictbroadcast_campaign_resultPer-call results (contact, response, AMD, DNC)

Write tools appear only when ICTBROADCAST_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictbroadcast_start_campaignLaunch a campaign — begins live outbound calling
ictbroadcast_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 ictbroadcast_start_campaign and ictbroadcast_stop_campaign are not registered at all unless you set ICTBROADCAST_MCP_ALLOW_WRITE=true.

How it connects

ICTBroadcast 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. (The ICTBroadcast REST API is bundled with the Service Provider edition.)

About

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

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

Source: README.md at commit 12692d5

Tools

4

ictbroadcast_list_campaigns

List campaigns

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

Takes no parameters.

ictbroadcast_campaign_status

Campaign status

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

Parameterscampaign_idrequired

ictbroadcast_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

ictbroadcast_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