About cloudpayments-mcp
cloudpayments-mcp exposes the CloudPayments payment API to MCP clients for business and development teams handling payments and subscriptions. Alongside charges and refunds, it covers two-step payments, orders, and transaction lookup.
Key features
- 01Make immediate charges and authorizations
- 02Confirm or void authorized payments
- 03Find transactions and issue refunds
- 04Create, update, and cancel subscriptions
- 05Create payment orders and list transactions
Use cases
- 01Charge a one-time payment and inspect transactions
- 02Confirm or void an authorized payment
- 03Set up a recurring subscription for a user
- 04Create a payment link and process a refund
MCP support
This MCP server provides CloudPayments tools for payments, refunds, subscriptions, orders, and transactions. MCP clients can connect over stdio or HTTP.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @theyahia/cloudpayments-mcpCLOUDPAYMENTS_PUBLIC_IDSecretAPI key for the serviceLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project README🗄 Репозиторий заархивирован
Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро
@theyahia/mcp-core, единый CI, единый релизный конвейер.Актуальная версия того, что лежало здесь:
servers/cloudpayments/Пакет в npm прежний —
@theyahia/cloudpayments-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at
servers/cloudpayments/. The npm package@theyahia/cloudpayments-mcpis unchanged. Please open issues and pull requests there.
@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
Telegram: @vhodvai
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.