io.github.theYahia/cloudpayments-mcp

Official

by theYahia · TypeScript

MCP server for CloudPayments API — charge, auth, confirm, void, refund, find transaction. 6 tools.

Process payments including charges, authorizations, refunds, and transaction lookups.

Topics

aiclaudecloudpaymentsllmmcpmcp-servermodel-context-protocolrussian-apitypescriptapipayments

README.md4 KBView on GitHub

@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

json

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

Claude Code

bash

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

Cursor / Windsurf

json

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

HTTP Transport

bash

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

code

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

code

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

code

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

Install

Configuration

Environment variables

CLOUDPAYMENTS_PUBLIC_IDrequiredsecret

API key for the service

claude_desktop_config.json

{
  "mcpServers": {
    "cloudpayments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/cloudpayments-mcp@1.0.0"
      ],
      "env": {
        "CLOUDPAYMENTS_PUBLIC_ID": "<YOUR_CLOUDPAYMENTS_PUBLIC_ID>"
      }
    }
  }
}