@theyahia/cloudpayments-mcp
This MCP server lets you manage CloudPayments payments, refunds, subscriptions, orders, and transaction history via 12 tools.
Process one-step payments (
charge_payment) and two-step authorize/hold payments (auth_payment)Confirm or void authorized transactions (
confirm_payment,void_payment)Look up transactions by ID and list all transactions for a date (
get_transaction,list_transactions)Issue full or partial refunds (
refund_payment)Create, update, cancel, and list recurring subscriptions (
create_subscription,update_subscription,cancel_subscription,list_subscriptions)Create payment orders / invoice links (
create_order)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@theyahia/cloudpayments-mcp Refund 2500 RUB on transaction 123456"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🗄 Репозиторий заархивирован
Разработка переехала в 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.
Related MCP server: PayBridgeNP MCP Server
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-mcpCursor / 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 3000Endpoints: POST /mcp (JSON-RPC), GET /health (status).
Auth
Variable | Required | Description |
| Yes | Public ID (HTTP Basic username) |
| Yes | API secret (HTTP Basic password) |
For testing, use the CloudPayments test terminal.
Tools (12)
Payments (5)
Tool | API Endpoint | Description |
| POST /payments/charge | One-step payment (immediate charge) |
| POST /payments/auth | Two-step payment (authorize/hold) |
| POST /payments/confirm | Confirm authorized payment (full or partial) |
| POST /payments/void | Void authorized payment (release hold) |
| POST /payments/find | Find transaction by ID |
Refunds (1)
Tool | API Endpoint | Description |
| POST /payments/refund | Full or partial refund by transaction ID |
Subscriptions (4)
Tool | API Endpoint | Description |
| POST /subscriptions/create | Create recurring subscription with token |
| POST /subscriptions/update | Update amount, interval, period |
| POST /subscriptions/cancel | Cancel active subscription |
| POST /subscriptions/find | List subscriptions for a user |
Orders (1)
Tool | API Endpoint | Description |
| POST /orders/create | Create payment order (invoice link) |
Transactions (1)
Tool | API Endpoint | Description |
| 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 1stShow me all transactions for yesterday and refund 2500 RUB on transaction 123456Part of Russian API MCP Series
MCP | Status | Description |
ready | Addresses, companies, banks, phones | |
ready | Currency rates, key rate | |
ready | Payments, refunds, receipts, payouts, webhooks | |
ready | Payments, subscriptions, orders | |
... | +46 servers -- full list |
License
MIT
Telegram: @vhodvai
Available Tools
12 toolsauth_paymentA
Two-step payment (authorize/hold). Funds are blocked but not charged until confirmed.
Inputs: Amount (required), IpAddress (required), CardCryptogramPacket (required), Name, +6 more.
cancel_subscriptionA
Cancel an active subscription by ID. Stops all future charges.
Inputs: Id (required).
charge_paymentA
One-step payment (immediate charge). Pass card cryptogram from CloudPayments widget, amount, and payer IP.
Inputs: Amount (required), IpAddress (required), CardCryptogramPacket (required), Name, +6 more.
confirm_paymentA
Confirm an authorized payment (charge the held amount). Can confirm a partial amount.
Inputs: Amount (required), TransactionId (required), JsonData.
create_orderA
Create a payment order (invoice link). Returns a URL the payer can open to pay.
Inputs: Amount (required), Description (required), Email, Phone, +6 more.
create_subscriptionA
Create a recurring subscription. Requires a token from a previous payment. Charges automatically on schedule.
Inputs: Token (required), Amount (required), Period (required), Interval (required), +7 more.
get_transactionA
Find a transaction by ID. Returns status, amount, card info, and timestamps.
Inputs: TransactionId (required).
list_subscriptionsA
List all subscriptions for a given user (AccountId).
Inputs: AccountId (required).
list_transactionsA
List all transactions for a given date. Returns completed, authorized, and declined transactions.
Inputs: Date (required), TimeZone.
refund_paymentC
Refund a payment (full or partial) by transaction ID.
Inputs: Amount (required), TransactionId (required), JsonData.
update_subscriptionC
Update subscription parameters: amount, interval, period, description.
Inputs: Id (required), Amount, Period, Currency, +4 more.
void_paymentA
Void an authorized payment (release the hold). Works only before confirmation.
Inputs: TransactionId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct payment or subscription action. Charge, auth, confirm, void, and refund are clearly separated by their lifecycle stage, and descriptions make the differences explicit.
All tool names follow a consistent snake_case verb_noun pattern such as create_subscription, refund_payment, and list_transactions. The naming convention is uniform and easy to predict.
12 tools is a well-scoped set for a payment gateway server covering payments, transactions, orders, and subscriptions. Each tool adds distinct value without unnecessary redundancy.
The core payment lifecycle is covered: charge, auth, confirm, void, refund, and transaction lookup. Subscription workflows also have create, update, cancel, and list. Minor gaps exist such as no direct get_subscription endpoint or webhook-related tools.
Maintenance
Related MCP Connectors
Manage GoCardless payments, mandates, subscriptions, refunds and payouts via AI assistants.
Stripe payments for AI agents. Create links, verify, manage customers.
Issue, deduct, refund and sell credits: checkout, subscriptions, saved cards, escrow and wallets.
Read payment settings, orders and receipts, create payment links and API keys.
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceEnables natural language interactions with SumUp payment services and APIs, allowing users to manage their SumUp account, process payments, and access payment data through LLM-powered conversations.8Apache 2.0- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with PayBridgeNP payment gateway accounts through natural language. Provides read-only access to payments, refunds, analytics, and account data, with write capabilities planned for future versions.24 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language interaction with Stripe accounts to query customers, revenue, invoices, subscriptions, disputes, and issue refunds.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Razorpay payment gateway through natural language, allowing users to fetch payments, manage orders, issue refunds, and list settlements.MIT