@theyahia/cloudpayments-mcp

Name: cloudpayments mcp
Author: theyahia

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