Kanadr hosted PBX — Claude Code MCP server: features and setup
This MCP server for Claude Code connects an assistant to a Kanadr hosted PBX. It handles tasks such as checking call records or changing call routing.
no license updated 2026-10-31
Open on GitHubWhat Kanadr hosted PBX does
The server exposes Kanadr portal operations as tools for an AI assistant. Those tools cover customers, phone numbers, trunks, call flows, call logs and rating.
Each portal has its own address, which replaces {portal} in the connection URL. Access uses OAuth or an API key created in the portal’s API section; the key inherits the permissions of its assigned role. The assistant asks for confirmation before making a change, and writes are recorded in the audit log.
What it helps with
- identify trunks that are failing and find when the issue began
- list a reseller’s customers with their extension counts
- investigate why a customer extension will not register
- change call forwarding through the portal API
Example prompts for the agent
- Find the trunks that are failing and tell me when the problem started.
- List reseller Example’s customers and count their extensions.
- Investigate why extension 100 for customer Example is not registering.
How to install Kanadr hosted PBX
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http pbx https://{portal}/api/v1/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add kanadr-hosted-pbx --url https://{portal}/api/v1/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"kanadr-hosted-pbx": {
"url": "https://{portal}/api/v1/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"kanadr-hosted-pbx": {
"type": "http",
"url": "https://{portal}/api/v1/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http kanadr-hosted-pbx https://{portal}/api/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Kanadr hosted PBX
How do I install Kanadr hosted PBX in Claude Code?
Run claude mcp add --transport http pbx https://{portal}/api/v1/mcp, replacing {portal} with the Kanadr portal address. In Claude Code, open /mcp and select Authenticate.
What does Kanadr hosted PBX do?
It connects an assistant to the Kanadr portal API, exposing tools for customer, number, trunk, call-flow and call-log tasks.
What does Kanadr hosted PBX need to work?
It needs the Kanadr portal address and authorization through OAuth or an API key. The key’s permissions follow the role assigned to it in the portal.