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
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
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
Install
Manual install
codex plugin marketplace add Belolipetsky/YooKassa-MCP --ref main
codex plugin add yookassa-integration-agent@yookassaInstalling the plugin and marketplace from the repository after merging into main.
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 webhookLimitations
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.
Security check
- 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
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.
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.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail