MCP Server

Active

MIT

io.github.ictinnovations/ictpbx-mcp MCP Server

io.github.ictinnovations/ictpbx-mcp

Read ICTPBX PBX state—extensions, DIDs, SIP trunks, tenants, and live statistics via MCP.

What is the io.github.ictinnovations/ictpbx-mcp MCP server?

The ictpbx-mcp server is a Model Context Protocol integration for ICTPBX, the multi-tenant IP-PBX built on ICTCore. It provides read-only access to PBX state including extensions, DID numbers, SIP trunk providers, tenants, and live statistics through the ICTCore REST API.

This server connects Claude or other AI assistants to your ICTPBX installation, allowing them to query and report on PBX configuration and status. It's read-only—it retrieves information about extensions, inbound numbers, upstream carriers, customer tenants, and system statistics, but never places calls or modifies settings.

How to install io.github.ictinnovations/ictpbx-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ICTPBX_BASE_URL
required
ICTCore REST base URL of your ICTPBX server, normally ending in /api, e.g. https://your-ictpbx/api.
ICTPBX_USERNAME
required
API account email (ICTCore logs in by email).
ICTPBX_PASSWORD
required
secret
Password for the account.
ICTPBX_TIMEOUT_MS
Per request timeout in milliseconds. Defaults to 30000.
ICTPBX_TLS_INSECURE
Skip TLS certificate verification. Only for a self-signed test server.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ictpbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<YOUR_ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<YOUR_ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<YOUR_ICTPBX_PASSWORD>",
        "ICTPBX_TIMEOUT_MS": "<YOUR_ICTPBX_TIMEOUT_MS>",
        "ICTPBX_TLS_INSECURE": "<YOUR_ICTPBX_TLS_INSECURE>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

ictpbx_pbx_statistics — Retrieve counts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences, and gateways
ictpbx_list_extensions — List SIP extensions with username, name, and tenant information
ictpbx_list_dids — List DID (inbound) numbers, their active state, and assigned tenant
ictpbx_list_providers — List SIP trunk providers (upstream carriers)
ictpbx_list_tenants — List all tenants (customer organizations) on the PBX

Use cases

Query current PBX capacity and resource usage (extensions, queues, conferences)
Look up extension details and tenant assignments for troubleshooting
Review active DID numbers and their routing assignments
Check SIP trunk provider configuration and availability
Generate reports on multi-tenant PBX state and organization structure

io.github.ictinnovations/ictpbx-mcp MCP server FAQ

What is the ictpbx-mcp server?

It's a read-only MCP integration for ICTPBX that lets AI assistants query extensions, DID numbers, SIP trunks, tenants, and live PBX statistics via the ICTCore REST API.

Is it free?

Yes, it's MIT licensed and open source on GitHub.

How do I install it in Claude Desktop?

Add it to your Claude Desktop config.json under mcpServers with the npx command and set ICTPBX_BASE_URL, ICTPBX_USERNAME, and ICTPBX_PASSWORD environment variables.

What authentication is required?

You need an ICTCore API account (email and password) and the base URL of your ICTPBX REST API endpoint.

Can it make calls or change PBX settings?

No, it is read-only. It only retrieves information about your PBX state and never modifies configuration or places calls.

What Node.js version is required?

Node.js 18 or newer.

README (reference)

Source of truth, from the repository.

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.

Install

npx -y ictpbx-mcp      # no install
npm install -g ictpbx-mcp

Requires Node.js 18 or newer.

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`	no	`30000`	Per-request timeout
`ICTPBX_TLS_INSECURE`	no	`false`	Skip TLS verification — self-signed test servers only

Claude Desktop example

{
  "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

How it connects

ICTPBX runs on ICTCore, which authenticates with a JWT from POST /authenticate (login by email) and reads it back from the Authorization: Bearer header. The server fetches the token on first use and refreshes it automatically.

About

Built by Tahir Almas at ICT Innovations — the team behind ICTPBX, ICTContact, ICTDialer, ICTFax and the ICTCore framework these products share. Learn more at ictpbx.com.

MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictpbx-mcp.

Related MCP servers

io.github.ictinnovations/pbx-mcp

Active

Inspect and control Asterisk (AMI) and FreeSWITCH (ESL) PBX servers from your AI assistant.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictbroadcast-mcp

Active

Monitor and control ICTBroadcast voice, SMS, and fax campaigns from Claude or Cursor.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictcontact-mcp

Active

Monitor and control ICTContact/ICTDialer outbound campaigns via AI assistant.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictcrm-mcp

Active

Read CRM contact groups and manage contacts on ICTCRM (ICTContact backend).

TypeScript

MIT

View repository →

T-Bank MCP

Active

T-Bank mobile banking API for Claude, Cursor, and other MCP agents—accounts, cards, transfers, tickets, travel, grocery.

Python

MIT

View repository →

Icyn Date

Active

Date context for agents: Chinese lunar calendar, solar terms, holidays for 12 regions. Offline.

TypeScript

MIT

View repository →