# Ictcontact MCP

> Ictcontact MCP is an open-source MCP server for communication. Monitor ICTContact and ICTDialer outbound campaigns, with opt-in start and stop. 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://ictcontact.com
- **Repository:** https://github.com/ictinnovations/ictcontact-mcp
- **MCP Registry name:** io.github.ictinnovations/ictcontact-mcp
- **Categories:** communication, sales and CRM
- **Listing updated:** 2026-11-15

## About

ICTContact is a contact-centre suite with a built-in CRM, a WebRTC agent panel, IVR Studio and omnichannel campaigns, sold as a one-time licence per agent, with ICTDialer as its hosted edition. This server lets an assistant look at outbound campaigns on either: list them, check whether one is running, read answered, failed and human-versus-machine totals, and fetch per-call results with answering machine detection and do-not-call outcomes.

The default is read-only. Start and stop tools are not registered at all unless ICTCONTACT_MCP_ALLOW_WRITE is true, since launching a campaign begins live outbound calling that can cost money. It signs each call to the platform's REST API with an account username and password, so there is no token to set up, and needs the server's base URL.

It runs over stdio on Node.js 18 or newer and is MIT licensed. A TLS-skip setting 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.
- **Totals:** Reports answered, failed and human or machine counts.
- **Call-level results:** Returns contact, response, AMD and DNC for each call.
- **Opt-in writes:** Start and stop tools exist only when writes are enabled.
- **Covers both editions:** Works with ICTContact and its hosted ICTDialer.

## Good for

- Check progress of an outbound dialing campaign
- See how many calls reached humans versus machines
- Audit do-not-call handling in call results
- Stop a campaign from an assistant when writes are enabled
- Summarise campaign outcomes for a supervisor

## Install

### Claude Code (Terminal)

```sh
claude mcp add ictcontact-mcp --env ICTCONTACT_BASE_URL='<ICTCONTACT_BASE_URL>' --env ICTCONTACT_USERNAME='<ICTCONTACT_USERNAME>' --env ICTCONTACT_PASSWORD='<ICTCONTACT_PASSWORD>' -- npx -y ictcontact-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ictcontact-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcontact-mcp"
      ],
      "env": {
        "ICTCONTACT_BASE_URL": "<ICTCONTACT_BASE_URL>",
        "ICTCONTACT_USERNAME": "<ICTCONTACT_USERNAME>",
        "ICTCONTACT_PASSWORD": "<ICTCONTACT_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictcontact-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcontact-mcp"
      ],
      "env": {
        "ICTCONTACT_BASE_URL": "<ICTCONTACT_BASE_URL>",
        "ICTCONTACT_USERNAME": "<ICTCONTACT_USERNAME>",
        "ICTCONTACT_PASSWORD": "<ICTCONTACT_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "ictcontact-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ictcontact-mcp"
      ],
      "env": {
        "ICTCONTACT_BASE_URL": "<ICTCONTACT_BASE_URL>",
        "ICTCONTACT_USERNAME": "<ICTCONTACT_USERNAME>",
        "ICTCONTACT_PASSWORD": "<ICTCONTACT_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictcontact-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcontact-mcp"
      ],
      "env": {
        "ICTCONTACT_BASE_URL": "<ICTCONTACT_BASE_URL>",
        "ICTCONTACT_USERNAME": "<ICTCONTACT_USERNAME>",
        "ICTCONTACT_PASSWORD": "<ICTCONTACT_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictcontact-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcontact-mcp"
      ],
      "env": {
        "ICTCONTACT_BASE_URL": "<ICTCONTACT_BASE_URL>",
        "ICTCONTACT_USERNAME": "<ICTCONTACT_USERNAME>",
        "ICTCONTACT_PASSWORD": "<ICTCONTACT_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `ictcontact_list_campaigns`: List campaigns (id and name).
- `ictcontact_campaign_status`: Live status of a campaign.
- `ictcontact_campaign_summary`: Totals: answered, failed, human vs machine.
- `ictcontact_campaign_result`: Per-call results with contact, response, AMD and DNC.
- `ictcontact_start_campaign`: Launch a campaign; only when writes are enabled.
- `ictcontact_stop_campaign`: Stop a running campaign; only when writes are enabled.

## FAQ

### Can it launch campaigns by default?

No, start and stop tools are hidden unless ICTCONTACT_MCP_ALLOW_WRITE is true.

### Which platforms does it work with?

ICTContact and the hosted ICTDialer.

### How does it sign in?

With an API account username and password sent on each REST call.

### What licence is the server?

MIT.

### Is Ictcontact MCP free?

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

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

Run this command in your terminal: claude mcp add ictcontact-mcp --env ICTCONTACT_BASE_URL='<ICTCONTACT_BASE_URL>' --env ICTCONTACT_USERNAME='<ICTCONTACT_USERNAME>' --env ICTCONTACT_PASSWORD='<ICTCONTACT_PASSWORD>' -- npx -y ictcontact-mcp

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

The closest alternatives to Ictcontact MCP are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and BoardAgent.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [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.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.

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