@theyahia/tkassa-mcp

MCP server for T-Kassa (T-Bank/Tinkoff) payment API. 16 tools: payments, refunds, recurring charges, customer management, saved cards, SBP (Fast Payments), receipts (54-FZ), T-Invest portfolio.

Part of the Russian API MCP series (50 servers) by @theYahia.

Quick Start

Claude Desktop

{
  "mcpServers": {
    "tkassa": {
      "command": "npx",
      "args": ["-y", "@theyahia/tkassa-mcp"],
      "env": {
        "TKASSA_TERMINAL_KEY": "your-terminal-key",
        "TKASSA_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add tkassa -e TKASSA_TERMINAL_KEY=your-key -e TKASSA_PASSWORD=your-password -- npx -y @theyahia/tkassa-mcp

Cursor / Windsurf

{
  "tkassa": {
    "command": "npx",
    "args": ["-y", "@theyahia/tkassa-mcp"],
    "env": {
      "TKASSA_TERMINAL_KEY": "your-terminal-key",
      "TKASSA_PASSWORD": "your-password"
    }
  }
}

Environment Variables

Variable	Required	Description
TKASSA_TERMINAL_KEY	Yes	Terminal key (Dashboard -> Shops -> Terminals)
TKASSA_PASSWORD	Yes	Terminal password (used for SHA-256 token signing)
TINKOFF_INVEST_TOKEN	No	T-Invest API token (for tools 15–16). Get in T-Invest app: Settings → OpenAPI Token

Get test credentials at T-Kassa Dashboard.

Tools (16)

Payments (5)

Tool	Description
init_payment	Create a payment. Returns PaymentURL. Supports one-step/two-step, receipts (54-FZ), recurring, DATA fields
get_payment_state	Get payment status by PaymentId (NEW, AUTHORIZED, CONFIRMED, REVERSED, REFUNDED, REJECTED)
confirm_payment	Confirm a two-step payment. Supports partial confirmation
cancel_payment	Cancel a payment (before or after confirmation). Supports partial cancellation
charge_payment	Charge a recurring payment using RebillId from a saved card

Refunds (1)

Tool	Description
refund_payment	Full or partial refund. Payment must be in CONFIRMED status

Customers & Cards (5)

Tool	Description
add_customer	Register a customer for saving cards and recurring payments
get_customer	Get customer data (Email, Phone) by CustomerKey
remove_customer	Remove a customer and all saved cards
get_card_list	List saved cards (CardId, Pan, ExpDate, RebillId)
remove_card	Remove a saved card by CardId

SBP - Fast Payments (2)

Tool	Description
create_sbp_qr	Generate QR code for SBP payment (payload link or base64 PNG)
get_sbp_qr_state	Check SBP QR payment status

Receipts - 54-FZ (1)

Tool	Description
send_closing_receipt	Send a closing receipt with Items (Name, Price, Quantity, Tax) for fiscal compliance

T-Invest (2)

Requires TINKOFF_INVEST_TOKEN. If not set, these tools return a descriptive error.

Tool	Description
get_invest_portfolio	Get investment portfolio: stocks, bonds, ETFs, current value and P&L
find_instrument	Search instrument by ticker, ISIN, or company name. Returns FIGI key

Auth

Every request is signed with SHA-256:

Token = SHA-256(concat(sorted values of {Password, TerminalKey, ...params}))

Only scalar values participate in signing. Nested objects (Receipt, DATA) are excluded. Handled automatically.

HTTP Transport

HTTP_PORT=3000 npx @theyahia/tkassa-mcp
# or
npx @theyahia/tkassa-mcp --http 3000

Endpoints: POST /mcp (JSON-RPC), GET /health (status).

Skills

• **ski

... View full README on GitHub