YooKassa MCP: Documentation
Updated:
Connection
npx -y @theyahia/yookassa-mcp (stdio) or MCP_AUTH_TOKEN=... HTTP_PORT=3000 npx -y @theyahia/yookassa-mcp --http (Bearer-protected POST /mcp, binds to 127.0.0.1). Auth: YOOKASSA_SHOP_ID + YOOKASSA_SECRET_KEY from the YooKassa dashboard (Shop settings / Integration → API keys); for payouts, separately, YOOKASSA_PAYOUT_AGENT_ID + YOOKASSA_PAYOUT_SECRET_KEY.
Capabilities
20 tools: payments (create_payment, get_payment, capture_payment, cancel_payment, list_payments, save_payment_method, create_recurring_payment, create_sbp_payment, create_split_payment), refunds (create_refund, get_refund, list_refunds), 54-FZ receipts (create_receipt, list_receipts), payouts (create_payout, get_payout), webhooks (create_webhook, list_webhooks, delete_webhook), account (get_shop_info).
Agent flow
"Create a 5,000 RUB payment via SBP and give me the link", "check whether order #123 was paid", "issue a 2,500 RUB refund".
Note
A community project (theYahia), not an official YooKassa product. The secret key moves real money — start with a test shop (get_shop_info should return test: true).