About robokassa-mcp
robokassa-mcp is an MCP server for the Robokassa payment API, intended for clients that need to create invoices and check payment status. It generates payment URLs with MD5 signatures and supports optional 54-FZ receipts.
Key features
- 01Generate payment URLs with MD5 signatures
- 02Check invoice status
- 03Support optional 54-FZ receipts
- 04Provide Streamable HTTP transport
Use cases
- 01Create a Robokassa payment URL for an invoice
- 02Check the payment status of a Robokassa invoice
MCP support
The MCP server exposes tools to create payment URLs and check invoice status. It can connect over stdio or Streamable HTTP.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @theyahia/robokassa-mcpROBOKASSA_LOGINSecretAPI key for the serviceLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
2Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| string | No | Buyer's email for the receipt | |
| invId | integer | Yes | Invoice number (unique order ID). 0 = automatic |
| items | array | No | Receipt items (54-ФЗ, if fiscalization is required) |
| outSum | number | Yes | Payment amount in rubles |
| culture | enum | No | Payment interface languageru | en |
| description | string | Yes | Order description (up to 100 characters) |
| expirationDate | string | No | Invoice expiration time in ISO 8601 format (e.g. 2025-12-31T23:59:59) |
Details
From the project README@theyahia/robokassa-mcp
MCP server for Robokassa payment API. 2 tools for invoice creation (with MD5 signature) and status checking.
Quick Start
Claude Desktop
{
"mcpServers": {
"robokassa": {
"command": "npx",
"args": ["-y", "@theyahia/robokassa-mcp"],
"env": {
"ROBOKASSA_LOGIN": "your-login",
"ROBOKASSA_PASSWORD1": "your-password1",
"ROBOKASSA_PASSWORD2": "your-password2"
}
}
}
}
Claude Code
claude mcp add robokassa -e ROBOKASSA_LOGIN=login -e ROBOKASSA_PASSWORD1=pass1 -e ROBOKASSA_PASSWORD2=pass2 -- npx -y @theyahia/robokassa-mcp
Cursor / Windsurf
{
"robokassa": {
"command": "npx",
"args": ["-y", "@theyahia/robokassa-mcp"],
"env": {
"ROBOKASSA_LOGIN": "your-login",
"ROBOKASSA_PASSWORD1": "your-password1",
"ROBOKASSA_PASSWORD2": "your-password2"
}
}
}
Tools
| Tool | Description |
|---|---|
create_invoice | Create payment URL with MD5 signature, optional 54-FZ receipt |
check_invoice | Check invoice status via OpStateExt XML interface |
Auth
| Variable | Required | Description |
|---|---|---|
ROBOKASSA_LOGIN | Yes | Merchant login |
ROBOKASSA_PASSWORD1 | Yes | Password 1 (for payment signature) |
ROBOKASSA_PASSWORD2 | Yes | Password 2 (for status check signature) |
ROBOKASSA_TEST | No | Set to "true" for test mode |
HTTP Transport
HTTP_PORT=3000 npx @theyahia/robokassa-mcp
# or
npx @theyahia/robokassa-mcp --http 3000
Endpoints: POST /mcp (JSON-RPC), GET /health (status).
Skills
- skill-create-invoice -- create a Robokassa payment URL with MD5 signature
- skill-check-payment -- check invoice status via OpStateExt
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.