@theyahia/cloudpayments-mcp

MCP server for CloudPayments API -- one-step and two-step payments, refunds, subscriptions, orders (invoice links), transaction history. 12 tools.

Part of Russian API MCP series by @theYahia.

Quick Start

Claude Desktop

{
  "mcpServers": {
    "cloudpayments": {
      "command": "npx",
      "args": ["-y", "@theyahia/cloudpayments-mcp"],
      "env": {
        "CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",
        "CLOUDPAYMENTS_API_SECRET": "your-api-secret"
      }
    }
  }
}

Claude Code

claude mcp add cloudpayments -e CLOUDPAYMENTS_PUBLIC_ID=your-id -e CLOUDPAYMENTS_API_SECRET=your-secret -- npx -y @theyahia/cloudpayments-mcp

Cursor / Windsurf

{
  "cloudpayments": {
    "command": "npx",
    "args": ["-y", "@theyahia/cloudpayments-mcp"],
    "env": {
      "CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",
      "CLOUDPAYMENTS_API_SECRET": "your-api-secret"
    }
  }
}

HTTP Transport

HTTP_PORT=3000 npx @theyahia/cloudpayments-mcp
# or
npx @theyahia/cloudpayments-mcp --http 3000

Endpoints: POST /mcp (JSON-RPC), GET /health (status).

Auth

Variable	Required	Description
CLOUDPAYMENTS_PUBLIC_ID	Yes	Public ID (HTTP Basic username)
CLOUDPAYMENTS_API_SECRET	Yes	API secret (HTTP Basic password)

For testing, use the CloudPayments test terminal.

Tools (12)

Payments (5)

Tool	API Endpoint	Description
charge_payment	POST /payments/charge	One-step payment (immediate charge)
auth_payment	POST /payments/auth	Two-step payment (authorize/hold)
confirm_payment	POST /payments/confirm	Confirm authorized payment (full or partial)
void_payment	POST /payments/void	Void authorized payment (release hold)
get_transaction	POST /payments/find	Find transaction by ID

Refunds (1)

Tool	API Endpoint	Description
refund_payment	POST /payments/refund	Full or partial refund by transaction ID

Subscriptions (4)

Tool	API Endpoint	Description
create_subscription	POST /subscriptions/create	Create recurring subscription with token
update_subscription	POST /subscriptions/update	Update amount, interval, period
cancel_subscription	POST /subscriptions/cancel	Cancel active subscription
list_subscriptions	POST /subscriptions/find	List subscriptions for a user

Orders (1)

Tool	API Endpoint	Description
create_order	POST /orders/create	Create payment order (invoice link)

Transactions (1)

Tool	API Endpoint	Description
list_transactions	POST /payments/list	List all transactions for a date

Demo Prompts

Charge 5000 RUB from the card cryptogram, IP 192.168.1.1, description "Premium plan"

Create a monthly subscription for 999 RUB using token from the last payment, starting May 1st

Show me all transactions for yesterday and refund 2500 RUB on transaction 123456

Part of Russian API MCP Series

MCP	Status	Description
@metarebalance/dadata-mcp	ready	Addresses, companies, banks, phones
@theyahia/cbr-mcp	ready	Currency rates, key rate
@theyahia/yookassa-mcp	ready	Payments, refunds, receipts, payouts, webhooks
@theyahia/cloudpayments-mcp	ready	Payments, subscriptions, orders
...		+46 servers -- full list

License

MIT