io.github.dontsovcmc/tochka-bank
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TOCHKA_TOKEN | Yes | Your JWT token from Tochka Bank API |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| goods_listA | List all goods from local catalog. Use goods_add/goods_remove to manage. Returns JSON array of goods with name, unit, and price. |
| goods_addA | Add a new good to local catalog. Args: name: Product name (e.g. "Wi-Fi модем Ватериус") unit: Unit of measurement (шт., компл., усл.ед., etc.) price: Price per unit as string (e.g. "5290.00") |
| goods_removeA | Remove a good from local catalog by exact name. Args: name: Exact product name to remove |
| tochka_balanceA | Get bank account balance from Tochka Bank. For all accounts at once, use tochka_all_balances. Returns JSON with accountId, customerCode, currency, and balances (OpeningAvailable, ClosingAvailable, Expected). |
| tochka_paymentA | Create outgoing payment order (I pay someone). Returns signing URL. The payment must be signed in Tochka internet bank to be processed. Args: counterparty_name: Recipient company name counterparty_inn: Recipient INN (10-12 digits) counterparty_bic: Recipient bank BIC (9 digits) counterparty_account: Recipient account number (20 digits) counterparty_corr_account: Recipient bank correspondent account (20 digits) amount: Payment amount in rubles purpose: Payment purpose (max 210 chars) counterparty_kpp: Recipient KPP (optional, 9 digits) |
| tochka_invoiceB | Issue an invoice to a buyer (they pay me). Returns documentId. Args: buyer_name: Buyer company name buyer_inn: Buyer INN buyer_type: "company" or "ip" number: Invoice number positions: JSON array of positions, each with positionName, unitCode, ndsKind, price, quantity, totalAmount buyer_kpp: Buyer KPP (optional) buyer_address: Buyer legal address (optional) total: Total amount (calculated from positions if empty) nds_total: Total VAT amount (optional) based_on: Basis document (optional) comment: Comment (optional) pay_until_date: Payment deadline YYYY-MM-DD (optional) |
| tochka_download_invoiceA | Download invoice PDF to local file. Args: document_id: Invoice UUID from tochka_invoice result output_path: Absolute path to save PDF (e.g. /tmp/invoice_42.pdf) |
| tochka_updA | Create UPD (universal transfer document). Returns documentId and signURL. function defaults to "schfdop" (invoice + primary document). Args: buyer_name: Buyer company name buyer_inn: Buyer INN buyer_type: "company" or "ip" number: UPD number positions: JSON array of positions (same format as invoice) buyer_kpp: Buyer KPP (optional) buyer_address: Buyer legal address (optional) total: Total amount (calculated from positions if empty) nds_total: Total VAT amount (optional) based_on: Basis document (optional) parent_document_id: Parent invoice UUID (optional, links UPD to invoice) function: "schfdop" (invoice + primary) or "dop" (primary only) |
| tochka_searchA | Search bank transactions by counterparty INN or name via statements. Returns full counterparty details including bank BIC, account and correspondent account — enough to create a payment via tochka_payment without asking the user for details. Args: query: INN or part of counterparty name days: Search depth in days (default 90) |
| tochka_incomingA | Get incoming (Credit) bank transactions for a month, grouped by debtor INN. Useful for tax reports (AUSN vzaimozachet) — shows how much was received from each counterparty in a given month. Args: month: Month number (1-12) year: Year (e.g. 2026) inn: Optional debtor INN filter (e.g. "6316049606") description: Optional substring filter for payment description (case-insensitive, e.g. "РОБОКАССА") |
| tochka_track_invoiceA | Start tracking an invoice for payment. Persists across sessions. Use tochka_pending_invoices to list tracked invoices, tochka_check_invoices to check payments. Args: number: Invoice number (e.g. "140") buyer_inn: Buyer INN (who should pay) buyer_name: Buyer company name amount: Expected payment amount (e.g. "5290.00") description: Invoice description (e.g. "Счёт №140 от 2026-04-10") document_id: Tochka documentId UUID (optional, for invoices created via tochka_invoice) |
| tochka_untrack_invoiceA | Stop tracking an invoice by its number. Args: number: Invoice number (from tochka_track_invoice or tochka_pending_invoices) |
| tochka_pending_invoicesA | List all invoices being tracked for payment. Use tochka_check_invoices to verify payment status. Returns JSON array of pending invoices with number, buyer_inn, buyer_name, amount, description, created_at. |
| tochka_check_invoicesA | Check all pending invoices for payment. Automatically removes paid ones from tracking. Two strategies:
Fallback match criteria (all must be true):
Args: days: Statement depth in days for fallback (default 30) |
| tochka_account_detailA | Get detailed account information. Args: account_id: Account ID (e.g. "40702810100000000001/044525000"). Uses first account if empty. |
| tochka_all_balancesA | Get balances for all accounts at once. For a single account's balance, use tochka_balance. Returns JSON array of balances across all accessible accounts. |
| tochka_statements_listB | Get list of recent statements. Args: limit: Maximum number of statements (default 5) |
| tochka_card_transactionsA | Get authorized card transactions for account. Args: account_id: Account ID. Uses first account if empty. |
| tochka_customersA | Get list of all accessible customers (organizations). For details on a specific customer, use tochka_customer. |
| tochka_customerA | Get detailed customer information. Use tochka_customers to list all available customer codes. Args: customer_code: Customer identifier (e.g. "100000001") |
| tochka_delete_invoiceA | Delete an invoice by document ID. Args: document_id: Invoice UUID from tochka_invoice result |
| tochka_send_invoice_emailB | Send invoice to specified email address. Args: document_id: Invoice UUID from tochka_invoice result email: Recipient email address |
| tochka_delete_closing_documentA | Delete a closing document (UPD/Act) by document ID. Args: document_id: Closing document UUID from tochka_upd result |
| tochka_send_closing_document_emailB | Send closing document to specified email address. Args: document_id: Closing document UUID from tochka_upd result email: Recipient email address |
| tochka_download_closing_documentA | Download closing document PDF to local file. Args: document_id: Closing document UUID from tochka_upd result output_path: Absolute path to save PDF (e.g. /tmp/upd_42.pdf) |
| tochka_payments_for_signA | Get list of payment orders created for signing. |
| tochka_acquiring_paymentsA | Get list of acquiring payment operations. Args: page: Page number (default 1) per_page: Results per page (default 1000) from_date: Start date filter YYYY-MM-DD (optional) to_date: End date filter YYYY-MM-DD (optional) status: Filter by status: CREATED, APPROVED, ON-REFUND, REFUNDED, EXPIRED (optional) |
| tochka_acquiring_payment_createA | Create acquiring payment operation (payment link). For payment with fiscal receipt, use tochka_acquiring_payment_with_receipt. Args: customer_code: Customer code (9 chars, e.g. "100000001") amount: Payment amount (> 0) purpose: Payment purpose (1-140 chars) payment_mode: Allowed payment methods, e.g. ["sbp", "card"] redirect_url: Success redirect URL (optional) fail_redirect_url: Failure redirect URL (optional) save_card: Save card for future payments (optional) consumer_id: Consumer identifier (optional) merchant_id: Merchant identifier, 15 chars (optional) pre_authorization: Two-stage payment mode (optional) ttl: Link lifetime in minutes, 1-44640, default 10080 (optional) payment_link_id: Custom payment link ID, 1-45 chars (optional) |
| tochka_acquiring_paymentB | Get acquiring payment operation details. Args: operation_id: Payment operation ID |
| tochka_acquiring_payment_captureB | Capture funds for two-stage acquiring payment. Args: operation_id: Payment operation ID |
| tochka_acquiring_payment_refundA | Refund an acquiring payment (only for APPROVED status). Args: operation_id: Payment operation ID amount: Refund amount (must not exceed payment amount) |
| tochka_acquiring_payment_with_receiptA | Create acquiring payment operation with fiscal receipt. For payment without receipt, use tochka_acquiring_payment_create. Args: customer_code: Customer code (9 chars, e.g. "100000001") amount: Payment amount (> 0) purpose: Payment purpose (1-140 chars) payment_mode: Allowed payment methods, e.g. ["sbp", "card"] client_email: Receipt recipient email items_json: JSON array of receipt items [{name, amount, quantity, vatType?, paymentMethod?, paymentObject?}] redirect_url: Success redirect URL (optional) fail_redirect_url: Failure redirect URL (optional) save_card: Save card for future payments (optional) consumer_id: Consumer identifier (optional) merchant_id: Merchant identifier, 15 chars (optional) pre_authorization: Two-stage payment mode (optional) ttl: Link lifetime in minutes, 1-44640, default 10080 (optional) payment_link_id: Custom payment link ID, 1-45 chars (optional) client_name: Receipt recipient name (optional) client_phone: Receipt recipient phone (optional) tax_system_code: Tax system: osn, usn_income, usn_income_outcome, esn, patent (optional) |
| tochka_acquiring_registryA | Get acquiring payment registry for a specific date. Use tochka_acquiring_retailers to get valid merchant_id values. Args: merchant_id: Merchant identifier registry_date: Registry date YYYY-MM-DD |
| tochka_acquiring_retailersA | Get list of acquiring retailers (merchant points). |
| tochka_subscription_createA | Create recurring payment subscription. For subscription with fiscal receipt, use tochka_subscription_with_receipt. Args: customer_code: Customer code (9 chars, e.g. "100000001") amount: Subscription amount (> 0) purpose: Subscription purpose (1-140 chars) redirect_url: Success redirect URL (optional) fail_redirect_url: Failure redirect URL (optional) save_card: Save card for future payments (optional) consumer_id: Consumer identifier (optional) merchant_id: Merchant identifier (optional) recurring: Enable recurring charges (optional) payment_link_id: Custom payment link ID, 1-45 chars (optional) |
| tochka_subscriptionsA | Get list of payment subscriptions. Args: page: Page number (default 1) per_page: Results per page (default 1000) |
| tochka_subscription_chargeB | Charge a subscription (recurring payment debit). Args: operation_id: Subscription operation ID amount: Charge amount |
| tochka_subscription_statusA | Get subscription status. Args: operation_id: Subscription operation ID |
| tochka_subscription_status_setB | Set subscription status (cancel subscription). Args: operation_id: Subscription operation ID status: New status (only "Cancelled" is allowed) |
| tochka_subscription_with_receiptA | Create subscription with fiscal receipt. For subscription without receipt, use tochka_subscription_create. Args: customer_code: Customer code (9 chars, e.g. "100000001") amount: Subscription amount (> 0) purpose: Subscription purpose (1-140 chars) client_email: Receipt recipient email items_json: JSON array of receipt items [{name, amount, quantity, vatType?, paymentMethod?, paymentObject?}] redirect_url: Success redirect URL (optional) fail_redirect_url: Failure redirect URL (optional) save_card: Save card for future payments (optional) consumer_id: Consumer identifier (optional) merchant_id: Merchant identifier (optional) recurring: Enable recurring charges (optional) payment_link_id: Custom payment link ID, 1-45 chars (optional) client_name: Receipt recipient name (optional) client_phone: Receipt recipient phone (optional) tax_system_code: Tax system: osn, usn_income, usn_income_outcome, esn, patent (optional) |
| tochka_consentsA | Get list of all API consents (permissions). |
| tochka_consent_createB | Create a new API consent. Args: permissions: List of permission strings (e.g. ["ReadAccountsBasic", "ReadBalances"]) expiration_date_time: Consent expiry in ISO8601 format (optional) |
| tochka_consentB | Get consent details. Args: consent_id: Consent identifier |
| tochka_consent_childrenA | Get all child consents for a given consent. Args: consent_id: Parent consent identifier |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| pay_by_name | Quick payment by counterparty name — searches recent transactions, reuses details. |
| monthly_income | Monthly income report grouped by counterparty. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| goods_catalog_resource | Local goods catalog for use in invoices and UPDs. |
| pending_invoices_resource | Invoices currently being tracked for payment. |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/dontsovcmc/mcp-server-tochka-bank'
If you have feedback or need assistance with the MCP directory API, please join our Discord server