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
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
Install
- Works in
- Services
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.
Access and checks
How we reviewBroad 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 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.
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.
Related
All YooKassa toolsYooKassa MCP
yookassa-mcp
YooKassa MCP server: payments, refunds, 54-FZ receipts, payouts and webhooks straight from an agent chat
YooKassa Skill
Yookassa Skill
A reference skill for YooKassa integration: API v3, a TypeScript SDK, one and two-stage payments, webhooks and 54-FZ
YooKassa MCP server
MCP-сервер ЮKassa
YooKassa official MCP: an agent creates payment links and invoices, checks statuses and refunds, but cannot move money on its own
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
A skill pack for small business operations in Russia: simplified tax, cash flow, receivables, contracts, hiring and counterparty checks by INN
Open-source Next.js SaaS: from a short brief, Claude writes a title, description and bullets for a Wildberries, Ozon or Amazon listing
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.