Yookassa MCP - install, status & alternatives [2026]

01 · Install Yookassa MCP

before you install - you'll need

Set YOOKASSA_SHOP_ID, YOOKASSA_SECRET_KEY, MCP_AUTH_TOKEN before connecting.

Claude Code

claude mcp add theyahia-yookassa-mcp -- npx -y @theyahia/yookassa-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "theyahia-yookassa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yookassa-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @theyahia/yookassa-mcp - published under the repo owner's npm scope (@theyahia)

registry namespace io.github.theYahia is GitHub-verified and matches the repo owner

03 · What Yookassa MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a payment with amount, description, payment method. Returns payment URL. Supports receipts and metadata, get payment details by ID -- status, amount, confirmation URL, metadata, cancel a payment (pending or waiting_for_capture), and list payments with filters by status, date range, and pagination.

Capability map

Tools grouped from the project's README - what Yookassa MCP lets an agent do.

Payment

8 tools - e.g. Create a payment with amount, description, payment method. Returns payment URL. Supports receipts and metadata; Get payment details by ID -- status, amount, confirmation URL, metadata; Confirm a two-step…

create_payment · get_payment · capture_payment · cancel_payment · save_payment_method · create_recurring_payment…

read & search

5 tools - e.g. List payments with filters by status, date range, and pagination; List refunds with optional payment filter; List receipts by payment or refund ID

list_payments · list_refunds · list_receipts · list_webhooks · get_shop_info

Refund

2 tools - e.g. Full or partial refund by payment ID; Get refund details by ID

create_refund · get_refund

Payout

2 tools - e.g. Payout to bank card / YooMoney wallet / SBP, or via payout_token; Get payout status and details by ID

create_payout · get_payout

Webhook

2 tools - e.g. Register a webhook URL for events (payment.succeeded, refund.succeeded, etc.); Delete a webhook by ID

create_webhook · delete_webhook

create & write

1 tool - e.g. Fiscal receipt (54-FZ) -- items, VAT codes, customer contacts

create_receipt

04 · Who maintains Yookassa MCP

yookassa-mcp is maintained by theyahia. We track 49 MCP servers from theyahia - 43 actively maintained, 72 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from theyahia.

05 · Facts

repository: github.com/theyahia/yookassa-mcp
category: finance - ranked #145 of 283 actively-maintained finance servers as of 2026-08-25.
registry: io.github.theYahia/yookassa-mcp (active, first published 2026-03-31)
packages: npm:@theyahia/yookassa-mcp

06 · Yookassa MCP FAQ

Is Yookassa MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-23. We re-verify nightly.

What can Yookassa MCP do?

With this server connected, an agent can create a payment with amount, description, payment method. Returns payment URL. Supports receipts and metadata, get payment details by ID -- status, amount, confirmation URL, metadata, cancel a payment (pending or waiting_for_capture), and list payments with filters by status, date range, and pagination.

How do I install Yookassa MCP?

Run `npx -y @theyahia/yookassa-mcp`. The README documents 3 environment variables (YOOKASSA_SHOP_ID, YOOKASSA_SECRET_KEY, MCP_AUTH_TOKEN) to set first. Set YOOKASSA_SHOP_ID, YOOKASSA_SECRET_KEY, MCP_AUTH_TOKEN before connecting. You can also paste the ready-made client config above.

Does Yookassa MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Yookassa MCP

Alternatives to Yookassa MCP

Maintained finance servers if Yookassa MCP isn't the fit.

Pairs well with

Servers that cover what Yookassa MCP doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Ticker DB · TourMind Booking MCP · Trade It · Paradex Trading

More TypeScript MCP servers · Observability MCP · Thoughtspot MCP Server · Memory MCP Lite · Charlotte · see all