Каталог MCP
YooKassa MCP

YooKassa MCP

Name: YooKassa MCP
Availability: InStock
Author: theyahia

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

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

README

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

Версии

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

ЮKassa MCP — приём платежей и чеки 54-ФЗ из Claude и других AI-агентов

Если вы искали, как подключить ЮKassa к нейросети, проводить платежи и возвраты прямо в диалоге или автоматизировать фискальные чеки по 54-ФЗ без написания кода — это оно. 20 инструментов закрывают весь оборот денег: платежи, возвраты, чеки, выплаты, вебхуки, рекуррентные списания, СБП и сплиты маркетплейса. Ставится в Claude Desktop, Cursor или любой MCP-клиент одной строкой конфига.

Часть серии WWmcp от @theYahia.

Быстрый старт

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

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

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

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

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

Параметры

payment_idstringобязательный
ID платежа для отмены.

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

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

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

Параметры

amountstring | number
Сумма для частичного списания (необязательно; должна быть меньше или равна авторизованной сумме, в той же валюте). Списание сверх авторизованной суммы отклоняется YooKassa.
payment_idstringобязательный
ID платежа для захвата

create_paymentвнешний мир

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

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

Параметры

amountstring | numberобязательный
Сумма платежа в рублях (строка '5000.00' для точности или число)
captureboolean
true = одношаговый (автозахват), false = двухшаговый (удержание)
confirmation_typeenum
Тип подтверждения: редирект (требуется return_url), встроенный (виджет) или QR.
currencystring
Валюта (ISO-4217, по умолчанию RUB)
descriptionstringобязательный
Описание платежа (макс. 128 символов)
metadataobject
Произвольные метаданные (ключ-значение)
payment_method_typeenum
Способ оплаты
receipt_emailstring
Электронная почта клиента для чека.
receipt_itemsobject[]
Позиции для чека по 54-ФЗ (если чек выдается вместе с платежом)
receipt_tax_system_codeinteger
Код системы налогообложения чека, тег 1055 (только если у магазина несколько систем налогообложения / FFD 1.2)
return_urlstring
URL для возврата плательщика после оплаты - ОБЯЗАТЕЛЬНО при confirmation_type=redirect.

create_payoutвнешний мир

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

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

Параметры

amountstring | numberобязательный
Сумма выплаты
bank_idstring
ID банка участника SBP (обязателен для destination_type=sbp)
currencystring
Валюта (ISO-4217, по умолчанию RUB)
descriptionstring
Описание выплаты
destination_typeenum
Тип получателя (если не используется payout_token). bank_card требует сертификат PCI DSS.
destination_valuestring
Получатель: номер карты (bank_card), номер кошелька (yoo_money) или телефон 79XXXXXXXXX (sbp)
metadataobject
Произвольные метаданные
payout_tokenstring
Токен получателя из виджета выплат (предпочтительно; обязателен, если у вас нет PCI DSS для приёма номера карты в открытом виде).

create_receiptвнешний мир

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

Создает чек

Параметры

customer_emailstring
Электронная почта клиента для чека.
customer_phonestring
Телефон клиента (если нет email)
itemsobject[]обязательный
Позиции чека/услуги
payment_idstring
Payment ID (обязательно для type=payment)
refund_idstring
Refund ID (обязательно для type=refund)
sendboolean
Отправляет квитанцию клиенту (требуется для отдельной квитанции).
settlement_idstring
Settlement ID (для связывания)
settlementsobject[]
Расчеты. Если не указано - auto: один 'cashless' на сумму товаров.
tax_system_codeinteger
Код системы налогообложения, tag 1055 (1-6). Отправляйте только если у магазина несколько систем налогообложения или используется FFD 1.2.
typeenumобязательный
Тип чека

create_recurring_paymentвнешний мир

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

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

Параметры

amountstring | numberобязательный
Сумма регулярного платежа
currencystring
Валюта (ISO-4217, по умолчанию RUB)
descriptionstringобязательный
Описание повторяющегося платежа
payment_method_idstringобязательный
ID сохраненного способа оплаты (из payment_method.id)

create_refundвнешний мир

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

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

Параметры

amountstring | numberобязательный
Сумма возврата в рублях
descriptionstring
Причина возврата
payment_idstringобязательный
ID платежа для возврата

create_sbp_paymentвнешний мир

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

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

Параметры

amountstring | numberобязательный
Сумма платежа SBP
confirmation_typeenum
Тип подтверждения: redirect (требует return_url), embedded или qr
currencystring
Валюта (ISO-4217, по умолчанию RUB)
descriptionstringобязательный
Описание платежа
return_urlstring
Return URL - ОБЯЗАТЕЛЬНО при confirmation_type=redirect

create_split_paymentвнешний мир

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

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

Параметры

amountstring | numberобязательный
Общая сумма платежа
confirmation_typeenum
Тип подтверждения: redirect (требует return_url), embedded или qr
currencystring
Валюта (ISO-4217, по умолчанию RUB)
descriptionstringобязательный
Описание платежа
return_urlstring
Return URL - ОБЯЗАТЕЛЬНО при confirmation_type=redirect
transfersobject[]обязательный
Получатели (распределения). Сумма переводов должна равняться сумме. Требуется продукт Split Payments.

create_webhookвнешний мир

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

Создает webhook.

Параметры

eventenumобязательный
Тип события, на которое подписаться.
urlstringобязательный
HTTPS URL для получения webhook-уведомлений.

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

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

Удаляет webhook.

Параметры

webhook_idstringобязательный
ID вебхука для удаления

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

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

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

Параметры

payment_idstringобязательный
ID платежа (например, pay_xxx)

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

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

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

Параметры

payout_idstringобязательный
Идентификатор выплаты

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

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

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

Параметры

refund_idstringобязательный
Идентификатор возврата.

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

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

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

Параметры

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

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

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

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

Параметры

created_at_gtestring
Дата начала (дата и время в формате ISO-8601)
created_at_ltestring
Преобразует в дату (дата и время в формате ISO-8601)
cursorstring
Курсор пагинации (из next_cursor предыдущего ответа)
limitinteger
Количество (1-100, по умолчанию 10)
statusenum
Фильтр по статусу

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

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

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

Параметры

cursorstring
Курсор пагинации
limitinteger
Количество (1-100)
payment_idstring
Фильтрует по ID платежа.
refund_idstring
Фильтрует по ID возврата.

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

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

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

Параметры

limitinteger
Количество (1-100)
payment_idstring
Фильтрует по ID платежа.

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

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

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

Параметры

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

save_payment_methodвнешний мир

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

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

Параметры

amountstring | numberобязательный
Сумма блокировки (минимум 1 рубль; списывается, затем возвращается)
currencystring
Валюта (ISO-4217, по умолчанию RUB)
descriptionstring
Описание
payment_method_typeenum
Тип способа оплаты
return_urlstringобязательный
URL для возврата после привязки

`3.0.0`основная	23.06.2026
`2.0.1`	01.04.2026
`2.0.0`	01.04.2026
`1.0.2`	31.03.2026
`1.0.1`	31.03.2026
`1.0.0`	30.03.2026
`0.0.1`	30.03.2026

Выберите клиент, чтобы установить YooKassa MCP:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"yookassa-mcp-5vhp\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@theyahia/yookassa-mcp\"],\"env\":{\"YOOKASSA_SHOP_ID\":\"your-shop-id\",\"YOOKASSA_SECRET_KEY\":\"your-secret-key\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "yookassa-mcp-5vhp": {
      "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-mcp-5vhp --env YOOKASSA_SHOP_ID=your-shop-id --env YOOKASSA_SECRET_KEY=your-secret-key -- npx -y @theyahia/yookassa-mcp

Либо через JSON-конфиг:

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

Codex

Добавьте сервер командой в терминале:

codex mcp add yookassa-mcp-5vhp --env YOOKASSA_SHOP_ID=your-shop-id --env YOOKASSA_SECRET_KEY=your-secret-key -- npx -y @theyahia/yookassa-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.yookassa-mcp-5vhp]
command = "npx"
args = ["-y", "@theyahia/yookassa-mcp"]

[mcp_servers.yookassa-mcp-5vhp.env]
YOOKASSA_SHOP_ID = "your-shop-id"
YOOKASSA_SECRET_KEY = "your-secret-key"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите YooKassa MCP, а в поле команды запуска — строку ниже:

npx -y @theyahia/yookassa-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например yookassa-mcp-5vhp.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: yookassa-mcp-5vhp
    command: npx
    args:
      - "-y"
      - "@theyahia/yookassa-mcp"
    env:
      YOOKASSA_SHOP_ID: your-shop-id
      YOOKASSA_SECRET_KEY: your-secret-key

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

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

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx