mcpField
T
tochka-bank

tochka-bank

Local
github.com/dontsovcmcFinance0Updated 26w ago
Repository

About tochka-bank

tochka-bank is an MCP server for the Tochka Bank API, aimed at businesses managing banking tasks through compatible clients or a CLI. It covers accounts, payments, invoices, acquiring, subscriptions and local invoice tracking, while keeping the token on the user's computer.

Key features

  1. 01Read balances, account details and statements
  2. 02Create payments, invoices and closing documents
  3. 03Manage acquiring transactions and payment links
  4. 04Create and manage recurring subscriptions
  5. 05Track unpaid invoices
  6. 06Maintain a local product catalog

Use cases

  1. 01Check balances and search transactions
  2. 02Issue customer invoices and download PDFs
  3. 03Create payment links, capture funds or issue refunds
  4. 04Review invoices awaiting payment

MCP support

The MCP server exposes Tochka banking tools to compatible clients such as Claude Code and Claude Desktop. Its package can also run as a CLI that returns JSON.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "dontsovcmc-tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank"
      ],
      "env": {
        "TOCHKA_TOKEN": "<TOCHKA_TOKEN>"
      }
    }
  }
}
Run commanduvx mcp-server-tochka-bank
Environment variables to set
TOCHKA_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-server-tochka-bank0.6.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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 — если не установлен:

curl -LsSf https://astral.sh/uv/install.sh | sh

claude mcp add tochka-bank \
  -e TOCHKA_TOKEN=ваш_токен \
  -- uvx mcp-server-tochka-bank

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

pip install mcp-server-tochka-bank

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

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

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:

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

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

{
  "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 должна быть установлена:

export TOCHKA_TOKEN=ваш_токен
Команды
# Баланс
mcp-server-tochka-bank balance
mcp-server-tochka-bank all-balances
mcp-server-tochka-bank account-detail --account-id 40702810100000000001/044525000

# Поиск операций по ИНН или названию
mcp-server-tochka-bank search 7700000000
mcp-server-tochka-bank search робокасса --days 60

# Входящие поступления за месяц (для налоговых отчётов)
mcp-server-tochka-bank incoming --month 3 --year 2026
mcp-server-tochka-bank incoming --month 3 --year 2026 --inn 3532015985

# Выписки и транзакции
mcp-server-tochka-bank statements-list --limit 10
mcp-server-tochka-bank card-transactions

# Клиенты
mcp-server-tochka-bank customers
mcp-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.pdf
mcp-server-tochka-bank payments-for-sign

# Эквайринг
mcp-server-tochka-bank acquiring-payments --page 1
mcp-server-tochka-bank acquiring-payment <operation_id>
mcp-server-tochka-bank acquiring-retailers

# Подписки
mcp-server-tochka-bank subscriptions
mcp-server-tochka-bank subscription-status <operation_id>

# Разрешения
mcp-server-tochka-bank consents
mcp-server-tochka-bank consent <consent_id>

# Справочник товаров
mcp-server-tochka-bank goods list
mcp-server-tochka-bank goods add --name "Виджет" --unit "шт." --price "500.00"
mcp-server-tochka-bank goods remove --name "Виджет"

# Отслеживание оплаты
mcp-server-tochka-bank pending-invoices
mcp-server-tochka-bank check-invoices --days 30

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

Лицензия

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.