English Français العربية

io.github.ictinnovations/ictcontact-mcp

السجل الرسمي أخرى

Monitor ICTContact / ICTDialer outbound campaigns, and start and stop them when writes are on.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package ictcontact-mcp
Claude Code 
claude mcp add ictcontact-mcp -e 'ICTCONTACT_BASE_URL=<ICTCONTACT_BASE_URL>' -e 'ICTCONTACT_USERNAME=<ICTCONTACT_USERNAME>' -e 'ICTCONTACT_PASSWORD=<your ictcontact_password>' -e 'ICTCONTACT_MCP_ALLOW_WRITE=false' -e 'ICTCONTACT_TIMEOUT_MS=30000' -e 'ICTCONTACT_TLS_INSECURE=false' -- npx -y ictcontact-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ictcontact-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ictcontact-mcp@0.1.1"
            ],
            "env": {
                "ICTCONTACT_BASE_URL": "<ICTCONTACT_BASE_URL>",
                "ICTCONTACT_USERNAME": "<ICTCONTACT_USERNAME>",
                "ICTCONTACT_PASSWORD": "<your ictcontact_password>",
                "ICTCONTACT_MCP_ALLOW_WRITE": "false",
                "ICTCONTACT_TIMEOUT_MS": "30000",
                "ICTCONTACT_TLS_INSECURE": "false"
            }
        }
    }
}

متغيرات البيئة

  • ICTCONTACT_BASE_URL إلزامي Base URL of your ICTContact / ICTDialer server, without the /rest suffix, e.g. https://your-ictcontact.
  • ICTCONTACT_USERNAME إلزامي API account username.
  • ICTCONTACT_PASSWORD إلزامي سري Password for the account.
  • ICTCONTACT_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.
  • ICTCONTACT_TIMEOUT_MS Per request timeout in milliseconds. Defaults to 30000.
  • ICTCONTACT_TLS_INSECURE Skip TLS certificate verification. Only for a self-signed test server.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ictcontact-mcp
  2. Install
  3. Configure
  4. Tools
  5. Safety
  6. How it connects
  7. About

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-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTCONTACT_BASE_URLyesServer base URL, without the /rest suffix, e.g. https://your-ictcontact
ICTCONTACT_USERNAMEyesAPI account username
ICTCONTACT_PASSWORDyesPassword for that account
ICTCONTACT_MCP_ALLOW_WRITEnofalseUnlock start/stop campaign (see Safety)
ICTCONTACT_TIMEOUT_MSno30000Per-request timeout
ICTCONTACT_TLS_INSECUREnofalseSkip 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:

ToolWhat it does
ictcontact_list_campaignsList campaigns (id and name)
ictcontact_campaign_statusLive status of a campaign (running, stopped)
ictcontact_campaign_summaryTotals: answered, failed, human vs machine
ictcontact_campaign_resultPer-call results (contact, response, AMD, DNC)

Write tools appear only when ICTCONTACT_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictcontact_start_campaignLaunch a campaign — begins live outbound calling
ictcontact_stop_campaignStop 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.

الأسئلة الشائعة

ما هو io.github.ictinnovations/ictcontact-mcp؟

Monitor ICTContact / ICTDialer outbound campaigns, and start and stop them when writes are on.

كيف أثبّت io.github.ictinnovations/ictcontact-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add ictcontact-mcp -e 'ICTCONTACT_BASE_URL=<ICTCONTACT_BASE_URL>' -e 'ICTCONTACT_USERNAME=<ICTCONTACT_USERNAME>' -e 'ICTCONTACT_PASSWORD=<your ictcontact_password>' -e 'ICTCONTACT_MCP_ALLOW_WRITE=false' -e 'ICTCONTACT_TIMEOUT_MS=30000' -e 'ICTCONTACT_TLS_INSECURE=false' -- npx -y ictcontact-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ictinnovations/ictcontact-mcp إلى مفتاح API؟

نعم. يتطلب ICTCONTACT_BASE_URL, ICTCONTACT_USERNAME, ICTCONTACT_PASSWORD، وتضبطها في إعداداته.

هل io.github.ictinnovations/ictcontact-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ictinnovations/ictcontact-mcp؟

ينشره ictinnovations. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.