@theyahia/atol-online-mcp
MCP server for ATOL Online fiscal receipt API -- 54-FZ compliant receipt generation, refunds, corrections, and status checks for Russian online cash registers.
Tools
| Tool | Description |
|---|---|
get_token | Get authentication token |
create_sell_receipt | Create a sell receipt (fiscal check) |
create_sell_refund | Create a sell refund receipt |
create_correction | Create a correction receipt |
get_report | Get receipt status/report by UUID |
create_buy_receipt | Create a buy receipt |
create_buy_refund | Create a buy refund receipt |
get_token_info | Check current token status |
Install
Claude Desktop / Cline / Cursor
{
"mcpServers": {
"atol-online": {
"command": "npx",
"args": ["-y", "@theyahia/atol-online-mcp"],
"env": {
"ATOL_LOGIN": "<YOUR_LOGIN>",
"ATOL_PASSWORD": "<YOUR_PASSWORD>",
"ATOL_GROUP_CODE": "<YOUR_GROUP_CODE>",
"ATOL_COMPANY_INN": "<YOUR_INN>",
"ATOL_PAYMENT_ADDRESS": "<YOUR_PAYMENT_URL>"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
ATOL_LOGIN | Yes | ATOL Online login |
ATOL_PASSWORD | Yes | ATOL Online password |
ATOL_GROUP_CODE | Yes | KKT group code |
ATOL_COMPANY_INN | No | Company INN for receipts |
ATOL_PAYMENT_ADDRESS | No | Payment address / URL |
Demo Prompts
- "Create a sell receipt for 1x Coffee at 350 rub paid electronically"
- "Refund the last receipt for item 'Subscription' at 990 rub"
- "Check receipt status for UUID abc-123-def"
- "Create a correction receipt for a missed cash sale of 500 rub"
- "Generate a buy receipt for purchasing supplies at 15000 rub"
- "What's the current token status?"
API Reference
Base URL: https://online.atol.ru/possystem/v5/
Docs: https://online.atol.ru/possystem/v5/
License
MIT