io.github.theYahia/cloudpayments-mcp
MCP server for CloudPayments API — charge, auth, confirm, void, refund, find transaction. 6 tools.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@theyahia/cloudpayments-mcpclaude mcp add cloudpayments-mcp -e 'CLOUDPAYMENTS_PUBLIC_ID=<your cloudpayments_public_id>' -- npx -y @theyahia/cloudpayments-mcp@1.0.0
{
"mcpServers": {
"cloudpayments-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/cloudpayments-mcp@1.0.0"
],
"env": {
"CLOUDPAYMENTS_PUBLIC_ID": "<your cloudpayments_public_id>"
}
}
}
}
متغيرات البيئة
CLOUDPAYMENTS_PUBLIC_IDإلزامي سري API key for the service
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
🗄 Репозиторий заархивирован
Разработка переехала в 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
الأسئلة الشائعة
ما هو io.github.theYahia/cloudpayments-mcp؟
MCP server for CloudPayments API — charge, auth, confirm, void, refund, find transaction. 6 tools.
كيف أثبّت io.github.theYahia/cloudpayments-mcp؟
يعمل على جهازك. في Claude Code: claude mcp add cloudpayments-mcp -e 'CLOUDPAYMENTS_PUBLIC_ID=<your cloudpayments_public_id>' -- npx -y @theyahia/cloudpayments-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.theYahia/cloudpayments-mcp إلى مفتاح API؟
نعم. يتطلب CLOUDPAYMENTS_PUBLIC_ID، وتضبطها في إعداداته.
هل io.github.theYahia/cloudpayments-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.theYahia/cloudpayments-mcp؟
ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.