io.github.theYahia/mango-office-mcp MCP Server

Mango Office MCP is a Model Context Protocol (MCP) server for Mango Office, focused on cloud PBX call management. It provides tooling over the Mango Office API for phone-related actions, including working with calls, users, recordings, SMS, and weekly/statistical information.

🛠️ Key Features

MCP server for Mango Office (cloud PBX)
Call management via Mango Office API
8 tools total for telephony operations
Tools cover calls, users, recordings, SMS, and statistics

🚀 Use Cases

Retrieve call recordings for review
Obtain call statistics for a week
Send SMS as part of an AI-assistant dialogue
Manage phone calls and related entities in Mango Office

⚡ Developer Benefits

Exposes Mango Office API through MCP tools
Typed integration context for “calls, users, recordings, SMS and statistics”
Useful when building Claude/LLM workflows around Russian telephony APIs

⚠️ Limitations

Designed specifically for Mango Office cloud PBX and its API (including “Russia” scope in the description)

Mango Office MCP — телефония, звонки и записи разговоров через нейросеть

Если вы искали, как поднять статистику звонков за неделю обычным вопросом, вытащить запись разговора для разбора или отправить SMS прямо из диалога с ИИ-ассистентом — это оно. 8 инструментов поверх Mango Office API: звонки, пользователи, записи, SMS и статистика.

Часть серии WWmcp (46 серверов) by @theYahia.

Установка

Claude Desktop

json

{
  "mcpServers": {
    "mango-office": {
      "command": "npx",
      "args": ["-y", "@theyahia/mango-office-mcp"],
      "env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" }
    }
  }
}

Claude Code

bash

claude mcp add mango-office -e MANGO_API_KEY=your-key -e MANGO_API_SALT=your-salt -- npx -y @theyahia/mango-office-mcp

VS Code / Cursor

json

{ "servers": { "mango-office": { "command": "npx", "args": ["-y", "@theyahia/mango-office-mcp"], "env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" } } } }

Streamable HTTP

bash

npx @theyahia/mango-office-mcp --http
# POST /mcp, GET /health — порт 3000 (PORT=8080 для другого)

Требуется MANGO_API_KEY и MANGO_API_SALT. Получите в личном кабинете Mango Office.

Аутентификация

Все запросы подписываются HMAC-SHA256: sign = HMAC(apiKey + json + apiSalt). Базовый URL: https://app.mango-office.ru/vpbx/.

Инструменты (6)

Инструмент	Описание	API endpoint
`get_calls`	История звонков за период	`stats/request`
`get_users`	Список пользователей	`config/users/request`
`make_call`	Инициировать исходящий звонок	`commands/callback`
`get_stats`	Сводная статистика звонков	`stats/request`
`get_recording`	Ссылка на запись разговора	`queries/recording/post`
`send_sms`	Отправить SMS	`commands/sms`

Skills (2)

Инструмент	Описание
`skill_call_history`	История звонков за сегодня — готовый отчёт
`skill_stats`	Статистика звонков за сегодня — сводка

Примеры

code

Покажи звонки за последний час
Список пользователей Mango Office
Позвони с 101 на +79001234567
Статистика звонков за сегодня
Скачай запись разговора rec_123
Отправь SMS с 101 на +79001234567 "Перезвоните"

Mango Office

Mango Office — облачная телефония для бизнеса. Реферальная программа: до 25% пожизненно от платежей приведённых клиентов.

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

mango-office-mcp