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
Broad access
Why this level
- The key gives the agent access to the shop's payment data, including amounts, statuses and refunds
- Start with a test-shop key and switch to the real one only after checking how the agent behaves
Install
- Works in
- Services
Manual install
In the YooKassa personal account, under shop integration and access settings, issue an MCP server key for the test shop first, put the server address and key in the agent configuration, verify it on test data, and only then switch to the real shop's key.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The key gives the agent access to the shop's payment data, including amounts, statuses and refunds
- Start with a test-shop key and switch to the real one only after checking how the agent behaves
This is third-party code. Review the repository files before installing.
What it does
YooKassa connects an agent to its payment infrastructure through MCP. The agent can build invoices and payment links right in a conversation, check a payment's status, pull refund data and export a list of operations by given criteria. The key for the server is issued in the personal account and revoked there with one click. The company states directly that the agent prepares a payment scenario but cannot complete a real money movement without a person acting.
Who it is for. For merchants and sellers accepting payments through YooKassa who want to issue invoices and check payments through an agent without opening the dashboard.
Good fit when
- You want to quickly send a customer a payment link right from a chat
- You need to check a payment or refund status without opening the dashboard
- You need a list of operations for a period, filtered by conditions the agent applies
Not a fit when
- You need the agent to initiate money transfers itself: this is not supported, a person always completes the payment
- You have no test shop to try it first: the docs advise connecting with a test-shop token before going live
Example request
Issue a customer a 3500-ruble invoice through YooKassa and send the payment linkMCP
- Transport
- http
- Authentication
- API key
Environment variables
YOOKASSA_MCP_KEYrequired, secret- MCP server access key, issued for the test or real shop in the personal account
Limitations
YooKassa does not publish one public MCP endpoint address, the key and connection address are issued individually in the shop's personal account, under integration and access settings. A full tool list and detailed technical documentation were not found in public sources at the time of review, only announcement material is available. In a test shop some features, such as issuing invoices, are unavailable.
How to disable. Revoke the MCP server access key in the YooKassa personal account and remove the server from your MCP client configuration.
FAQ
Can the agent transfer money on its own?
No, the company states the agent cannot initiate money movement by itself, it only prepares an invoice or a link.
Where do I get the server address and key?
In the YooKassa personal account, under shop integration and access settings, separately for the test and the real shop.
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: 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
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
YooKassa Skill
Yookassa Skill
A reference skill for YooKassa integration: API v3, a TypeScript SDK, one and two-stage payments, webhooks and 54-FZ
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
YooKassa's official Habr announcement describes the MCP server as a way to connect AI agents to the payment infrastructure: the agent creates payment links and invoices, checks statuses and refunds, and exports operations, while the key is issued and revoked in the personal account with one click. It stresses the agent does not control money movement. Descriptions of the connection process found elsewhere show the key is first issued for a test shop, verified on test data, then replaced with the real shop's key.