mango-office-mcp
This server lets you interact with Mango Office cloud telephony via 8 tools: call history, user lists, making calls, stats, recordings, SMS, and prebuilt daily reports.
Call history: Fetch call records for a date range (
get_calls).User management: Get the list of Mango Office users (
get_users).Make calls: Initiate outbound callbacks from an internal number/SIP to a destination (
make_call).Call statistics: Get summary stats for calls over a period (
get_stats).Recordings: Retrieve play/download links for call recordings (
get_recording).Send SMS: Send text messages from an internal extension to a phone number (
send_sms).Ready-made reports: Get today's call history report (
skill_call_history) and today's call stats summary (skill_stats).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mango-office-mcp Покажи звонки за последний час"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@theyahia/mango-office-mcp
MCP server for Mango Office API — calls, users, recordings, SMS, statistics. 8 tools.
Part of the Russian API MCP series (50 servers) by @theYahia.
Installation
Claude Desktop
{
"mcpServers": {
"mango-office": {
"command": "npx",
"args": ["-y", "@theyahia/mango-office-mcp"],
"env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" }
}
}
}Claude Code
claude mcp add mango-office -e MANGO_API_KEY=your-key -e MANGO_API_SALT=your-salt -- npx -y @theyahia/mango-office-mcpVS Code / Cursor
{ "servers": { "mango-office": { "command": "npx", "args": ["-y", "@theyahia/mango-office-mcp"], "env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" } } } }Streamable HTTP
npx @theyahia/mango-office-mcp --http
# POST /mcp, GET /health — порт 3000 (PORT=8080 для другого)Requires
MANGO_API_KEYandMANGO_API_SALT. Get them in your Mango Office personal account.
Related MCP server: rtk-vats
Authentication
All requests are signed with HMAC-SHA256: sign = HMAC(apiKey + json + apiSalt).
Base URL: https://app.mango-office.ru/vpbx/.
Tools (6)
Tool | Description | API endpoint |
| Call history for a period |
|
| List of users |
|
| Initiate an outgoing call |
|
| Summary call statistics |
|
| Link to call recording |
|
| Send SMS |
|
Skills (2)
Tool | Description |
| Today's call history — ready-made report |
| Today's call statistics — summary |
Examples
Покажи звонки за последний час
Список пользователей Mango Office
Позвони с 101 на +79001234567
Статистика звонков за сегодня
Скачай запись разговора rec_123
Отправь SMS с 101 на +79001234567 "Перезвоните"Mango Office
Mango Office — cloud telephony for business. Referral program: up to 25% lifetime from payments of referred clients.
License
MIT
Available Tools
8 toolsget_callsC
Получить историю звонков Mango Office за период.
Inputs: date_to (required), date_from (required), limit.
get_recordingB
Получить ссылку на запись разговора.
Inputs: recording_id (required), action.
get_statsC
Получить сводную статистику звонков за период.
Inputs: date_to (required), date_from (required).
get_usersB
Получить список пользователей Mango Office.
Inputs: limit.
make_callB
Инициировать исходящий звонок (callback) через Mango Office.
Inputs: to (required), from (required), line.
send_smsC
Отправить SMS через Mango Office.
Inputs: text (required), to_number (required), from_extension (required).
skill_call_historyB
История звонков за сегодня — готовый отчёт.
Inputs: no named parameters.
skill_statsB
Статистика звонков за сегодня — сводка.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
There is clear overlap between get_calls and skill_call_history (both provide call logs, with the latter being today-only), and similarly get_stats vs skill_stats. While descriptions clarify the difference, agents could easily misselect when they want period-based vs today's data. Other tools like make_call, send_sms, get_users, get_recording are distinct.
Naming is inconsistent: most tools use verb_noun (get_calls, make_call, send_sms), but two use the prefix 'skill_' (skill_call_history, skill_stats) which breaks the pattern. The 'skill_' prefix is unusual and suggests a different convention without clear rationale, making it harder to predict tool names.
With 8 tools, the count is appropriate for a telephony server. However, the two redundant pairs (get_calls/skill_call_history, get_stats/skill_stats) could be consolidated, suggesting the surface is slightly padded but still reasonable.
The tools cover core telephony operations: retrieving calls, users, statistics, recordings, initiating calls, and sending SMS. Minor gaps exist (e.g., no call status updates, no user management beyond listing), but the main workflows are supported and no dead ends are evident.
Maintenance
Related MCP Connectors
Place calls, send WhatsApp, manage contacts, leads and campaigns, and read call records and billing
Read balance, tariffs, SIP and PBX status and call logs; send SMS in Zadarma.
Read calls, contacts, users, teams and numbers; tag calls and create or update contacts.
Read calls, queues and users; hang up or transfer live calls and send SMS in Telzio.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables interaction with RingCentral phone system data, including account info, extensions, presence, call queues, contacts, and call logs/recordings, through MCP tools.13Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Rostelecom Virtual PBX telephony, including contacts, subscribers, call groups, call history, call recordings, numbers and routing, balance, and transparent proxy to any of ~240 endpoints.MIT
- AlicenseBqualityFmaintenanceEnables sending SMS, making calls, retrieving call recordings, managing phone numbers, and sending Viber messages through the MTS Exolve API.854 npmMIT
- AlicenseAqualityBmaintenanceEnables managing and monitoring MSP360's Managed Backup Service, covering companies, computers, backup plans, monitoring, and licenses.14Apache 2.0