# Ictbroadcast MCP

> Ictbroadcast MCP is an open-source MCP server for communication. Monitor ICTBroadcast voice campaigns and, if enabled, start or stop them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://ictbroadcast.com
- **Repository:** https://github.com/ictinnovations/ictbroadcast-mcp
- **MCP Registry name:** io.github.ictinnovations/ictbroadcast-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

ICTBroadcast is a voice, SMS and fax broadcasting and call-centre platform from ICT Innovations, built on Asterisk. This server connects an assistant to an existing ICTBroadcast installation so it can list campaigns, check whether one is running, read answered, failed and human-versus-machine totals, and pull per-call results including answering machine detection and do-not-call outcomes.

It is read-only by default. The start and stop tools are not registered at all unless ICTBROADCAST_MCP_ALLOW_WRITE is true, because starting a campaign begins live outbound calling and can cost real money. Connection needs the server's base URL plus an API account username and password; the README notes the REST API is bundled with the Service Provider edition.

It runs over stdio with Node.js 18 or newer, via npx or a global install, and is MIT licensed. A TLS-skip option exists for self-signed test servers only.

## Features

- **Campaign listing:** Lists campaigns by id and name.
- **Live status:** Shows whether a campaign is running or stopped.
- **Summary totals:** Reports answered, failed, human and machine counts.
- **Per-call results:** Returns contact, response, AMD and DNC results.
- **Opt-in writes:** Start and stop tools appear only when writes are enabled.
- **Configurable timeout:** Sets per-request limits and TLS options.

## Good for

- Check how a dialing campaign is going
- Compare human and machine answers for a run
- Review per-call outcomes after a broadcast
- Stop a running campaign from an assistant when writes are on
- Report campaign status to a team

## Install

### Claude Code (Terminal)

```sh
claude mcp add ictbroadcast-mcp --env ICTBROADCAST_BASE_URL='<ICTBROADCAST_BASE_URL>' --env ICTBROADCAST_USERNAME='<ICTBROADCAST_USERNAME>' --env ICTBROADCAST_PASSWORD='<ICTBROADCAST_PASSWORD>' -- npx -y ictbroadcast-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ictbroadcast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictbroadcast-mcp"
      ],
      "env": {
        "ICTBROADCAST_BASE_URL": "<ICTBROADCAST_BASE_URL>",
        "ICTBROADCAST_USERNAME": "<ICTBROADCAST_USERNAME>",
        "ICTBROADCAST_PASSWORD": "<ICTBROADCAST_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ictbroadcast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictbroadcast-mcp"
      ],
      "env": {
        "ICTBROADCAST_BASE_URL": "<ICTBROADCAST_BASE_URL>",
        "ICTBROADCAST_USERNAME": "<ICTBROADCAST_USERNAME>",
        "ICTBROADCAST_PASSWORD": "<ICTBROADCAST_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ictbroadcast-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ictbroadcast-mcp"
      ],
      "env": {
        "ICTBROADCAST_BASE_URL": "<ICTBROADCAST_BASE_URL>",
        "ICTBROADCAST_USERNAME": "<ICTBROADCAST_USERNAME>",
        "ICTBROADCAST_PASSWORD": "<ICTBROADCAST_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ictbroadcast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictbroadcast-mcp"
      ],
      "env": {
        "ICTBROADCAST_BASE_URL": "<ICTBROADCAST_BASE_URL>",
        "ICTBROADCAST_USERNAME": "<ICTBROADCAST_USERNAME>",
        "ICTBROADCAST_PASSWORD": "<ICTBROADCAST_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ictbroadcast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictbroadcast-mcp"
      ],
      "env": {
        "ICTBROADCAST_BASE_URL": "<ICTBROADCAST_BASE_URL>",
        "ICTBROADCAST_USERNAME": "<ICTBROADCAST_USERNAME>",
        "ICTBROADCAST_PASSWORD": "<ICTBROADCAST_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `ictbroadcast_list_campaigns`: List campaigns (id and name).
- `ictbroadcast_campaign_status`: Live status of a campaign.
- `ictbroadcast_campaign_summary`: Totals: answered, failed, human vs machine.
- `ictbroadcast_campaign_result`: Per-call results with contact, response, AMD and DNC.
- `ictbroadcast_start_campaign`: Launch a campaign; only when writes are enabled.
- `ictbroadcast_stop_campaign`: Stop a running campaign; only when writes are enabled.

## FAQ

### Can it start calls by default?

No. Start and stop tools are not registered unless ICTBROADCAST_MCP_ALLOW_WRITE is true.

### What does it need?

An ICTBroadcast server URL and an API account username and password.

### Which edition has the REST API?

The README says it is bundled with the Service Provider edition.

### What licence is the server?

MIT.

### Is Ictbroadcast MCP free?

Yes. Ictbroadcast MCP is open source, so you can use and self-host it for free.

### How do I add Ictbroadcast MCP to Claude Code?

Run this command in your terminal: claude mcp add ictbroadcast-mcp --env ICTBROADCAST_BASE_URL='<ICTBROADCAST_BASE_URL>' --env ICTBROADCAST_USERNAME='<ICTBROADCAST_USERNAME>' --env ICTBROADCAST_PASSWORD='<ICTBROADCAST_PASSWORD>' -- npx -y ictbroadcast-mcp

### What are the best alternatives to Ictbroadcast MCP?

The closest alternatives to Ictbroadcast MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/ictbroadcast-mcp
