# Kanadr hosted PBX

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: kanadr
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kanadr/api
- Updated: 2026-10-31
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/kanadr-hosted-pbx

## What it 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.

## Requirements
- Remote server: `https://{portal}/api/v1/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http pbx https://{portal}/api/v1/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add kanadr-hosted-pbx --url https://{portal}/api/v1/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kanadr-hosted-pbx": {
            "url": "https://{portal}/api/v1/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kanadr-hosted-pbx": {
            "type": "http",
            "url": "https://{portal}/api/v1/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http kanadr-hosted-pbx https://{portal}/api/v1/mcp
```

## When to use it
- 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
- 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.

## Similar
- [pbx-mcp](https://affpapa.org/en/nevibecode/mcp/pbx-mcp.md) — MCP server · ★ 20 repo stars
- [WireCat pbx](https://affpapa.org/en/nevibecode/mcp/wirecat-pbx.md) — MCP server · ★ 1 repo stars
- [self-hosted-funnel-launch](https://affpapa.org/en/nevibecode/skills/self-hosted-funnel-launch.md) — skill · 131900 installs
- [grimmory-self-hosted-library](https://affpapa.org/en/nevibecode/skills/grimmory-self-hosted-library.md) — skill · 1300 installs
- [hosted-agents](https://affpapa.org/en/nevibecode/skills/hosted-agents.md) — skill · 286 installs
- [foundry-hosted-agent-copilotkit](https://affpapa.org/en/nevibecode/skills/foundry-hosted-agent-copilotkit.md) — skill · 29 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
