ictcontact-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ictcontact-mcp List my campaigns and show their current status."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ictcontact-mcp
A Model Context Protocol server for ICTContact and its hosted edition ICTDialer.com — the same contact-center engine 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 ictcontact-mcp # no install
npm install -g ictcontact-mcpRequires Node.js 18 or newer.
Related MCP server: ictbroadcast-mcp
Configure
Variable | Required | Default | |
| yes | Server base URL, without the | |
| yes | API account username | |
| yes | Password for that account | |
| no |
| Unlock start/stop campaign (see Safety) |
| no |
| Per-request timeout |
| no |
| Skip TLS verification — self-signed test servers only |
Claude Desktop example
{
"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 |
| List campaigns (id and name) |
| Live status of a campaign (running, stopped) |
| Totals: answered, failed, human vs machine |
| Per-call results (contact, response, AMD, DNC) |
Write tools appear only when ICTCONTACT_MCP_ALLOW_WRITE=true:
Tool | What it does |
| Launch a campaign — begins live outbound calling |
| 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 ictcontact_start_campaign and
ictcontact_stop_campaign are not registered at all unless you set
ICTCONTACT_MCP_ALLOW_WRITE=true.
How it connects
ICTContact and ICTDialer expose 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 ICTContact, ICTDialer, ICTBroadcast, ICTFax and ICTPBX. Learn more at ictcontact.com and ictdialer.com.
MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictcontact-mcp.
Available Tools
4 toolsictcontact_campaign_resultCampaign call resultsARead-only
Per-call results for a campaign (contact, response, answering-machine detection, DNC), optionally filtered by call status.
Inputs: campaign_id (required), status.
ictcontact_campaign_statusCampaign statusARead-only
Live status of a campaign by id (for example running or stopped). Poll this while a campaign runs.
Inputs: campaign_id (required).
ictcontact_campaign_summaryCampaign summaryBRead-only
Totals for a campaign: answered, failed, human vs machine and so on. Optionally scope to one agent/user id.
Inputs: campaign_id (required), usr_id.
ictcontact_list_campaignsList campaignsARead-only
List the outbound campaigns on the ICTContact / ICTDialer server (id and name of each). Start here to find a campaign id.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct facet: list_campaigns (enumeration), campaign_status (live run state), campaign_summary (aggregate totals), campaign_result (per-call rows). campaign_summary and campaign_result overlap somewhat in reporting on outcomes, but the aggregate-vs-row distinction is clear enough from the descriptions.
All tools share the ictcontact_ prefix and campaign-related names, with a predictable noun_component pattern for three of them. list_campaigns breaks the noun-first pattern by using a verb prefix, a minor deviation that remains readable.
Four tools is on the thin side for a dialer/campaign integration; the surface covers only read/monitoring operations. It is not extreme, but the set feels like a narrow slice of the domain rather than a well-rounded toolkit.
The surface is entirely read-only: you can list, monitor status, and pull summaries/results, but there is no way to start, stop, create, or control a campaign — despite status tooling explicitly advising polling while a campaign runs. This dead end limits agents to observation only.
Maintenance
Related MCP Connectors
Manage AI assistants, history, calls, campaigns, contacts, knowledge, messaging, and automations.
AI dialer: add and find leads, list campaigns, and have the AI agent call a lead now.
Manage your Telvana AI voice, SMS and chat agents, conversations, campaigns and outbound calls.
Manage SalesCloser AI sales agents, leads, campaigns and calls from your AI assistant.
Related MCP Servers
AlicenseAqualityBmaintenanceThis MCP server enables AI assistants to read PBX state—extensions, DID numbers, SIP trunk providers, tenants, and live statistics—from ICTPBX via the ICTCore REST API, without placing calls or changing configuration.543 npm16MIT
ictbroadcast-mcpofficial
AlicenseAqualityBmaintenanceEnables AI assistants to monitor ICTBroadcast outbound voice, SMS, and fax campaigns by listing campaigns, checking status, and reading summaries and per-call results, with optional start/stop control when write access is enabled.438 npm16MIT
ictcrm-mcpofficial
AlicenseAqualityBmaintenanceEnables AI assistants to read ICTCRM contact groups and, when write access is enabled, create or delete contacts and add contacts to campaigns.141 npm1MIT
ictdialer-mcpofficial
AlicenseBqualityBmaintenanceEnables AI assistants to monitor ICTDialer outbound campaigns by listing them, checking status, and reading summaries and per-call results, with optional start and stop capabilities when write access is enabled.447 npm16MIT