Back to Browse

Pbx MCP Server

Developer ToolsLow Risk9.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

9.8
Low Risk9.8Low Risk

Valid MCP server (2 strong, 3 medium validity signals). 1 known CVE in dependencies Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (8/8 approved).

8 files analyzed · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

database

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Hostname or IP of the Asterisk server. Set this to enable the Asterisk tools.Optional

Environment variable: ASTERISK_AMI_HOST

Asterisk Manager Interface port. Defaults to 5038.Optional

Environment variable: ASTERISK_AMI_PORT

AMI username from manager.conf.Optional

Environment variable: ASTERISK_AMI_USERNAME

AMI secret from manager.conf.Required

Environment variable: ASTERISK_AMI_PASSWORD

Connect to AMI over TLS. Set true if tlsenable=yes in manager.conf.Optional

Environment variable: ASTERISK_AMI_TLS

Hostname or IP of the FreeSWITCH server. Set this to enable the FreeSWITCH tools.Optional

Environment variable: FREESWITCH_ESL_HOST

FreeSWITCH inbound event socket port. Defaults to 8021.Optional

Environment variable: FREESWITCH_ESL_PORT

Event socket password from event_socket.conf.xml. Defaults to ClueCon, which you should change.Required

Environment variable: FREESWITCH_ESL_PASSWORD

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.Optional

Environment variable: PBX_MCP_ALLOW_WRITE

Per command timeout in milliseconds. Defaults to 10000.Optional

Environment variable: PBX_MCP_TIMEOUT_MS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-ictinnovations-pbx-mcp": {
      "env": {
        "ASTERISK_AMI_TLS": "your-asterisk-ami-tls-here",
        "ASTERISK_AMI_HOST": "your-asterisk-ami-host-here",
        "ASTERISK_AMI_PORT": "your-asterisk-ami-port-here",
        "PBX_MCP_TIMEOUT_MS": "your-pbx-mcp-timeout-ms-here",
        "FREESWITCH_ESL_HOST": "your-freeswitch-esl-host-here",
        "FREESWITCH_ESL_PORT": "your-freeswitch-esl-port-here",
        "PBX_MCP_ALLOW_WRITE": "your-pbx-mcp-allow-write-here",
        "ASTERISK_AMI_PASSWORD": "your-asterisk-ami-password-here",
        "ASTERISK_AMI_USERNAME": "your-asterisk-ami-username-here",
        "FREESWITCH_ESL_PASSWORD": "your-freeswitch-esl-password-here"
      },
      "args": [
        "-y",
        "pbx-mcp"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!