MCPHIVE

Т-Касса MCP: Documentation

Updated:

Connection

npx -y @theyahia/tkassa-mcp (stdio) or HTTP_PORT=3000 npx @theyahia/tkassa-mcp --http (JSON-RPC + /health). Auth: TKASSA_TERMINAL_KEY + TKASSA_PASSWORD — from the T-Kassa dashboard (tbank.ru/kassa) → Shops → Terminals. The password feeds into the SHA-256 signature on every request; the server computes it for you.

Capabilities

14 tools: payments (init_payment — create, returns a PaymentURL; get_payment_state, confirm_payment — including partial confirmation of a two-step payment, cancel_payment, charge_payment — charge via a saved card's RebillId), refunds (refund_payment — full or partial), customers and cards (add_customer, get_customer, remove_customer, get_card_list, remove_card), SBP (create_sbp_qr — a link or PNG QR code, get_sbp_qr_state), 54-FZ receipts (send_closing_receipt).

Agent flow

"Create a 1,500 RUB payment for order order-42 with a receipt: Premium subscription, 20% VAT", "register a customer and set up a recurring 990 RUB payment", "refund 500 RUB on payment 777888999 and check its status".

Note

A community project (theYahia), not an official T-Bank product. The terminal key moves real money — start with a test terminal from the dashboard before switching to production.

Т-Касса MCP — Documentation