MCP для Robokassa: полный охват API
robokassa-mcp
Python-клиент и MCP-сервер для Robokassa: счета, статусы, возвраты, холдирование, рекуррентные платежи и чеки 54-ФЗ, 18 инструментов
- 1 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструменты создают счета, инициируют возвраты, холдируют и списывают деньги с карт клиентов
- Стоит хранить Password#3 отдельно и включать доступ к Refund API только когда он реально нужен
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/robokassa-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты создают счета, инициируют возвраты, холдируют и списывают деньги с карт клиентов
- Стоит хранить Password#3 отдельно и включать доступ к Refund API только когда он реально нужен
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает Python-библиотеку robokassa и MCP-сервер robokassa-mcp поверх нее, публикуется в PyPI и в реестре MCP. Покрывает восемь групп официального API Robokassa: формирование подписанной ссылки на оплату с опциональным чеком 54-ФЗ, проверку статуса платежа через XML-интерфейс OpStateExt, расчет суммы к зачислению, возвраты и опрос их статуса, двухэтапное холдирование карты, родительские и дочерние рекуррентные списания, мультиполучательские сплит-платежи для маркетплейсов, платное SMS-уведомление и проверку подписи вебхуков ResultURL и SuccessURL. Всего 18 инструментов MCP, плюс низкоуровневые функции подписи доступны только из Python. Запускается через uvx, pip или Docker, поддерживает stdio, HTTP, streamable-http и SSE.
Для кого. Для разработчиков интернет-магазинов и сервисов на Robokassa, которым нужен полный охват платежного API, а не только выставление счета.
Подходит, если
- Нужно формировать счета на оплату с чеком 54-ФЗ и проверять их статус
- Нужны возвраты, холдирование карты или рекуррентные списания через Robokassa
- Нужна проверка подписи вебхуков ResultURL и SuccessURL на своем сервере
Не подходит, если
- Нужен только базовый счет и проверка статуса: более простой сервер theYahia/robokassa-mcp меньше и проще в настройке
- Покрытие Partner API нужно шире, чем один инструмент partner_refund: остальные методы Partner API не реализованы
Пример запроса к агенту
Сформируй ссылку на оплату 599 рублей за подписку с чеком 54-ФЗ и пришли ее клиентуMCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
ROBOKASSA_LOGINобязательная- Логин магазина в Robokassa
ROBOKASSA_PASSWORD1обязательная, секрет- Пароль 1: подпись чеков, оплаты, фискализации и SMS
ROBOKASSA_PASSWORD2обязательная, секрет- Пароль 2: проверка статуса платежа и подписи ResultURL
ROBOKASSA_PASSWORD3секрет- Пароль 3: инициирование возвратов через refund_create
Ограничения
README пишет install (once published), то есть публикация в PyPI на момент README считалась завершающим шагом релиза, актуальность пакета стоит проверить в PyPI перед установкой. Возвраты и рекуррентные списания требуют отдельного доступа в личном кабинете Robokassa (Refund API, JWT для Partner API). Автор описывает поддержку проекта как drop-and-forget: PR принимаются, но без гарантии быстрого ревью.
Как отключить. Удалите сервер robokassa из конфигурации MCP-клиента, например claude mcp remove robokassa.
Частые вопросы
Нужны ли все три пароля сразу?
Нет, каждый инструмент требует свой: Password#1 для чеков и оплаты, Password#2 для проверки статуса и подписи ResultURL, Password#3 для возвратов.
Работают ли возвраты сразу после установки?
Нет, refund_create требует, чтобы в личном кабинете Robokassa был включен доступ к Refund API.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP Robokassa: ссылка на оплату и статус
@theyahia/robokassa-mcp
Компактный MCP-сервер Robokassa на два инструмента: подписанная ссылка на оплату с чеком 54-ФЗ и проверка статуса счета
ЮKassa MCP
yookassa-mcp
MCP-сервер ЮKassa: платежи, возвраты, чеки по 54-ФЗ, выплаты и вебхуки прямо из диалога с агентом
Официальный MCP ЮKassa: агент создает ссылки на оплату и счета, проверяет статусы и возвраты, но сам деньги не переводит
MCP для бизнес-API Сбербанка
@theyahia/sber-mcp
MCP-сервер СберБизнес API: счета, баланс, выписки, платежные поручения и контрагенты через ИИ-агента
MCP-эндпоинт графов RoboSystems: агент запрашивает финансовые данные компании и отчетность SEC XBRL в графе знаний
Официальный MCP Точка Банка: агент смотрит счета и балансы, собирает выписки и готовит платежи, которые вы подписываете в интернет-банке
Коротко о README
README дает примеры использования и как Python-библиотеки, и как MCP-сервера: построение подписанной ссылки на оплату, полный цикл возврата с опросом статуса, проверка подписи вебхука на FastAPI, конфиги для Claude Desktop, Claude Code, Cursor, VS Code Copilot и Windsurf, таблицу всех 18 инструментов с указанием, какой пароль нужен каждому, таблицу покрытия восьми групп официального API и переменные окружения с их назначением.