ictcontact-mcp (Model Context Protocol) Server

A Model Context Protocol (MCP) server for ICTContact and its hosted edition ICTDialer. It monitors outbound campaigns by listing them, checking their status, and retrieving read summaries and per-call results. It can start and stop campaigns, but only when writes are turned on.

🛠️ Key Features

Monitor outbound campaigns (list, status checks)
Retrieve read summaries and per-call results
Start and stop campaigns gated by “writes are on”
Implements the Model Context Protocol for integration

🚀 Use Cases

Observability for ICTContact/ICTDialer outbound campaign operations
AI-assisted review of campaign status and per-call outcomes
Controlled campaign control workflows with write access enabled

⚡ Developer Benefits

MCP-compatible interface for contacting a contact-center engine
Separation of read monitoring vs. write-enabled control

⚠️ Limitations

Campaign start/stop requires writes to be enabled
Limited to monitoring and controlling ICTContact/ICTDialer campaigns

Metadata

Slug: io-github-ictinnovations-ictcontact-mcp
Topics: ai-agent, claude, contact-center, ictcontact, ictdialer, mcp, model-context-protocol, predictive-dialer, voip

ictcontact-mcp

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.

Configure

Variable

Required

Default

ICTCONTACT_BASE_URL

yes

Server base URL, without the /rest suffix, e.g. https://your-ictcontact

ICTCONTACT_USERNAME

yes

API account username

ICTCONTACT_PASSWORD

yes

Password for that account

ICTCONTACT_MCP_ALLOW_WRITE

false

Unlock start/stop campaign (see Safety)

ICTCONTACT_TIMEOUT_MS

30000

Per-request timeout

ICTCONTACT_TLS_INSECURE

false

Skip 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:

Tool

What it does

ictcontact_list_campaigns

List campaigns (id and name)

ictcontact_campaign_status

Live status of a campaign (running, stopped)

ictcontact_campaign_summary

Totals: answered, failed, human vs machine

ictcontact_campaign_result

Per-call results (contact, response, AMD, DNC)

Write tools appear only when ICTCONTACT_MCP_ALLOW_WRITE=true:

Tool

What it does

ictcontact_start_campaign

Launch a campaign — begins live outbound calling

ictcontact_stop_campaign

Stop a running campaign

Install

Configuration

Environment variables

ICTCONTACT_BASE_URLrequired

Base URL of your ICTContact / ICTDialer server, without the /rest suffix, e.g. https://your-ictcontact.

ICTCONTACT_USERNAMErequired

API account username.

ICTCONTACT_PASSWORDrequiredsecret

Password for the account.

ICTCONTACT_MCP_ALLOW_WRITEdefault false

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.

ICTCONTACT_TIMEOUT_MSdefault 30000

Per request timeout in milliseconds. Defaults to 30000.

ICTCONTACT_TLS_INSECUREdefault false

Skip TLS certificate verification. Only for a self-signed test server.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ictcontact-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcontact-mcp@0.1.0"
      ],
      "env": {
        "ICTCONTACT_BASE_URL": "<YOUR_ICTCONTACT_BASE_URL>",
        "ICTCONTACT_USERNAME": "<YOUR_ICTCONTACT_USERNAME>",
        "ICTCONTACT_PASSWORD": "<YOUR_ICTCONTACT_PASSWORD>",
        "ICTCONTACT_MCP_ALLOW_WRITE": "false",
        "ICTCONTACT_TIMEOUT_MS": "30000",
        "ICTCONTACT_TLS_INSECURE": "false"
      }
    }
  }
}

io.github.ictinnovations/ictcontact-mcp

ictcontact-mcp (Model Context Protocol) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Metadata

Topics

ictcontact-mcp

Install

Configure

Claude Desktop example

Tools

Safety

How it connects

About

Install

Configuration

Related servers