io.github.ictinnovations/ictpbx-mcp — MCP Server for ICTPBX

This Model Context Protocol (MCP) server reads PBX state for ICTPBX, a multi-tenant, white-label IP-PBX built on the ICTCore framework. It exposes extensions, DID numbers, SIP trunk providers, tenants, and live PBX statistics via the ICTCore REST API for use by an AI assistant.

🛠️ Key Features

MCP server for ICTPBX / ICTCore
Read ICTPBX state: extensions, DID numbers, SIP trunks, tenants, live statistics
Integration via ICTCore REST API
Read-only behavior (no calls, no configuration changes)

🚀 Use Cases

Allow an AI assistant to retrieve current PBX state for analysis
Provide live PBX statistics alongside static configuration data
Support multi-tenant PBX visibility through tenant data

⚡ Developer Benefits

Consistent MCP interface for PBX state retrieval
Includes setup options: npx -y ictpbx-mcp or npm install -g ictpbx-mcp
Requires Node.js 18+

⚠️ Limitations

Only reads data; it never places calls or modifies configuration
Server configuration details beyond the provided excerpt are not specified here

Tags / Topics

ai-agent, claude, ictcore, ictpbx, mcp, model-context-protocol, pbx, sip, voip

ictpbx-mcp

A Model Context Protocol server for ICTPBX, the multi-tenant, white-label IP-PBX built on the ICTCore framework by ICT Innovations.

It lets an AI assistant read your PBX state — extensions, DID numbers, SIP trunk providers, tenants and live statistics — over the ICTCore REST API. It is read-only: it never places a call or changes configuration.

Configure

Variable

Required

Default

ICTPBX_BASE_URL

yes

ICTCore REST base, normally ending in /api, e.g. https://your-ictpbx/api

ICTPBX_USERNAME

yes

API account email (ICTCore logs in by email)

ICTPBX_PASSWORD

yes

Password for that account

ICTPBX_TIMEOUT_MS

30000

Per-request timeout

ICTPBX_TLS_INSECURE

false

Skip TLS verification — self-signed test servers only

Claude Desktop example

json

{
  "mcpServers": {
    "ictpbx": {
      "command": "npx",
      "args": ["-y", "ictpbx-mcp"],
      "env": {
        "ICTPBX_BASE_URL": "https://your-ictpbx/api",
        "ICTPBX_USERNAME": "admin@example.com",
        "ICTPBX_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Tool

What it does

ictpbx_pbx_statistics

Counts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences, gateways

ictpbx_list_extensions

SIP extensions with username, name, tenant

ictpbx_list_dids

DID (inbound) numbers, active state and tenant

ictpbx_list_providers

SIP trunk providers (upstream carriers)

ictpbx_list_tenants

Tenants (customer organizations) on the PBX

Install

Configuration

Environment variables

ICTPBX_BASE_URLrequired

ICTCore REST base URL of your ICTPBX server, normally ending in /api, e.g. https://your-ictpbx/api.

ICTPBX_USERNAMErequired

API account email (ICTCore logs in by email).

ICTPBX_PASSWORDrequiredsecret

Password for the account.

ICTPBX_TIMEOUT_MSdefault 30000

Per request timeout in milliseconds. Defaults to 30000.

ICTPBX_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": {
    "ictpbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp@0.1.0"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<YOUR_ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<YOUR_ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<YOUR_ICTPBX_PASSWORD>",
        "ICTPBX_TIMEOUT_MS": "30000",
        "ICTPBX_TLS_INSECURE": "false"
      }
    }
  }
}

io.github.ictinnovations/ictpbx-mcp