How do I use @theyahia/yookassa-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@theyahia/yookassa-mcp Create a payment for 5000 RUB for order #123" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@theyahia/yookassa-mcp

MCP server for YooKassa API -- payments, refunds, receipts (54-FZ), payouts, webhooks, recurring, SBP, marketplace splits. 20 tools.

npm License: MIT

Part of Russian API MCP series by @theYahia.

Quick Start

Claude Desktop

{
  "mcpServers": {
    "yookassa": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "your-shop-id",
        "YOOKASSA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Claude Code

claude mcp add yookassa -e YOOKASSA_SHOP_ID=your-id -e YOOKASSA_SECRET_KEY=your-key -- npx -y @theyahia/yookassa-mcp

VS Code / Cursor

{
  "servers": {
    "yookassa": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "your-shop-id",
        "YOOKASSA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "yookassa": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "your-shop-id",
        "YOOKASSA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Streamable HTTP (remote / Docker)

HTTP_PORT=3000 npx -y @theyahia/yookassa-mcp --http

Endpoints:

POST /mcp -- MCP Streamable HTTP transport
GET /health -- health check ({ "status": "ok", "tools": 20 })

Environment Variables

Variable	Required	Description
`YOOKASSA_SHOP_ID`	Yes	Shop ID (Settings -> Shop)
`YOOKASSA_SECRET_KEY`	Yes	Secret key (Integration -> API Keys)
`HTTP_PORT`	No	Port for HTTP transport (default 3000)

For testing, create a demo shop in YooKassa dashboard.

Tools (20)

Payments (9)

Tool	Description
`create_payment`	Create a payment with amount, description, payment method. Returns payment URL. Supports receipts and metadata
`get_payment`	Get payment details by ID -- status, amount, confirmation URL, metadata
`capture_payment`	Confirm a two-step payment (capture held funds). Partial capture supported
`cancel_payment`	Cancel a payment (pending or waiting_for_capture)
`list_payments`	List payments with filters by status, date range, and pagination
`save_payment_method`	Save a payment method for recurring charges (card binding)
`create_recurring_payment`	Charge a saved payment method (no user interaction)
`create_sbp_payment`	Create a payment via SBP (Russian fast payment system)
`create_split_payment`	Split payment for marketplaces -- distribute funds among partners

Refunds (3)

Tool	Description
`create_refund`	Full or partial refund by payment ID
`get_refund`	Get refund details by ID
`list_refunds`	List refunds with optional payment filter

Receipts (2)

Tool	Description
`create_receipt`	Fiscal receipt (54-FZ) -- items, VAT codes, customer contacts
`list_receipts`	List receipts by payment or refund ID

Payouts (2)

Tool	Description
`create_payout`	Payout to bank card, YooMoney wallet, or SBP phone
`get_payout`	Get payout status and details by ID

Webhooks (3)

Tool	Description
`create_webhook`	Register a webhook URL for events (payment.succeeded, refund.succeeded, etc.)
`list_webhooks`	List all registered webhooks
`delete_webhook`	Delete a webhook by ID

Account (1)

Tool	Description
`get_shop_balance`	Shop info -- ID, status, test mode, fiscalization

Demo Prompts

Create a payment for 5000 RUB for order #123 with SBP as payment method

Set up a recurring subscription: bind the card with 1 ruble, then charge 999 RUB monthly using the saved method

Show all successful payments for the last 7 days and create a refund of 2500 RUB for payment pay_xxx

Architecture

Auth: HTTP Basic Auth (YOOKASSA_SHOP_ID:YOOKASSA_SECRET_KEY)
Base URL: https://api.yookassa.ru/v3/
Idempotence-Key: UUID v4 on every POST request
Timeout: 10 seconds
Retry: 3 attempts on 429/5xx with exponential backoff (1s, 2s, 4s)
Transport: stdio (default) or Streamable HTTP (--http / HTTP_PORT)

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

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

@theyahia/yookassa-mcp

@theyahia/yookassa-mcp

Quick Start

Claude Desktop

Claude Code

VS Code / Cursor

Windsurf

Streamable HTTP (remote / Docker)

Environment Variables

Tools (20)

Payments (9)

Refunds (3)

Receipts (2)

Payouts (2)

Webhooks (3)

Account (1)

Demo Prompts

Architecture

Part of Russian API MCP Series

License

Resources

Latest Blog Posts

MCP directory API