@theyahia/atol-online-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@theyahia/atol-online-mcp Create a sell receipt for 1x Coffee at 350 rub paid electronically"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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 authentication token |
| Create a sell receipt (fiscal check) |
| Create a sell refund receipt |
| Create a correction receipt |
| Get receipt status/report by UUID |
| Create a buy receipt |
| Create a buy refund receipt |
| Check current token status |
Related MCP server: @theyahia/tkassa-mcp
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 |
| Yes | ATOL Online login |
| Yes | ATOL Online password |
| Yes | KKT group code |
| No | Company INN for receipts |
| 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
Available Tools
8 toolscreate_buy_receiptB
Create a buy receipt (purchase from individual).
Inputs: items (required), payments (required), external_id (required).
create_buy_refundB
Create a buy refund receipt.
Inputs: items (required), payments (required), external_id (required).
create_correctionC
Create a correction receipt (self or by FNS instruction).
Inputs: type (required), items (required), payments (required).
create_sell_receiptB
Create a sell receipt (fiscal check) for 54-FZ compliance.
Inputs: items (required), client (required), payments (required), external_id (required).
create_sell_refundC
Create a sell refund receipt.
Inputs: items (required), payments (required), external_id (required).
get_reportA
Get receipt processing status/report by UUID.
Inputs: uuid (required).
get_tokenA
Get ATOL Online authentication token.
Inputs: login (required), password (required).
get_token_infoB
Check current token status and expiry.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clear, distinct purpose: token management (get_token, get_token_info), receipt creation for each fiscal operation type (sell, sell_refund, buy, buy_refund, correction), and report retrieval. No overlapping functionality.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_token, create_sell_receipt). The use of 'get' for retrieval and 'create' for creation is consistent and predictable.
With 8 tools, the server is well-scoped for the ATOL Online fiscal receipt domain. Each tool covers an essential operation without unnecessary redundancy or bloat.
The tool set covers the full lifecycle of fiscal receipt management: authentication (token retrieval and info), all receipt types (sell, buy, refunds, correction), and status checking via report. No obvious gaps for typical 54-FZ operations.
Related MCP Connectors
Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
A paid remote MCP for hosted MCP server, built to return verdicts, receipts, usage logs, and audit-r
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceMCP server for Altegio API — appointments, clients, services, staff schedules1-
- AlicenseNot gradedqualityFmaintenanceMCP server for T-Kassa (T-Bank/Tinkoff) payment API. Provides 16 tools for payments, refunds, recurring charges, customer management, saved cards, SBP, receipts, and T-Invest portfolio.67 npmMIT
- AlicenseAqualityCmaintenanceMCP server for YooKassa API enabling payments, refunds, receipts, payouts, webhooks, and more via 20 tools.2068 npm4MIT
- AlicenseAqualityDmaintenanceMCP server for Factura.uz electronic invoicing system (Uzbekistan). Supports creating, signing, accepting, and rejecting e-invoices, plus company and product lookups.87 npmMIT