@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