YooKassa: technical integration agent for Codex

ЮKassa: ИИ-агент технической интеграции для Codex

A Codex plugin with five skills and thirteen read-only MCP tools for YooKassa integration: design, code, receipts, diagnostics, review

  • 0 ★ on the repository
  • Last commit
  • MIT
Plugin

Broad access

Why this level

  • The project is in the payments domain: even without write tools, the agent works with credentials and money-acceptance logic
  • Diagnostics reads test-shop payment, refund and receipt data using a secret key
All reasons and checks
Russian stack

belolipetsky/yookassa-mcp

Install

Works in
Services

Manual install

codex plugin marketplace add Belolipetsky/YooKassa-MCP --ref main
codex plugin add yookassa-integration-agent@yookassa

Installing the plugin and marketplace from the repository after merging into main.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The project is in the payments domain: even without write tools, the agent works with credentials and money-acceptance logic
  • Diagnostics reads test-shop payment, refund and receipt data using a secret key

This is third-party code. Review the repository files before installing.

What it does

The plugin helps a developer design and implement a YooKassa integration without the agent itself processing payments. Five skills cover the whole cycle: payment flow architecture with idempotency and webhooks, production code and tests for the project's stack, technical receipt checks under Russia's 54-FZ and product labeling rules, read-only diagnostics limited to a test shop, and a security review of a finished integration. Thirteen MCP tools give search and detail lookups against a YooKassa OpenAPI snapshot, offline request validation, error explanation, and reads of payments, refunds, receipts and payment methods for a test shop. Diagnostics check the test=true flag on the payment object and refuse to run if the shop is not confirmed as a test one.

Who it is for. For developers embedding YooKassa payments into their product who want an agent helper without the risk of real charges

Good fit when

  • You need to design a payment flow with idempotency and webhooks for your stack
  • You need a technical check that receipts comply with 54-FZ before release
  • You need read-only diagnostics for why a test-shop payment is stuck pending

Not a fit when

  • You want the agent itself to create, confirm or cancel real payments: the plugin intentionally excludes this
  • You have no YooKassa test shop for diagnostics

Example request

Design a YooKassa integration for a subscription in this Next.js project with idempotency and a webhook

Limitations

The project has no stars, a single author. The API catalog is a vetted slice of a YooKassa OpenAPI snapshot from July 29, 2026; check the vendor's current changelog before release. MCP works only over stdio, there is no HTTP server. The receipt check does not replace advice from a lawyer, accountant or fiscal-equipment specialist. Not all payment methods are available in YooKassa test mode.

How to disable. Remove the plugin with codex plugin remove yookassa-integration-agent or the equivalent command in your Codex version.

FAQ

Can the agent process a real payment?

No, the MVP intentionally excludes financial write tools: the agent does not create, confirm, cancel payments or issue refunds.

What if I use a live shop's credentials?

The plugin checks the test=true flag on the payment object and blocks diagnostics if the shop is not confirmed as a test one.

Discussion

No questions or reviews yet.

YooKassa MCP

yookassa-mcp

Russian stack

YooKassa MCP server: payments, refunds, 54-FZ receipts, payouts and webhooks straight from an agent chat

MCP serverBroad access4Repository stars

YooKassa Skill

Yookassa Skill

Russian stack

A reference skill for YooKassa integration: API v3, a TypeScript SDK, one and two-stage payments, webhooks and 54-FZ

SkillMinimal access

YooKassa MCP server

MCP-сервер ЮKassa

Official

YooKassa official MCP: an agent creates payment links and invoices, checks statuses and refunds, but cannot move money on its own

MCP serverBroad access
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38Repository stars
Russian stack

A skill pack for small business operations in Russia: simplified tax, cash flow, receivables, contracts, hiring and counterparty checks by INN

PluginExtended access34Repository stars

README in short

The README frames the plugin as an evolution of an earlier YooKassa MCP, with an explicit list of five skills and thirteen read-only tools. It gives codex plugin marketplace install commands, example agent requests, local development and build steps, links to official YooKassa documentation, and an explicit limitations section about the lack of financial operations and HTTP transport.

README badge

Report a problem