CloudPayments MCP: Documentation
Updated:
Connection
npx -y @theyahia/cloudpayments-mcp (stdio) or HTTP_PORT=3000 npx @theyahia/cloudpayments-mcp --http. Auth: CLOUDPAYMENTS_PUBLIC_ID + CLOUDPAYMENTS_API_SECRET (Basic) — from the CloudPayments dashboard, Settings → API. To test without real money, use the CloudPayments test terminal (developers.cloudpayments.ru → "Testing").
Capabilities
6 tools: charge (one-step payment from a card cryptogram), auth (two-step authorization — a hold with no charge), confirm (confirm a hold, in full or in part), void_payment (release a hold), get_transaction (look up a transaction by ID), refund (full or partial refund on a completed transaction).
Agent flow
"Charge 5,000 RUB from a card cryptogram with description 'Premium plan'", "authorize a 3,000 RUB hold and confirm only 2,000 RUB of it", "find transaction 123456 and refund 2,500 RUB from it".
Note
A community project (theYahia), not an official CloudPayments product. The API secret grants access to real charges — test the flow on the CloudPayments test terminal before wiring in production keys.