About Kanadr hosted PBX
Kanadr provides an OpenAPI specification and connection examples for managing a white-label hosted PBX used by telecom operators. Its portal API covers customer, telephony, call-flow, log, and diagnostic operations.
Key features
- 01OpenAPI specification in English and French
- 02Manage customers, numbers, and trunks
- 03Configure call flows and devices
- 04Review call logs, rating, and diagnostics
- 05Ready-made MCP client configurations
Use cases
- 01Inspect failing trunks and registration issues
- 02List reseller customers and their extensions
- 03Connect an AI assistant to a Kanadr portal
MCP support
Each Kanadr portal exposes its API operations as tools through a streamable HTTP MCP server. The repository includes client configurations, and changes require user confirmation and are recorded in an audit log.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://{portal}/api/v1/mcpclaude mcp add --transport http com-kanadr-pbx https://{portal}/api/v1/mcp{"mcpServers":{"com-kanadr-pbx":{"type":"http","url":"https://{portal}/api/v1/mcp"}}}Open in Cursor{"servers":{"com-kanadr-pbx":{"type":"http","url":"https://{portal}/api/v1/mcp"}}}Open in VS Code{"mcpServers":{"com-kanadr-pbx":{"type":"http","url":"https://{portal}/api/v1/mcp"}}}{"mcpServers":{"com-kanadr-pbx":{"serverUrl":"https://{portal}/api/v1/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEKanadr API and MCP examples
This repository holds the OpenAPI specification of the Kanadr API and ready-to-use configurations for connecting AI assistants to a Kanadr portal through its MCP server.
Kanadr is a white-label hosted PBX for telecom operators. Every portal action goes through this API: customers, numbers, trunks, call flows, devices, call logs, rating, webhooks and diagnostics. The specification lists more than 200 paths, documented in English and French.
Contents
| Path | What it is |
|---|---|
openapi/openapi.en.json | OpenAPI specification, English descriptions |
openapi/openapi.json | Same specification, French descriptions |
mcp/ | MCP client configurations: Claude Code, Codex, Mistral Vibe, OpenAI Responses API, generic JSON |
examples/ | Plain HTTP calls with curl |
The browsable reference is at docs.kanadr.com/api/en. A plain list of every operation is also available.
Authentication
- API key: create one in the portal under API, then API keys. Send it as
Authorization: Bearer cx_…. The key has exactly the rights of the role you give it, so start with a read-only role. - OAuth: web assistants such as claude.ai, ChatGPT and Le Chat use OAuth instead. You add the server address without a key, sign in to the portal and approve the access.
Each Kanadr portal has its own address. In the examples, replace portal.example with yours.
MCP server
Each portal exposes an MCP server at https://portal.example/api/v1/mcp (streamable HTTP). Each API operation is a tool with the same name, for example listerClients or reglerRenvois. Send Accept-Language: en to get the tool descriptions in English. The monCompte tool returns the connected account and its organization. Before any change, the assistant asks the user to confirm. Every write is recorded in the audit log under the user's or the key's name.
Quick start with Claude Code:
claude mcp add --transport http phone https://portal.example/api/v1/mcp
Then run /mcp in Claude Code and choose Authenticate. The other clients are in mcp/. The full guide is in the MCP documentation.
Example requests:
- "Which trunks are failing, and since when?"
- "List the clients of reseller Example with their number of extensions."
- "Why isn't extension 100 of client Example registering?"
Licence
The configuration files and examples in mcp/ and examples/ are under the MIT licence. The OpenAPI specification describes Kanadr, a commercial product. It is published so that you can build integrations against it.
Contact
Kanadr is a brand of Archel SAS, France. To ask for a demo instance, go to kanadr.com/en/contact. You can also write to [email protected].
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.