Server data from the Official MCP Registry
Read ICTPBX state: extensions, DID numbers, SIP trunks, tenants and live PBX statistics.
About
Read ICTPBX state: extensions, DID numbers, SIP trunks, tenants and live PBX statistics.
Security Report
Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (3/3 approved).
8 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: ICTPBX_BASE_URL
Environment variable: ICTPBX_USERNAME
Environment variable: ICTPBX_PASSWORD
Environment variable: ICTPBX_TIMEOUT_MS
Environment variable: ICTPBX_TLS_INSECURE
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-ictinnovations-ictpbx-mcp": {
"env": {
"ICTPBX_BASE_URL": "your-ictpbx-base-url-here",
"ICTPBX_PASSWORD": "your-ictpbx-password-here",
"ICTPBX_USERNAME": "your-ictpbx-username-here",
"ICTPBX_TIMEOUT_MS": "your-ictpbx-timeout-ms-here",
"ICTPBX_TLS_INSECURE": "your-ictpbx-tls-insecure-here"
},
"args": [
"-y",
"ictpbx-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
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.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption