mcpField
C
cloudpayments-mcp

cloudpayments-mcp

Local
github.com/theYahiaFinance0Updated 8w ago

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

  1. 01Make immediate charges and authorizations
  2. 02Confirm or void authorized payments
  3. 03Find transactions and issue refunds
  4. 04Create, update, and cancel subscriptions
  5. 05Create payment orders and list transactions

Use cases

  1. 01Charge a one-time payment and inspect transactions
  2. 02Confirm or void an authorized payment
  3. 03Set up a recurring subscription for a user
  4. 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.

mcp.json · Universal config
{
"mcpServers": {
"theyahia-cloudpayments": {
"command": "npx",
"args": [
"-y",
"@theyahia/cloudpayments-mcp"
],
"env": {
"CLOUDPAYMENTS_PUBLIC_ID": "<CLOUDPAYMENTS_PUBLIC_ID>"
}
}
}
}
Run commandnpx -y @theyahia/cloudpayments-mcp
Environment variables to set
CLOUDPAYMENTS_PUBLIC_IDSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@theyahia/cloudpayments-mcp1.0.0

Tools

No tool list yet

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

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

VariableRequiredDescription
CLOUDPAYMENTS_PUBLIC_IDYesPublic ID (HTTP Basic username)
CLOUDPAYMENTS_API_SECRETYesAPI secret (HTTP Basic password)

For testing, use the CloudPayments test terminal.

Tools (12)

Payments (5)
ToolAPI EndpointDescription
charge_paymentPOST /payments/chargeOne-step payment (immediate charge)
auth_paymentPOST /payments/authTwo-step payment (authorize/hold)
confirm_paymentPOST /payments/confirmConfirm authorized payment (full or partial)
void_paymentPOST /payments/voidVoid authorized payment (release hold)
get_transactionPOST /payments/findFind transaction by ID
Refunds (1)
ToolAPI EndpointDescription
refund_paymentPOST /payments/refundFull or partial refund by transaction ID
Subscriptions (4)
ToolAPI EndpointDescription
create_subscriptionPOST /subscriptions/createCreate recurring subscription with token
update_subscriptionPOST /subscriptions/updateUpdate amount, interval, period
cancel_subscriptionPOST /subscriptions/cancelCancel active subscription
list_subscriptionsPOST /subscriptions/findList subscriptions for a user
Orders (1)
ToolAPI EndpointDescription
create_orderPOST /orders/createCreate payment order (invoice link)
Transactions (1)
ToolAPI EndpointDescription
list_transactionsPOST /payments/listList 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

MCPStatusDescription
@metarebalance/dadata-mcpreadyAddresses, companies, banks, phones
@theyahia/cbr-mcpreadyCurrency rates, key rate
@theyahia/yookassa-mcpreadyPayments, refunds, receipts, payouts, webhooks
@theyahia/cloudpayments-mcpreadyPayments, subscriptions, orders
...+46 servers -- full list

License

MIT


Telegram: @vhodvai

Comments

Markdown supported

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.