Skip to main content
Glama
@theyahia/atol-online-mcp

@theyahia/atol-online-mcp

by theYahia

@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

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

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

Available Tools

8 tools
create_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

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers