MCPHIVE

YooKassa MCP: Документация

Обновлено:

Подключение

npx -y @theyahia/yookassa-mcp (stdio) или MCP_AUTH_TOKEN=... HTTP_PORT=3000 npx -y @theyahia/yookassa-mcp --http (Bearer-защищённый POST /mcp, биндится на 127.0.0.1). Auth: YOOKASSA_SHOP_ID + YOOKASSA_SECRET_KEY из кабинета ЮKassa (Настройки магазина / Интеграция → API-ключи); для выплат отдельно — YOOKASSA_PAYOUT_AGENT_ID + YOOKASSA_PAYOUT_SECRET_KEY.

Что умеет

20 инструментов: платежи (create_payment, get_payment, capture_payment, cancel_payment, list_payments, save_payment_method, create_recurring_payment, create_sbp_payment, create_split_payment), возвраты (create_refund, get_refund, list_refunds), чеки 54-ФЗ (create_receipt, list_receipts), выплаты (create_payout, get_payout), вебхуки (create_webhook, list_webhooks, delete_webhook), аккаунт (get_shop_info).

Сценарий для агента

«Создай платёж на 5000 ₽ через СБП и дай ссылку», «проверь, прошла ли оплата по заказу №123», «оформи возврат 2500 ₽».

Важно

Community-проект (theYahia), не официальный продукт ЮKassa. Секретный ключ двигает реальные деньги — начните с тестового магазина (get_shop_info должен вернуть test: true).