Cloudpayments Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.0Updated Oct 24, 2026

MCP server for CloudPayments API — charge, auth, confirm, void, refund, find transaction. 6 tools.

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the CloudPayments API that lets an assistant charge cards, authorize and confirm holds, refund, and manage subscriptions and orders.

What you can do
Charge cards in one step or authorize and hold funds in two steps, then confirm or void the authorization and look up a transaction by ID. Issue full or partial refunds against a transaction ID. Create, update, cancel and list recurring subscriptions. Create payment orders that produce invoice links. List transactions for a given date.
When to use it
Useful when you work with CloudPayments as a payment provider and want an assistant to run payment, refund, subscription or invoice operations from a chat instead of the dashboard or API directly.
Requirements
Runs locally via npx from the npm package @theyahia/cloudpayments-mcp, so Node.js is needed. Requires the environment variables CLOUDPAYMENTS_PUBLIC_ID and CLOUDPAYMENTS_API_SECRET (HTTP Basic credentials). An optional HTTP transport can be started on a chosen port. Network access to the CloudPayments API is required.
Before you install
The credentials are live payment API secrets; anyone with them can move money. Tools charge cards, place holds, refund, cancel subscriptions and create invoices, so actions spend or return real funds and are hard to undo. The README notes the repository is archived and development moved elsewhere, while the npm package is said to be unchanged. Test with the CloudPayments test terminal first.

Installation

In SourceWeft

  1. Open Cloudpayments Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

json
{  "mcpServers": {    "cloudpayments": {      "command": "npx",      "args": ["-y", "@theyahia/cloudpayments-mcp"],      "env": {        "CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",        "CLOUDPAYMENTS_API_SECRET": "your-api-secret"      }    }  }}

Claude Code

bash
claude mcp add cloudpayments -e CLOUDPAYMENTS_PUBLIC_ID=your-id -e CLOUDPAYMENTS_API_SECRET=your-secret -- npx -y @theyahia/cloudpayments-mcp

Cursor / Windsurf

json
{  "cloudpayments": {    "command": "npx",    "args": ["-y", "@theyahia/cloudpayments-mcp"],    "env": {      "CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",      "CLOUDPAYMENTS_API_SECRET": "your-api-secret"    }  }}

HTTP Transport

bash
HTTP_PORT=3000 npx @theyahia/cloudpayments-mcp# ornpx @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

Source: README.md at commit 21e00f2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts