Pbx MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ictinnovations-pbx-mcp

About

Use cases: voice-agents, monitoring-observability

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

12 read · 4 write · 6 delete

Secrets

2 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (22)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• asterisk_channelsList active Asterisk channelsread-only

  Every channel currently up on the PBX, with caller ID, state, bridge, duration and the dialplan location it is sitting in. This is the tool for 'what calls are live right now'.

• asterisk_cliRun an Asterisk CLI command

  Run a command through the Asterisk CLI and return its raw output. In the default read-only mode only inspection commands such as 'core show', 'pjsip show' and 'queue show' are permitted. Set PBX_MCP_ALLOW_WRITE=true to lift that restriction.

• asterisk_dialplanShow dialplanread-only

  Dump the dialplan for a context, or for one extension within a context. Useful for tracing where a call would go before placing it.

• asterisk_endpointsList PJSIP endpoints and registration stateread-only

  PJSIP endpoints with their device state and how many contacts are registered. Use this to answer 'is extension 1001 registered' or 'which phones are offline'. Falls back to chan_sip peers on older installations.

• asterisk_extension_createCreate a SIP extension (registerable endpoint)

  Create a PJSIP endpoint that a phone registers to (endpoint, aor and auth, prefixed 'mcp-'). This is not a dialplan extension. The SIP username is mcp-<number>. The password is generated server-side and returned once, in this response only; it cannot be retrieved later. The context must be on PBX_MCP_CONTEXT_ALLOW. Fails if the number exists. Use dry_run=true to preview the config without touching Asterisk.

• asterisk_extension_deleteDelete a managed SIP extensioncan change or delete data

  Delete an extension created by asterisk_extension_create. Only 'mcp-' extensions in the managed file can be deleted.

• asterisk_extension_listList managed SIP extensionsread-only

  List the extensions created by asterisk_extension_create. Passwords are never shown.

• asterisk_hangupHang up a channelcan change or delete data

  Terminate an active channel by name. Get exact channel names from asterisk_channels first. Only available when PBX_MCP_ALLOW_WRITE=true.

• asterisk_hangup_previewPreview what a hangup would dropread-only

  Show which live channels a hangup would affect, without touching them. Takes the same channel argument as asterisk_hangup and reports the exact match plus any near misses, so you can see the blast radius before dropping a call. Always available, including in read-only mode.

• asterisk_originatePlace a callcan change or delete data

  Originate a call from a channel to an extension in a context. This places a real call and costs real money on a live trunk. Only available when PBX_MCP_ALLOW_WRITE=true.

• asterisk_statusAsterisk statusread-only

  Core status of the Asterisk server: version, uptime, active calls and calls processed. Use this first to confirm the PBX is reachable before running other Asterisk tools.

• asterisk_trunk_createCreate an IP-authenticated SIP trunk

  Create a PJSIP trunk (endpoint, aor and identify, all prefixed 'mcp-') to a peer that Asterisk recognises by source IP. The host must be on PBX_MCP_TRUNK_ALLOW and the context on PBX_MCP_CONTEXT_ALLOW. Fails if the name exists. Reloads res_pjsip and verifies the endpoint, rolling back on failure. Use dry_run=true to see the exact config without touching Asterisk. Codecs: ulaw, alaw, g722, g729, opus.

• asterisk_trunk_deleteDelete a managed SIP trunkcan change or delete data

  Delete a trunk created by asterisk_trunk_create. Only 'mcp-' trunks in the managed file can be deleted.

• asterisk_trunk_listList managed SIP trunksread-only

  List the trunks created by asterisk_trunk_create (only 'mcp-' objects in the managed file).

• freeswitch_apiRun a FreeSWITCH API command

  Run a command through the FreeSWITCH event socket and return its raw output. In the default read-only mode only inspection commands such as 'status', 'show' and 'sofia status' are permitted. Set PBX_MCP_ALLOW_WRITE=true to lift that restriction.

Signals

Stars

19

Forks

14

Open issues

0

Last commit

Oct 9, 2026 (20 days ago)

Last release

Oct 26, 2026 (3 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.ictinnovations/pbx-mcp

Version

0.1.4

Auth

API key

Packages

npm pbx-mcp

License

MIT

Repository

github.com/ictinnovations/pbx-mcp

Website

ictinnovations.com

First seen

Oct 24, 2026

Last checked

Oct 26, 2026

Source

Official MCP Registrygithub-graphql