MCP Server

Active

MIT

io.github.ictinnovations/ictbroadcast-mcp MCP Server

io.github.ictinnovations/ictbroadcast-mcp

Monitor and control ICTBroadcast voice, SMS, and fax campaigns from Claude or Cursor.

What is the io.github.ictinnovations/ictbroadcast-mcp MCP server?

The ictbroadcast-mcp server is a Model Context Protocol integration for ICTBroadcast, the voice, SMS, and fax broadcasting platform from ICT Innovations. It enables AI assistants to monitor outbound campaigns, check their status, and optionally start or stop them when write access is enabled.

This MCP server connects Claude or Cursor to ICTBroadcast, allowing you to list campaigns, check live status, view call summaries and per-call results, and control campaign execution. Write operations (start/stop) are disabled by default for safety and only activate when explicitly enabled via environment variable.

How to install io.github.ictinnovations/ictbroadcast-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ICTBROADCAST_BASE_URL
required
Base URL of your ICTBroadcast server, without the /rest suffix, e.g. https://your-ictbroadcast.
ICTBROADCAST_USERNAME
required
API account username.
ICTBROADCAST_PASSWORD
required
secret
Password for the account.
ICTBROADCAST_MCP_ALLOW_WRITE
Unlocks starting and stopping campaigns, which begins live outbound calling and can cost money. When false those tools are not registered at all. Leave off unless you mean it.
ICTBROADCAST_TIMEOUT_MS
Per request timeout in milliseconds. Defaults to 30000.
ICTBROADCAST_TLS_INSECURE
Skip TLS certificate verification. Only for a self-signed test server.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ictbroadcast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictbroadcast-mcp"
      ],
      "env": {
        "ICTBROADCAST_BASE_URL": "<YOUR_ICTBROADCAST_BASE_URL>",
        "ICTBROADCAST_USERNAME": "<YOUR_ICTBROADCAST_USERNAME>",
        "ICTBROADCAST_PASSWORD": "<YOUR_ICTBROADCAST_PASSWORD>",
        "ICTBROADCAST_MCP_ALLOW_WRITE": "<YOUR_ICTBROADCAST_MCP_ALLOW_WRITE>",
        "ICTBROADCAST_TIMEOUT_MS": "<YOUR_ICTBROADCAST_TIMEOUT_MS>",
        "ICTBROADCAST_TLS_INSECURE": "<YOUR_ICTBROADCAST_TLS_INSECURE>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

ictbroadcast_list_campaigns — List all campaigns with their IDs and names
ictbroadcast_campaign_status — Check the live status of a campaign (running or stopped)
ictbroadcast_campaign_summary — Get campaign totals including answered calls, failed calls, and human vs machine detection results
ictbroadcast_campaign_result — Retrieve per-call results including contact information, response, AMD detection, and DNC status
ictbroadcast_start_campaign — Launch a campaign to begin live outbound calling (requires ICTBROADCAST_MCP_ALLOW_WRITE=true)
ictbroadcast_stop_campaign — Stop a running campaign (requires ICTBROADCAST_MCP_ALLOW_WRITE=true)

Use cases

Monitor the status and progress of active voice or SMS broadcast campaigns in real-time
Review call results and analytics for completed campaigns to assess performance
Start a new outbound campaign programmatically when conditions are met
Stop a running campaign immediately if issues are detected
Retrieve detailed per-call data including answering machine detection and do-not-call compliance

io.github.ictinnovations/ictbroadcast-mcp MCP server FAQ

What is the ictbroadcast-mcp server?

It's an MCP server that integrates Claude or Cursor with ICTBroadcast, a voice, SMS, and fax broadcasting platform. You can monitor campaigns, check status, view results, and optionally control campaign execution.

Is it free to use?

The MCP server itself is MIT licensed and free. You need an active ICTBroadcast account with API access (Service Provider edition) to use it.

How do I install it in Claude Desktop?

Add it to your Claude Desktop config.json under mcpServers with the command 'npx -y ictbroadcast-mcp' and set the required environment variables: ICTBROADCAST_BASE_URL, ICTBROADCAST_USERNAME, and ICTBROADCAST_PASSWORD.

What authentication is required?

You need valid ICTBroadcast API credentials: the server base URL, username, and password. These are passed via environment variables and sent with each API request.

Are write operations (start/stop campaigns) enabled by default?

No. Write tools are disabled by default for safety. Set ICTBROADCAST_MCP_ALLOW_WRITE=true to enable campaign start and stop functionality.

What Node.js version is required?

Node.js 18 or newer is required to run the ictbroadcast-mcp server.

README (reference)

Source of truth, from the repository.

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

npx -y ictbroadcast-mcp      # no install
npm install -g ictbroadcast-mcp

Requires Node.js 18 or newer.

Configure

Variable	Required	Default
`ICTBROADCAST_BASE_URL`	yes		Server base URL, without the `/rest` suffix, e.g. `https://your-ictbroadcast`
`ICTBROADCAST_USERNAME`	yes		API account username
`ICTBROADCAST_PASSWORD`	yes		Password for that account
`ICTBROADCAST_MCP_ALLOW_WRITE`	no	`false`	Unlock start/stop campaign (see Safety)
`ICTBROADCAST_TIMEOUT_MS`	no	`30000`	Per-request timeout
`ICTBROADCAST_TLS_INSECURE`	no	`false`	Skip TLS verification — self-signed test servers only

Claude Desktop example

{
  "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:

Tool	What it does
`ictbroadcast_list_campaigns`	List campaigns (id and name)
`ictbroadcast_campaign_status`	Live status of a campaign (running, stopped)
`ictbroadcast_campaign_summary`	Totals: answered, failed, human vs machine
`ictbroadcast_campaign_result`	Per-call results (contact, response, AMD, DNC)

Write tools appear only when ICTBROADCAST_MCP_ALLOW_WRITE=true:

Tool	What it does
`ictbroadcast_start_campaign`	Launch a campaign — begins live outbound calling
`ictbroadcast_stop_campaign`	Stop 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.

Related MCP servers

io.github.ictinnovations/ictcontact-mcp

Active

Monitor and control ICTContact/ICTDialer outbound campaigns via AI assistant.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictcrm-mcp

Active

Read CRM contact groups and manage contacts on ICTCRM (ICTContact backend).

TypeScript

MIT

View repository →

io.github.ictinnovations/ictdialer-mcp

Active

Monitor and control ICTDialer outbound auto-dialer campaigns from Claude or Cursor.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictexam-mcp

Active

Read exams, gradebooks and item analysis; parse papers with AI and publish exams on ICTExam.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictfax-mcp

Active

List, track, and send faxes via ICTFax and ICTCore REST API.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictpbx-mcp

Active

Read ICTPBX PBX state—extensions, DIDs, SIP trunks, tenants, and live statistics via MCP.

TypeScript

MIT

View repository →