io.github.ictinnovations/pbx-mcp

io.github.ictinnovations/pbx-mcp

Inspect and control Asterisk (AMI) and FreeSWITCH (ESL) PBX servers from your AI assistant.

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "pbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pbx-mcp@0.1.4"
      ],
      "env": {
        "ASTERISK_AMI_PORT": "5038",
        "ASTERISK_AMI_PASSWORD": "<your ASTERISK_AMI_PASSWORD>",
        "ASTERISK_AMI_TLS": "false",
        "FREESWITCH_ESL_PORT": "8021",
        "FREESWITCH_ESL_PASSWORD": "<your FREESWITCH_ESL_PASSWORD>",
        "PBX_MCP_ALLOW_WRITE": "false",
        "PBX_MCP_TIMEOUT_MS": "10000"
      }
    }
  }
}
Environment variables
  • ASTERISK_AMI_PORTAsterisk Manager Interface port. Defaults to 5038.
  • ASTERISK_AMI_PASSWORDsecretAMI secret from manager.conf.
  • ASTERISK_AMI_TLSConnect to AMI over TLS. Set true if tlsenable=yes in manager.conf.
  • FREESWITCH_ESL_PORTFreeSWITCH inbound event socket port. Defaults to 8021.
  • FREESWITCH_ESL_PASSWORDsecretEvent socket password from event_socket.conf.xml. Defaults to ClueCon, which you should change.
  • PBX_MCP_ALLOW_WRITEUnlocks call control. When false the server is read-only and the originate and hangup tools are not registered at all. Placing a call on a live trunk costs real money, so leave this off unless you mean it.
  • PBX_MCP_TIMEOUT_MSPer command timeout in milliseconds. Defaults to 10000.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.1.4
Registry
active
Published
10/26/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that io.github.ictinnovations/pbx-mcp is listed here — it’s also the link we check for a free listing.

io.github.ictinnovations/pbx-mcp — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-ictinnovations-pbx-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.ictinnovations/pbx-mcp — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.ictinnovations/pbx-mcp — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-ictinnovations-pbx-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.