Skip to main content
Glama
dontsovcmc

io.github.dontsovcmc/tochka-bank

by dontsovcmc

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TOCHKA_TOKENYesYour JWT token from Tochka Bank API

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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:

  • With document_id: uses Tochka payment-status API (fast, exact)

  • Without document_id: searches bank statement by buyer INN + amount (fallback)

Fallback match criteria (all must be true):

  • Incoming (Credit) transaction

  • Debtor INN matches buyer_inn

  • Transaction date >= invoice created_at

  • abs(transaction amount - invoice amount) <= 1 ruble

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

NameDescription
pay_by_nameQuick payment by counterparty name — searches recent transactions, reuses details.
monthly_incomeMonthly income report grouped by counterparty.

Resources

Contextual data attached and managed by the client

NameDescription
goods_catalog_resourceLocal goods catalog for use in invoices and UPDs.
pending_invoices_resourceInvoices currently being tracked for payment.

Latest Blog Posts

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