Kanadr MCP server
Commit Oct 31, 2026Manage a white-label hosted PBX including customers, phone numbers, trunks, call flows, and call logs through an AI assistant.
Also known as kanadr/api, api
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.8.0
- Last commit
- Oct 31, 2026
- License
- —
What is Kanadr MCP?
Kanadr manages a white-label hosted PBX including customers, phone numbers, trunks, call flows, and call logs through an AI assistant.
Summary generated from the project's README
About Kanadr MCP server
Telecom operators managing white-label hosted PBX systems can control their entire infrastructure through an AI assistant. This server connects to a specific Kanadr portal to manage customers, phone numbers, trunks, call flows, devices, and call logs. It provides access to over 200 API paths, allowing for deep administrative tasks like checking diagnostics, rating, or webhooks.
Users connect via a streamable HTTP transport by pointing their client to their unique portal address. Authentication is handled through an API key with specific role permissions or via OAuth for web-based assistants like Claude.ai or ChatGPT. The assistant requires manual confirmation before performing any write operations, and every change is recorded in an audit log under the name of the user or the specific API key used.
Integration is straightforward for developers using Claude Code, Codex, or Mistral Vibe. By setting the Accept-Language header to English, the assistant receives tool descriptions in English, though the underlying specification also supports French. The monCompte tool allows the assistant to identify the connected account and organization immediately.
What you can do with it
- 1Troubleshoot trunk connectivity issuesAsk the assistant to identify which trunks are currently failing and determine when the failures started.
- 2Audit client extension countsRequest a list of all clients belonging to a specific reseller along with their total number of extensions.
- 3Diagnose device registration problemsInvestigate why a specific extension is failing to register on the network.
Written from the project's README. Every use case is checked against a quote from it.
How to install Kanadr MCP
Kanadr gives each account its own endpoint, so there is no address to copy here. Get yours from the provider, put it in place of the part in braces, and add it to your client as a remote server.
https://{portal}/api/v1/mcp
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekanadr/api is public and reachablegithub.com/kanadr/api ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-10github.com/kanadr/api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: unreachableFinding
README
View on GitHubKanadr 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 contact@kanadr.com.
Kanadr MCP questions
Does the assistant perform changes automatically?
No, the assistant will ask for user confirmation before making any changes, and all writes are recorded in the audit log.
In what language are the tool descriptions provided?
Tool descriptions can be retrieved in English by sending the Accept-Language: en header.