Ictpbx Mcp

io.github.ictinnovationsPublished by GitHub account ictinnovationsv0.1.1Updated Oct 26, 2026

Read ICTPBX state: extensions, DID numbers, SIP trunks, tenants and live PBX statistics.

Overview

AI-generated overview

Read-only MCP server that lets an assistant inspect an ICTPBX (ICTCore) phone system: extensions, DIDs, SIP trunks, tenants and PBX statistics.

What you can do
  • Get a health picture of the PBX with counts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences and gateways
  • List SIP extensions with username, name, tenant and account id
  • List DID inbound numbers with active state, tenant and linked contact
  • List SIP trunk providers with name, host and tenant
  • List tenants (customer organizations) with company, contact and limits
When to use it
Useful when you administer or support a multi-tenant ICTPBX deployment and want an assistant to answer questions about what extensions, inbound numbers, trunks and tenants exist, or to give a quick overview of server state without opening the admin UI.
Requirements
Runs locally via npx or a global npm install, requiring Node.js 18 or newer. Needs an ICTCore REST base URL ending in /api (ICTPBX_BASE_URL), an API account email (ICTPBX_USERNAME) and its password (ICTPBX_PASSWORD); optional request timeout (ICTPBX_TIMEOUT_MS) and TLS verification skip (ICTPBX_TLS_INSECURE). Network access to the PBX server is required.
Before you install
The account password is passed in the ICTPBX_PASSWORD environment variable, so keep it out of shared configs and repositories. The server logs in with that account's credentials and holds a JWT token for the session. ICTPBX_TLS_INSECURE disables certificate verification and should only be used against self-signed test servers. Tools are described as read-only, but the account's own permissions still govern what it can reach.

Installation

In SourceWeft

  1. Open Ictpbx Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npx -y ictpbx-mcp      # no installnpm install -g ictpbx-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTPBX_BASE_URLyesICTCore REST base, normally ending in /api, e.g. https://your-ictpbx/api
ICTPBX_USERNAMEyesAPI account email (ICTCore logs in by email)
ICTPBX_PASSWORDyesPassword for that account
ICTPBX_TIMEOUT_MSno30000Per-request timeout
ICTPBX_TLS_INSECUREnofalseSkip 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": "[email protected]",        "ICTPBX_PASSWORD": "your-password"      }    }  }}

Tools

ToolWhat it does
ictpbx_pbx_statisticsCounts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences, gateways
ictpbx_list_extensionsSIP extensions with username, name, tenant
ictpbx_list_didsDID (inbound) numbers, active state and tenant
ictpbx_list_providersSIP trunk providers (upstream carriers)
ictpbx_list_tenantsTenants (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.

Source: README.md at commit e5ee340

Tools

5

ictpbx_pbx_statistics

PBX statistics

Counts across the PBX: extensions, devices, ring groups, call queues, IVR menus, voicemails, conferences and gateways. Use this first for a quick health picture of the server.

Takes no parameters.

ictpbx_list_extensions

List extensions

List SIP extensions on the PBX with their username, name, tenant and account id. Use this to answer 'what extensions exist' or to find an extension's tenant.

Takes no parameters.

ictpbx_list_dids

List DID numbers

List DID (inbound phone) numbers on the PBX: the number, whether it is active, its tenant and the contact it is tied to.

Takes no parameters.

ictpbx_list_providers

List SIP trunk providers

List the SIP trunk providers (upstream carriers) configured on the PBX: name, host and tenant.

Takes no parameters.

ictpbx_list_tenants

List tenants

List the tenants (customer organizations) on this multi-tenant PBX: company, contact and limits. Use this to see who the white-label PBX is serving.

Takes no parameters.

Version history

2
  1. v0.1.1LatestOct 26, 2026
  2. v0.1.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts