Skip to main content
Glama
@theyahia/cloudpayments-mcp

@theyahia/cloudpayments-mcp

by theYahia

🗄 Репозиторий заархивирован

Разработка переехала в 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-mcp is 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.

npm license

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-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

Available Tools

12 tools
auth_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

    A3.8/5.0

    Scored across 12 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      8
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language interaction with Stripe accounts to query customers, revenue, invoices, subscriptions, disputes, and issue refunds.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Razorpay payment gateway through natural language, allowing users to fetch payments, manage orders, issue refunds, and list settlements.
      MIT