Summary
Connects Claude to T-Kassa, the T-Bank payment gateway used across Russia. You get 16 tools covering the full lifecycle: init payments with 54-FZ compliant receipts, confirm or cancel two-step transactions, process refunds, manage saved cards and recurring charges via RebillId, generate SBP QR codes for Faster Payments System transfers, and even pull T-Invest portfolio data if you pass a token. All requests are auto-signed with SHA-256. Useful when you're building checkout flows, subscription billing, or fiscal-compliant retail systems that need programmatic access to Tinkoff's payment rails without writing your own API client.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →🗄 Репозиторий заархивирован
Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро
@theyahia/mcp-core, единый CI, единый релизный конвейер.Актуальная версия того, что лежало здесь:
servers/tkassa/Пакет в npm прежний —
@theyahia/tkassa-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at
servers/tkassa/. The npm package@theyahia/tkassa-mcpis unchanged. Please open issues and pull requests there.
@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
- 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
Telegram: @vhodvai
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
TKASSA_TERMINAL_KEY*secretAPI key for the service
Categories
Registryactive
Package@theyahia/tkassa-mcp
TransportSTDIO
AuthRequired
UpdatedMar 31, 2026
