Tochka Bank

io.github.dontsovcmcPublished by GitHub account dontsovcmcv0.6.2Updated Oct 27, 2026

MCP server for Tochka Bank API — payments, invoices, acquiring, subscriptions

VerifiedSTDIODesktop onlyProductivity & WorkflowFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Tochka Bank's API that lets an assistant check balances, create payments and invoices, manage acquiring and subscriptions, and track…

What you can do
  • Check balances, account details, statements and card transactions
  • Create outgoing payments and UPD documents, and get signing links
  • Issue, download, email and delete invoices and closing documents
  • Search operations by counterparty INN or name, and list monthly incoming receipts
  • Manage acquiring payments, payment links, refunds, captures and retail points
  • Create and manage subscriptions, consents, and a local goods catalog
When to use it
Useful for small businesses or accountants on Tochka Bank who want to ask an assistant about balances and statements, prepare invoices and payments for signing, or follow up on unpaid invoices without opening the online bank.
Requirements
Runs locally as a Python package (uvx or pip) over stdio, so uv or Python is needed. Requires a JWT token from Tochka's online bank (Settings, Integrations and API) supplied in the TOCHKA_TOKEN environment variable, with the relevant read and write scopes selected. Network access to the Tochka API is required.
Before you install
The token grants access to real bank data and, depending on scopes, to creating payments, invoices, acquiring charges and refunds, and deleting documents. Payments and UPDs are created for signing rather than executed directly, but other tools act immediately, including sending emails and deleting invoices. The token is passed as an environment variable and should be scoped narrowly and kept out of shared configs. Pending invoices and goods are stored in local config files.

Installation

In SourceWeft

  1. Open Tochka Bank in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-server-tochka-bank

MCP-сервер для работы с API банка Точка через Claude Code, Claude Desktop и другие MCP-совместимые клиенты.

Все данные остаются на вашем компьютере — токен никуда не передаётся.

Возможности

Банковские операции

ИнструментОписание
tochka_balanceБаланс счёта
tochka_paymentСоздать исходящий платёж (я плачу кому-то), получить ссылку на подпись
tochka_invoiceВыставить счёт покупателю (мне платят)
tochka_download_invoiceСкачать PDF счёта
tochka_updСоздать УПД (универсальный передаточный документ), получить ссылку на подпись
tochka_searchПоиск операций по ИНН или названию контрагента (возвращает полные реквизиты: БИК, счёт, корр.счёт)
tochka_incomingВходящие поступления за месяц, сгруппированные по ИНН отправителя (для налоговых отчётов АУСН)

Счета и документы (дополнительно)

ИнструментОписание
tochka_account_detailДетали банковского счёта
tochka_all_balancesБалансы всех счетов
tochka_statements_listСписок последних выписок
tochka_card_transactionsАвторизованные карточные транзакции
tochka_customersСписок клиентов (организаций)
tochka_customerДетали клиента
tochka_delete_invoiceУдалить счёт
tochka_send_invoice_emailОтправить счёт на email
tochka_delete_closing_documentУдалить закрывающий документ
tochka_send_closing_document_emailОтправить закрывающий документ на email
tochka_download_closing_documentСкачать PDF закрывающего документа
tochka_payments_for_signСписок платежей на подпись

Эквайринг (платёжные ссылки)

ИнструментОписание
tochka_acquiring_paymentsСписок операций эквайринга
tochka_acquiring_payment_createСоздать платёжную ссылку
tochka_acquiring_paymentДетали операции эквайринга
tochka_acquiring_payment_captureСписать средства (двухстадийный платёж)
tochka_acquiring_payment_refundВозврат платежа
tochka_acquiring_payment_with_receiptСоздать платёж с фискальным чеком
tochka_acquiring_registryРеестр платежей эквайринга
tochka_acquiring_retailersСписок торговых точек

П��дписки (рекуррентные платежи)

ИнструментОписание
tochka_subscription_createСоздать подписку
tochka_subscriptionsСписок подписок
tochka_subscription_chargeСписание по подписке
tochka_subscription_statusСтатус подписки
tochka_subscription_status_setУстановить статус подписки
tochka_subscription_with_receiptСоздать подписку с фискальным чеком

Разрешения API (Consents)

ИнструментОписание
tochka_consentsСписок разрешений
tochka_consent_createСоздать разрешение
tochka_consentДетали разрешения
tochka_consent_childrenДочерние разрешения

Отслеживание оплаты счетов

ИнструментОписание
tochka_track_invoiceДобавить счёт в отслеживание оплаты
tochka_untrack_invoiceУбрать счёт из отслеживания
tochka_pending_invoicesСписок счетов, ожидающих оплаты
tochka_check_invoicesПроверить все ожидающие счета, оплаченные удаляются автоматически

Данные хранятся в ~/.config/mcp-server-tochka-bank/pending_invoices.json.

Два способа отслеживания в зависимости от того, как был создан счёт:

Счёт создан через MCP-сервер (tochka_invoice) — данные сохраняются автоматически. Проверка оплаты через payment-status API Точки. Признак оплаты: статус счёта в API Точки изменился на "оплачен".

Счёт создан вручную (в интернет-банке) — нужно указать ИНН плательщика и сумму при добавлении в трекер (tochka_track_invoice). Проверка оплаты через банковскую выписку. Признаки оплаты (все условия одновременно):

  • Входящий платёж (Credit)
  • ИНН плательщика совпадает с buyer_inn
  • Дата платежа >= дата создания записи в трекере
  • Разница суммы платежа и суммы счёта не более 1 рубля

После выставления счёта через MCP он автоматически попадает в отслеживание. При старте сессии Claude покажет неоплаченные и запустит периодическую проверку.

Локальный справочник товаров

ИнструментОписание
goods_listСписок всех товаров
goods_addДобавить товар (название, единица измерения, цена)
goods_removeУдалить товар по названию

Товары хранятся локально в ~/.config/mcp-server-tochka-bank/goods.json.

Настройка

Шаг 1. Получить JWT-токен в банке Точка

  1. Войдите в интернет-банк Точка
  2. Перейдите в Настройки → Интеграции и API
  3. Нажмите «Создать токен» (JWT)
  4. Выберите разрешения:
    • ReadAccountsBasic, ReadAccountsDetail — информация о счетах
    • ReadBalances — баланс
    • ReadStatements — выписки
    • ReadCustomerData — данные клиентов
    • CreatePaymentForSign, ReadPaymentData — платежи
    • ManageInvoiceData — счета и закрывающие документы
    • ReadAcquiringData, MakeAcquiringOperation — эквайринг и подписки
  5. Скопируйте сгенерированный токен

Шаг 2. Подключить MCP-сервер

Claude Code (CLI в терминале)

Способ 1: через uvx (не требует установки пакета)

Требуется uv — если не установлен:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh
bash
claude mcp add tochka-bank \  -e TOCHKA_TOKEN=ваш_токен \  -- uvx mcp-server-tochka-bank

Способ 2: через pip

bash
pip install mcp-server-tochka-bank
claude mcp add tochka-bank \  -e TOCHKA_TOKEN=ваш_токен \  -- python -m mcp_server_tochka_bank

Для удаления:

bash
claude mcp remove tochka-bank
Claude Desktop (десктопное приложение)

Добавьте в конфигурационный файл:

КлиентОСПуть к файлу
Claude Codeвсе~/.claude/settings.json (секция mcpServers)
Claude DesktopmacOS~/Library/Application Support/Claude/claude_desktop_config.json
Claude DesktopWindows%APPDATA%\Claude\claude_desktop_config.json
Claude DesktopLinux~/.config/Claude/claude_desktop_config.json

Через uvx:

json
{  "mcpServers": {    "tochka-bank": {      "command": "uvx",      "args": ["mcp-server-tochka-bank"],      "env": {        "TOCHKA_TOKEN": "ваш_токен"      }    }  }}

Через pip (после pip install mcp-server-tochka-bank):

json
{  "mcpServers": {    "tochka-bank": {      "command": "python",      "args": ["-m", "mcp_server_tochka_bank"],      "env": {        "TOCHKA_TOKEN": "ваш_токен"      }    }  }}

Для удаления — удалите блок "tochka-bank" из файла.

Токен хранится только на вашем компьютере и передаётся серверу через переменную окружения.

Шаг 3. Проверить

Попросите Claude: «покажи баланс в банке Точка» — он вызовет tochka_balance.

Примеры (MCP)

  • «покажи баланс» → tochka_balance
  • «выстави счёт ООО Рога и Копыта на 15 000 ₽» → tochka_invoice
  • «создай УПД к этому счёту» → tochka_upd
  • «оплати Попову 5000» → tochka_search (найти реквизиты) → tochka_payment (создать платёж) → ссылка на подпись
  • «оплати по реквизитам ...» → tochka_payment
  • «найди все операции с ИНН 7700000000» → tochka_search
  • «добавь товар: Виджет, шт., 500.00» → goods_add
  • «отслеживай оплату счёта №140» → tochka_track_invoice
  • «какие счета не оплачены?» → tochka_pending_invoices
  • «проверь оплату» → tochka_check_invoices

CLI-режим

Пакет можно использовать как CLI-инструмент в терминале. Без аргументов запускается MCP-сервер, с командой — CLI.

Требования

Переменная окружения TOCHKA_TOKEN должна быть установлена:

bash
export TOCHKA_TOKEN=ваш_токен

Команды

bash
# Балансmcp-server-tochka-bank balancemcp-server-tochka-bank all-balancesmcp-server-tochka-bank account-detail --account-id 40702810100000000001/044525000
# Поиск операций по ИНН или названиюmcp-server-tochka-bank search 7700000000mcp-server-tochka-bank search робокасса --days 60
# Входящие поступления за месяц (для налоговых отчётов)mcp-server-tochka-bank incoming --month 3 --year 2026mcp-server-tochka-bank incoming --month 3 --year 2026 --inn 3532015985
# Выписки и транзакцииmcp-server-tochka-bank statements-list --limit 10mcp-server-tochka-bank card-transactions
# Клиентыmcp-server-tochka-bank customersmcp-server-tochka-bank customer 100000001
# Счета и документыmcp-server-tochka-bank delete-invoice <document_id>mcp-server-tochka-bank send-invoice-email <document_id> [email protected]mcp-server-tochka-bank download-closing-document <document_id> /tmp/upd.pdfmcp-server-tochka-bank payments-for-sign
# Эквайрингmcp-server-tochka-bank acquiring-payments --page 1mcp-server-tochka-bank acquiring-payment <operation_id>mcp-server-tochka-bank acquiring-retailers
# Подпискиmcp-server-tochka-bank subscriptionsmcp-server-tochka-bank subscription-status <operation_id>
# Разрешенияmcp-server-tochka-bank consentsmcp-server-tochka-bank consent <consent_id>
# Справочник товаровmcp-server-tochka-bank goods listmcp-server-tochka-bank goods add --name "Виджет" --unit "шт." --price "500.00"mcp-server-tochka-bank goods remove --name "Виджет"
# Отслеживание оплатыmcp-server-tochka-bank pending-invoicesmcp-server-tochka-bank check-invoices --days 30

Все команды выводят результат в JSON.

Лицензия

MIT

Source: README.md at commit 7803f18

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts