@theyahia/yookassa-mcp

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

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

... View full README on GitHub