Server data from the Official MCP Registry
MCP server for T-Kassa (T-Bank/Tinkoff) payment API — payments, refunds. 5 tools. First MCP for T-K
MCP server for T-Kassa (T-Bank/Tinkoff) payment API — payments, refunds. 5 tools. First MCP for T-K
Valid MCP server (2 strong, 3 medium validity signals). 1 code issue detected. No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
12 files analyzed · 2 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: TKASSA_TERMINAL_KEY
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-theyahia-tkassa-mcp": {
"env": {
"TKASSA_TERMINAL_KEY": "your-tkassa-terminal-key-here"
},
"args": [
"-y",
"@theyahia/tkassa-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
{
"mcpServers": {
"tkassa": {
"command": "npx",
"args": ["-y", "@theyahia/tkassa-mcp"],
"env": {
"TKASSA_TERMINAL_KEY": "your-terminal-key",
"TKASSA_PASSWORD": "your-password"
}
}
}
}
claude mcp add tkassa -e TKASSA_TERMINAL_KEY=your-key -e TKASSA_PASSWORD=your-password -- npx -y @theyahia/tkassa-mcp
{
"tkassa": {
"command": "npx",
"args": ["-y", "@theyahia/tkassa-mcp"],
"env": {
"TKASSA_TERMINAL_KEY": "your-terminal-key",
"TKASSA_PASSWORD": "your-password"
}
}
}
| 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.
| 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 |
| Tool | Description |
|---|---|
refund_payment | Full or partial refund. Payment must be in CONFIRMED status |
| 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 |
| 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 |
| Tool | Description |
|---|---|
send_closing_receipt | Send a closing receipt with Items (Name, Price, Quantity, Tax) for fiscal compliance |
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 |
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_PORT=3000 npx @theyahia/tkassa-mcp
# or
npx @theyahia/tkassa-mcp --http 3000
Endpoints: POST /mcp (JSON-RPC), GET /health (status).
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.
https://securepay.tinkoff.ru/v2/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.
| 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 |
MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.