Tkassa MCP

## 🗄 Репозиторий заархивирован

Разработка переехала в [theYahia/WWmcp](https://github.com/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](https://github.com/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-mcp is 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

Get test credentials at T-Kassa Dashboard.

Tools (16)

Payments (5)

Refunds (1)

Customers & Cards (5)

SBP - Fast Payments (2)

Receipts - 54-FZ (1)

T-Invest (2)

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

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

License

MIT

---

Telegram: @vhodvai