Ictpbx MCP
Read ICTPBX extensions, DIDs, SIP trunks, tenants and live statistics
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 2 days ago
About Ictpbx MCP
Ictpbx MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
What it reads is limited to the ICTPBX state exposed through the ICTCore REST API, and it is read-only: it never places a call or changes configuration. ICTPBX itself is an open-source, multi-tenant, white-label PBX built on FreeSWITCH for service providers.
The server logs in by email with an API account, fetches a JWT on first use and refreshes it automatically. Five tools return PBX counts, SIP extensions, DID numbers, SIP trunk providers and tenants. Configuration needs the ICTCore base URL, normally ending in /api, a username and a password; a TLS-insecure option exists for self-signed test servers only.
It installs with npx and needs Node 18 or newer. ICT Innovations, the maker of ICTPBX, publishes it under the MIT licence. ICTPBX runs as a monthly cloud subscription or self-hosted, with a free Community Edition.
Install
Run in a terminal
claude mcp add ictpbx-mcp --env ICTPBX_BASE_URL='<ICTPBX_BASE_URL>' --env ICTPBX_USERNAME='<ICTPBX_USERNAME>' --env ICTPBX_PASSWORD='<ICTPBX_PASSWORD>' -- npx -y ictpbx-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ictpbx-mcp": {
"command": "npx",
"args": [
"-y",
"ictpbx-mcp"
],
"env": {
"ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
"ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
"ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ictpbx-mcp": {
"command": "npx",
"args": [
"-y",
"ictpbx-mcp"
],
"env": {
"ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
"ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
"ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ictpbx-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ictpbx-mcp"
],
"env": {
"ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
"ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
"ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ictpbx-mcp": {
"command": "npx",
"args": [
"-y",
"ictpbx-mcp"
],
"env": {
"ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
"ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
"ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ictpbx-mcp": {
"command": "npx",
"args": [
"-y",
"ictpbx-mcp"
],
"env": {
"ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
"ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
"ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
}
}
}
}Configuration
ICTPBX_BASE_URLICTCore REST base URL of your ICTPBX server, normally ending in /api, e.g. https://your-ictpbx/api.RequiredICTPBX_USERNAMEAPI account email (ICTCore logs in by email).RequiredICTPBX_PASSWORDPassword for the account.RequiredICTPBX_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 30000.ICTPBX_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- ictpbx_pbx_statistics
- Counts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences and gateways.
- ictpbx_list_extensions
- SIP extensions with username, name and tenant.
- ictpbx_list_dids
- DID numbers with active state and tenant.
- ictpbx_list_providers
- SIP trunk providers.
- ictpbx_list_tenants
- Tenants on the PBX.
What it does
- Statistics
- Counts of extensions, devices, queues, IVRs, voicemails, conferences and gateways.
- Extensions
- Lists SIP extensions with username, name and tenant.
- DID numbers
- Shows inbound numbers, state and tenant.
- SIP providers
- Lists upstream trunk carriers.
- Tenants
- Lists customer organizations on the PBX.
- Auto token refresh
- Handles JWT login and renewal.
Good for
- Ask how many extensions each tenant has
- Audit DID assignments
- List configured trunk providers
- Summarise PBX size for a report
Pricing
Open source
MIT licensed; ICTPBX itself has a free Community Edition and cloud plans
Prices change. Check ictpbx.com before you buy.
Ictpbx MCP FAQ
Can it change my PBX?
No, it is read-only.
What does it need to connect?
ICTPBX_BASE_URL, an account email and a password.
Which Node version?
18 or newer.
Is ICTPBX free?
A Community Edition is free to self-host; cloud plans start at $990 a year for Launch.
Is Ictpbx MCP free?
Yes. Ictpbx MCP is open source, so you can use and self-host it for free.
How do I add Ictpbx MCP to Claude Code?
Run this command in your terminal: claude mcp add ictpbx-mcp --env ICTPBX_BASE_URL='<ICTPBX_BASE_URL>' --env ICTPBX_USERNAME='<ICTPBX_USERNAME>' --env ICTPBX_PASSWORD='<ICTPBX_PASSWORD>' -- npx -y ictpbx-mcp
What are the best alternatives to Ictpbx MCP?
The closest alternatives to Ictpbx MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Ictpbx MCP

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity