Каталог MCP
YooKassa MCP

YooKassa MCP

Name: YooKassa MCP
Availability: InStock
Author: theyahia

MCP-сервер для YooKassa: 20 инструментов для платежей, возвратов, чеков 54-ФЗ, выплат, вебхуков, рекуррентных, СБП и маркетплейс-сплитов. Полезен разработчикам для автоматизации приёма платежей.

README

20 инструментов

Версии

Установить сервер

@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"
      }
    }
  }
}

Инструменты были проиндексированы: 09.09.2026

cancel_paymentидемпотентныйвнешний мир

Отменяет платёж (pending или waiting_for_capture). Освобождает любые удерживаемые средства.

Отменяет платёж.

Параметры

payment_idstringобязательный
ID of the payment to cancel

capture_paymentидемпотентныйвнешний мир

Подтверждает двухэтапный платеж (захватывает удерживаемые средства). Опционально захватывает частичную сумму. ПЕРЕВОДИТ РЕАЛЬНЫЕ ДЕНЬГИ - необратимо.

Списывает платёж.

Параметры

amountstring | number
Amount for a partial capture (optional; must be <= the authorized amount, same currency). Over-capture is rejected by YooKassa
payment_idstringобязательный
ID of the payment to capture

create_paymentвнешний мир

Создаёт платёж в YooKassa. Возвращает URL подтверждения. Поддерживает одношаговые и двухшаговые платежи, чеки и метаданные. ПЕРЕВОДИТ РЕАЛЬНЫЕ ДЕНЬГИ (с плательщика списываются средства) - необратимо.

Создаёт платёж.

Параметры

amountstring | numberобязательный
Payment amount in rubles (string '5000.00' for exactness, or a number)
captureboolean
true = one-step (auto-capture), false = two-step (hold)
confirmation_typeenum
Confirmation type: redirect (needs return_url), embedded (widget), or qr
currencystring
Currency (ISO-4217, default RUB)
descriptionstringобязательный
Payment description (max 128 chars)
metadataobject
Arbitrary metadata (key-value)
payment_method_typeenum
Payment method
receipt_emailstring
Customer email for the receipt
receipt_itemsobject[]
Items for a 54-FZ receipt (if issuing a receipt with the payment)
receipt_tax_system_codeinteger
Receipt tax system code, tag 1055 (only if the shop has multiple tax systems / FFD 1.2)
return_urlstring
URL to return the payer to after payment — REQUIRED when confirmation_type=redirect

create_payoutвнешний мир

Создаёт выплату на банковскую карту, кошелёк YooMoney или SBP. Требует отдельно активированный продукт YooKassa Payouts с собственными учётными данными (см. README/SECURITY). Асинхронный: ответ может быть 'pending'; опрашивайте get_payout для получения окончательного статуса. ПЕРЕВОДИТ РЕАЛЬНЫЕ ДЕНЬГИ - необратимо.

Создаёт выплату.

Параметры

amountstring | numberобязательный
Payout amount
bank_idstring
SBP participant bank id (required for destination_type=sbp)
currencystring
Currency (ISO-4217, default RUB)
descriptionstring
Payout description
destination_typeenum
Recipient type (if not using payout_token). bank_card requires a PCI DSS certificate
destination_valuestring
Recipient: card number (bank_card), wallet number (yoo_money), or phone 79XXXXXXXXX (sbp)
metadataobject
Arbitrary metadata
payout_tokenstring
Recipient token from the payout widget (preferred; required if you lack PCI DSS to accept a raw card number)

create_receiptвнешний мир

Создаёт автономный фискальный чек (54-ФЗ). Поддерживает чеки оплаты и возврата с позициями, кодами НДС и контактами покупателя.

Создает чек

Параметры

customer_emailstring
Customer email for the receipt
customer_phonestring
Customer phone (if no email)
itemsobject[]обязательный
Receipt items/services
payment_idstring
Payment ID (required for type=payment)
refund_idstring
Refund ID (required for type=refund)
sendboolean
Send the receipt to the customer (required for a standalone receipt)
settlement_idstring
Settlement ID (for linking)
settlementsobject[]
Settlements. If omitted — auto: one 'cashless' for the sum of items
tax_system_codeinteger
Tax system code, tag 1055 (1-6). Send only if the shop has multiple tax systems or uses FFD 1.2
typeenumобязательный
Receipt type

create_recurring_paymentвнешний мир

Списывает платёж с сохранённого способа оплаты. Немедленно списывает деньги с карты БЕЗ какого-либо взаимодействия с пользователем. Переводит РЕАЛЬНЫЕ ДЕНЬГИ - необратимо.

Создаёт регулярный платёж.

Параметры

amountstring | numberобязательный
Recurring charge amount
currencystring
Currency (ISO-4217, default RUB)
descriptionstringобязательный
Recurring payment description
payment_method_idstringобязательный
ID of the saved payment method (from payment_method.id)

create_refundвнешний мир

Возвращает платёж (полностью или частично) по payment_id и сумме. ПЕРЕВОДИТ РЕАЛЬНЫЕ ДЕНЬГИ (средства возвращаются плательщику) - необратимо.

Создаёт возврат.

Параметры

amountstring | numberобязательный
Refund amount in rubles
descriptionstring
Refund reason
payment_idstringобязательный
ID of the payment to refund

create_sbp_paymentвнешний мир

Создаёт платёж через SBP (российская система быстрых платежей). Возвращает URL подтверждения / deep-link для банковского приложения плательщика. ПЕРЕВОДИТ РЕАЛЬНЫЕ ДЕНЬГИ: необратимо.

Создаёт платёж через SBP.

Параметры

amountstring | numberобязательный
SBP payment amount
confirmation_typeenum
Confirmation type: redirect (needs return_url), embedded, or qr
currencystring
Currency (ISO-4217, default RUB)
descriptionstringобязательный
Payment description
return_urlstring
Return URL — REQUIRED when confirmation_type=redirect

create_split_paymentвнешний мир

Создает раздельный платеж для маркетплейсов (распределяет средства между магазинами-партнерами). Требует продукт YooKassa-for-platforms. ПЕРЕВОДИТ РЕАЛЬНЫЕ ДЕНЬГИ - необратимо.

Создаёт раздельный платёж.

Параметры

amountstring | numberобязательный
Total payment amount
confirmation_typeenum
Confirmation type: redirect (needs return_url), embedded, or qr
currencystring
Currency (ISO-4217, default RUB)
descriptionstringобязательный
Payment description
return_urlstring
Return URL — REQUIRED when confirmation_type=redirect
transfersobject[]обязательный
Recipients (splits). The sum of transfers must equal amount. Requires the Split Payments product

create_webhookвнешний мир

Регистрирует URL вебхука для событий YooKassa (payment.succeeded, refund.succeeded и т.д.).

Создает webhook.

Параметры

eventenumобязательный
Event type to subscribe to
urlstringобязательный
HTTPS URL to receive webhook notifications

delete_webhookидемпотентныйвнешний мир

Удаляет вебхук по ID. Прекращает отправлять уведомления для этого вебхука.

Удаляет webhook.

Параметры

webhook_idstringобязательный
ID of the webhook to delete

get_paymentтолько чтениевнешний мир

Получает детали платежа по идентификатору. Возвращает статус, сумму, способ оплаты, URL подтверждения и метаданные.

Получает платёж.

Параметры

payment_idstringобязательный
Payment ID (e.g. pay_xxx)

get_payoutтолько чтениевнешний мир

Получает детали выплаты по ID. Возвращает статус, сумму и назначение.

Получает выплату.

Параметры

payout_idstringобязательный
Payout ID

get_refundтолько чтениевнешний мир

Получает детали возврата по ID. Возвращает статус, сумму и платёжный идентификатор.

Возвращает средства.

Параметры

refund_idstringобязательный
Refund ID

get_shop_infoтолько чтениевнешний мир

Возвращает информацию о магазине: ID, статус, тестовый режим, настройки фискализации. (В YooKassa нет эндпоинта для баланса; этот метод возвращает конфигурацию магазина, а не денежный баланс.)

Получает информацию о магазине.

Параметры

Без параметров.

list_paymentsтолько чтениевнешний мир

Выводит список платежей с фильтрами по статусу, диапазону дат и курсору пагинации.

Выводит список платежей.

Параметры

created_at_gtestring
From date (ISO-8601 datetime)
created_at_ltestring
To date (ISO-8601 datetime)
cursorstring
Pagination cursor (from next_cursor of the previous response)
limitinteger
Count (1-100, default 10)
statusenum
Filter by status

list_receiptsтолько чтениевнешний мир

Перечисляет чеки с фильтрами по payment_id или refund_id.

Перечисляет чеки.

Параметры

cursorstring
Pagination cursor
limitinteger
Count (1-100)
payment_idstring
Filter by payment ID
refund_idstring
Filter by refund ID

list_refundsтолько чтениевнешний мир

Перечисляет возвраты с необязательным фильтром по payment_id.

Перечисляет возвраты.

Параметры

limitinteger
Count (1-100)
payment_idstring
Filter by payment ID

list_webhooksтолько чтениевнешний мир

Перечисли все зарегистрированные webhooks для этого магазина.

Перечисляет вебхуки.

Параметры

Без параметров.

save_payment_methodвнешний мир

Сохраняет способ оплаты для регулярных платежей. Создаёт небольшой реальный платёж для привязки карты или кошелька (сначала списывается, затем возвращается). ПРОВОДИТ РЕАЛЬНЫЕ ДЕНЬГИ - необратимо.

Сохраняет способ оплаты.

Параметры

amountstring | numberобязательный
Binding amount (min 1 ruble; charged then refundable)
currencystring
Currency (ISO-4217, default RUB)
descriptionstring
Description
payment_method_typeenum
Payment method type
return_urlstringобязательный
URL to return to after binding

Github Сайт сервера

Конфиг для установки сервера

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