English Français العربية

io.github.theYahia/cloudpayments-mcp

Official registry Archived Security

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @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 configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cloudpayments-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/cloudpayments-mcp@1.0.0"
            ],
            "env": {
                "CLOUDPAYMENTS_PUBLIC_ID": "<your cloudpayments_public_id>"
            }
        }
    }
}

Environment variables

  • CLOUDPAYMENTS_PUBLIC_ID required secret API key for the service

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 🗄 Репозиторий заархивирован
  2. @theyahia/cloudpayments-mcp
  3. Quick Start
  4. Auth
  5. Tools (12)
  6. Demo Prompts
  7. Part of Russian API MCP Series
  8. License

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

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

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

Frequently asked questions

What is io.github.theYahia/cloudpayments-mcp?

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

How do I install io.github.theYahia/cloudpayments-mcp?

It runs on your machine. In Claude Code: claude mcp add cloudpayments-mcp -e 'CLOUDPAYMENTS_PUBLIC_ID=<your cloudpayments_public_id>' -- npx -y @theyahia/cloudpayments-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.theYahia/cloudpayments-mcp need an API key?

Yes. It expects CLOUDPAYMENTS_PUBLIC_ID, which you set in its configuration.

Is io.github.theYahia/cloudpayments-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.theYahia/cloudpayments-mcp?

It is published by theYahia. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.