How do I use @theyahia/tkassa-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@theyahia/tkassa-mcp Create a payment for 1500 rubles" 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/tkassa-mcp

by theYahia

Overview Schema Related Servers Score Discussions

TypeScript

Remote

@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.

npm license

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"
    }
  }
}

Related MCP server: maib-mcp

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

skill-create-payment -- create a payment and get a payment URL
skill-payment-status -- check payment status by PaymentId

Webhook Notifications

T-Kassa sends POST notifications to your notification_url (set in init_payment) when payment status changes:

{
  "TerminalKey": "your-key",
  "OrderId": "your-order-id",
  "Success": true,
  "Status": "CONFIRMED",
  "PaymentId": 123456789,
  "ErrorCode": "0",
  "Amount": 10000,
  "RebillId": 987654321,
  "CardId": 12345,
  "Pan": "430000******0777",
  "ExpDate": "1230",
  "Token": "sha256-signature"
}

Verify by computing the Token the same way (sorted values concat + SHA-256) and comparing.

Notes

Base URL: https://securepay.tinkoff.ru/v2/
Amounts are in kopecks internally (server converts rubles automatically)
Automatic retry with exponential backoff on 429/5xx
API docs: https://www.tbank.ru/kassa/dev/payments/

Demo Prompts

Create a payment with receipt:

Create a payment for 1500 rubles, order "order-42", with a receipt: 1x "Premium subscription" at 1500 RUB, VAT 20%, tax system USN income. Send receipt to user@example.com.

Set up recurring payments:

Register customer "cust-123" with email user@example.com, then create a recurring payment for 990 rubles on order "sub-monthly-1".

Refund and check status:

Refund 500 rubles from payment 777888999, then check its current status.

Series: Russian API MCP

MCP	Status	Description
@metarebalance/dadata-mcp	ready	Addresses, companies, banks, phones
@theyahia/cbr-mcp	ready	Exchange rates, key rate
@theyahia/yookassa-mcp	ready	Payments, refunds, receipts 54-FZ
@theyahia/tkassa-mcp	v2.1	16 tools -- payments, refunds, recurring, SBP, receipts, T-Invest
...	soon	+46 servers -- full list

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

@theyahia/yookassa-mcp
Payments & Billing Finance E-commerce & Retail
theYahia
A
license
-
quality
B
maintenance
MCP server for YooKassa API enabling payments, refunds, receipts, payouts, webhooks, and more via 20 tools.
Last updated 2026-06-23
86
3
MIT
maib-mcp
Payments & Billing E-commerce & Retail
theYahia
A
license
A
quality
D
maintenance
MCP server for MAIB e-commerce payments (Moldova). Supports payments, refunds, recurring billing, one-click payments, and transaction status via OAuth 2.0.
Last updated 2026-04-01
8
4
MIT
bepaid-mcp
Payments & Billing E-commerce & Retail
theYahia
A
license
-
quality
D
maintenance
MCP server for bePaid payment gateway enabling payment operations including create, capture, void, refund, card tokenization, and subscriptions through natural language prompts.
Last updated 2026-04-01
6
MIT
bog-ipay-mcp
Payments & Billing Finance
theYahia
A
license
-
quality
D
maintenance
MCP server for Bank of Georgia iPay payment gateway, enabling payment orders, refunds, recurring payments, and pre-authorization via OAuth 2.0 + JWT.
Last updated 2026-04-01
2
MIT

View all related MCP servers

Related MCP Connectors

inflow
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
mcp
MCP server integrating with Stripe - tools for customers, products, payments, and more.
fastmcpruntime-mcp
A paid remote MCP for hosted MCP server, built to return verdicts, receipts, usage logs, and audit-r

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/tkassa-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

@theyahia/tkassa-mcp

Quick Start

Claude Desktop

Claude Code

Cursor / Windsurf

Environment Variables

Tools (16)

Payments (5)

Refunds (1)

Customers & Cards (5)

SBP - Fast Payments (2)

Receipts - 54-FZ (1)

T-Invest (2)

Auth

HTTP Transport

Skills

Webhook Notifications

Notes

Demo Prompts

Series: Russian API MCP

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

@theyahia/yookassa-mcp

maib-mcp

bepaid-mcp

bog-ipay-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API