Skip to content
MCP server

Ictpbx MCP

Read ICTPBX extensions, DIDs, SIP trunks, tenants and live statistics

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • ICTPBX_USERNAMEAPI account email (ICTCore logs in by email).Required
  • ICTPBX_PASSWORDPassword for the account.Required
  • ICTPBX_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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity