Skillget

ictpbx-mcp

mcp
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 16 GitHub stars
Code Warn
  • network request — Outbound network request in src/client.ts
  • process.env — Environment variable access in src/config.ts
  • process.env — Environment variable access in src/index.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Read-only MCP server for ICTPBX — extensions, DIDs, SIP trunks, tenants and PBX statistics over ICTCore REST. By ICT Innovations.

README.md

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": "[email protected]",
        "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.

Reviews (0)

No results found