Tkassa Mcp

io.github.theYahia由 GitHub 帳號 theYahia 發布v1.0.0更新於 Oct 24, 2026

MCP server for T-Kassa (T-Bank/Tinkoff) payment API — payments, refunds. 5 tools. First MCP for T-K

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

針對 T-Kassa（T-Bank/Tinkoff）支付 API 的在地 MCP 伺服器，讓助理建立與管理付款、退款、客戶、已存卡片、SBP QR code、54-FZ 收據及 T-Invest 投資組合查詢。

可以做什麼
建立與管理付款：發起一步或兩步付款、查詢狀態、確認或取消，並用已存卡片進行循環扣款。對已確認付款辦理全額或部分退款。管理客戶與卡片：註冊、查詢和移除客戶，列出和移除已存卡片。產生 SBP 快速支付 QR code 並查詢其付款狀態。傳送 54-FZ 結帳收據，包含品項、價格、數量和稅額。查詢 T-Invest 投資組合持股，並依代碼、ISIN 或名稱搜尋標的。
適用情境
當你使用 T-Kassa 商戶終端，希望助理在對話中草擬、追蹤或調整付款與退款、管理循環付款客戶和卡片，或處理 SBP 與稅務收據時適用。也適合快速查詢 T-Invest 投資組合。
執行需求
透過 npx 以 npm 套件形式在本機執行（需要 Node.js）。需要 T-Kassa 終端金鑰 TKASSA_TERMINAL_KEY 和用於請求簽章的終端密碼 TKASSA_PASSWORD；選用的 T-Invest 工具需要 TINKOFF_INVEST_TOKEN。需要連線至 T-Kassa API 的網路。另提供指定埠號的 HTTP 模式。
安裝前請注意
涉及真實資金：工具可建立付款、對已存卡片扣款、確認、取消和退款，並傳送稅務收據。終端密碼和 API 權杖屬敏感資訊，以環境變數傳入。移除客戶會同時刪除其所有已存卡片。README 說明儲存庫已封存、開發移至另一個單體儲存庫，但稱 npm 套件維持不變。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tkassa Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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

Разработка переехала в 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-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.

[npm] [license]

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

Quick Start

Claude Desktop

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

Claude Code

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

Cursor / Windsurf

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

Environment Variables

VariableRequiredDescription
TKASSA_TERMINAL_KEYYesTerminal key (Dashboard -> Shops -> Terminals)
TKASSA_PASSWORDYesTerminal password (used for SHA-256 token signing)
TINKOFF_INVEST_TOKENNoT-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)

ToolDescription
init_paymentCreate a payment. Returns PaymentURL. Supports one-step/two-step, receipts (54-FZ), recurring, DATA fields
get_payment_stateGet payment status by PaymentId (NEW, AUTHORIZED, CONFIRMED, REVERSED, REFUNDED, REJECTED)
confirm_paymentConfirm a two-step payment. Supports partial confirmation
cancel_paymentCancel a payment (before or after confirmation). Supports partial cancellation
charge_paymentCharge a recurring payment using RebillId from a saved card

Refunds (1)

ToolDescription
refund_paymentFull or partial refund. Payment must be in CONFIRMED status

Customers & Cards (5)

ToolDescription
add_customerRegister a customer for saving cards and recurring payments
get_customerGet customer data (Email, Phone) by CustomerKey
remove_customerRemove a customer and all saved cards
get_card_listList saved cards (CardId, Pan, ExpDate, RebillId)
remove_cardRemove a saved card by CardId

SBP - Fast Payments (2)

ToolDescription
create_sbp_qrGenerate QR code for SBP payment (payload link or base64 PNG)
get_sbp_qr_stateCheck SBP QR payment status

Receipts - 54-FZ (1)

ToolDescription
send_closing_receiptSend 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.

ToolDescription
get_invest_portfolioGet investment portfolio: stocks, bonds, ETFs, current value and P&L
find_instrumentSearch 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

bash
HTTP_PORT=3000 npx @theyahia/tkassa-mcp# ornpx @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:

json
{  "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 [email protected].

Set up recurring payments:

Register customer "cust-123" with email [email protected], 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

MCPStatusDescription
@metarebalance/dadata-mcpreadyAddresses, companies, banks, phones
@theyahia/cbr-mcpreadyExchange rates, key rate
@theyahia/yookassa-mcpreadyPayments, refunds, receipts 54-FZ
@theyahia/tkassa-mcpv2.116 tools -- payments, refunds, recurring, SBP, receipts, T-Invest
...soon+46 servers -- full list

License

MIT

Telegram: @vhodvai

來源：README.md，提交 db6d17a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分