Pbx MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add pbx-mcp -- npx -y pbx-mcp

{
  "mcpServers": {
    "pbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pbx-mcp"
      ]
    }
  }
}

[mcp_servers.pbx-mcp]
command = "npx"
args = ["-y", "pbx-mcp"]

{
  "mcpServers": {
    "pbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pbx-mcp"
      ]
    }
  }
}

{
  "servers": {
    "pbx-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pbx-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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 (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 (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).