HomeCommunication › pbx-mcp

pbx-mcp

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

TypeScript Local macOSWindowsLinux
★ 17 stars Last pushed 2026-09-02 License: MIT

Topics: Communication

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.1.2)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "pbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ASTERISK_AMI_HOST": "<YOUR_VALUE>",
        "ASTERISK_AMI_PORT": "<YOUR_VALUE>",
        "ASTERISK_AMI_USERNAME": "<YOUR_VALUE>",
        "ASTERISK_AMI_PASSWORD": "<YOUR_VALUE>",
        "ASTERISK_AMI_TLS": "<YOUR_VALUE>",
        "FREESWITCH_ESL_HOST": "<YOUR_VALUE>",
        "FREESWITCH_ESL_PORT": "<YOUR_VALUE>",
        "FREESWITCH_ESL_PASSWORD": "<YOUR_VALUE>",
        "PBX_MCP_ALLOW_WRITE": "<YOUR_VALUE>",
        "PBX_MCP_TIMEOUT_MS": "<YOUR_VALUE>"
      }
    }
  }
}
  • ASTERISK_AMI_HOST — Hostname or IP of the Asterisk server. Set this to enable the Asterisk tools.
  • ASTERISK_AMI_PORT — Asterisk Manager Interface port. Defaults to 5038.
  • ASTERISK_AMI_USERNAME — AMI username from manager.conf.
  • ASTERISK_AMI_PASSWORD secret — AMI secret from manager.conf.
  • ASTERISK_AMI_TLS — Connect to AMI over TLS. Set true if tlsenable=yes in manager.conf.
  • FREESWITCH_ESL_HOST — Hostname or IP of the FreeSWITCH server. Set this to enable the FreeSWITCH tools.
  • FREESWITCH_ESL_PORT — FreeSWITCH inbound event socket port. Defaults to 8021.
  • FREESWITCH_ESL_PASSWORD secret — Event socket password from event_socket.conf.xml. Defaults to ClueCon, which you should change.
  • PBX_MCP_ALLOW_WRITE — Unlocks 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_MS — Per command timeout in milliseconds. Defaults to 10000.

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry