{
  "markdown": "<!-- mcp-name: io.github.dontsovcmc/tochka-bank -->\n\n# mcp-server-tochka-bank\n\nMCP-сервер для работы с [API банка Точка](https://developers.tochka.com/docs/tochka-api/) через Claude Code, Claude Desktop и другие MCP-совместимые клиенты.\n\nВсе данные остаются на вашем компьютере — токен никуда не передаётся.\n\n## Возможности\n\n### Банковские операции\n| Инструмент | Описание |\n|------------|----------|\n| `tochka_balance` | Баланс счёта |\n| `tochka_payment` | Создать исходящий платёж (я плачу кому-то), получить ссылку на подпись |\n| `tochka_invoice` | Выставить счёт покупателю (мне платят) |\n| `tochka_download_invoice` | Скачать PDF счёта |\n| `tochka_upd` | Создать УПД (универсальный передаточный документ), получить ссылку на подпись |\n| `tochka_search` | Поиск операций по ИНН или названию контрагента (возвращает полные реквизиты: БИК, счёт, корр.счёт) |\n| `tochka_incoming` | Входящие поступления за месяц, сгруппированные по ИНН отправителя (для налоговых отчётов АУСН) |\n\n### Счета и документы (дополнительно)\n| Инструмент | Описание |\n|------------|----------|\n| `tochka_account_detail` | Детали банковского счёта |\n| `tochka_all_balances` | Балансы всех счетов |\n| `tochka_statements_list` | Список последних выписок |\n| `tochka_card_transactions` | Авторизованные карточные транзакции |\n| `tochka_customers` | Список клиентов (организаций) |\n| `tochka_customer` | Детали клиента |\n| `tochka_delete_invoice` | Удалить счёт |\n| `tochka_send_invoice_email` | Отправить счёт на email |\n| `tochka_delete_closing_document` | Удалить закрывающий документ |\n| `tochka_send_closing_document_email` | Отправить закрывающий документ на email |\n| `tochka_download_closing_document` | Скачать PDF закрывающего документа |\n| `tochka_payments_for_sign` | Список платежей на подпись |\n\n### Эквайринг (платёжные ссылки)\n| Инструмент | Описание |\n|------------|----------|\n| `tochka_acquiring_payments` | Список операций эквайринга |\n| `tochka_acquiring_payment_create` | Создать платёжную ссылку |\n| `tochka_acquiring_payment` | Детали операции эквайринга |\n| `tochka_acquiring_payment_capture` | Списать средства (двухстадийный платёж) |\n| `tochka_acquiring_payment_refund` | Возврат платежа |\n| `tochka_acquiring_payment_with_receipt` | Создать платёж с фискальным чеком |\n| `tochka_acquiring_registry` | Реестр платежей эквайринга |\n| `tochka_acquiring_retailers` | Список торговых точек |\n\n### П��дписки (рекуррентные платежи)\n| Инструмент | Описание |\n|------------|----------|\n| `tochka_subscription_create` | Создать подписку |\n| `tochka_subscriptions` | Список подписок |\n| `tochka_subscription_charge` | Списание по подписке |\n| `tochka_subscription_status` | Статус подписки |\n| `tochka_subscription_status_set` | Установить статус подписки |\n| `tochka_subscription_with_receipt` | Создать подписку с фискальным чеком |\n\n### Разрешения API (Consents)\n| Инструмент | Описание |\n|------------|----------|\n| `tochka_consents` | Список разрешений |\n| `tochka_consent_create` | Создать разрешение |\n| `tochka_consent` | Детали разрешения |\n| `tochka_consent_children` | Дочерние разрешения |\n\n### Отслеживание оплаты счетов\n\n| Инструмент | Описание |\n|------------|----------|\n| `tochka_track_invoice` | Добавить счёт в отслеживание оплаты |\n| `tochka_untrack_invoice` | Убрать счёт из отслеживания |\n| `tochka_pending_invoices` | Список счетов, ожидающих оплаты |\n| `tochka_check_invoices` | Проверить все ожидающие счета, оплаченные удаляются автоматически |\n\nДанные хранятся в `~/.config/mcp-server-tochka-bank/pending_invoices.json`.\n\nДва способа отслеживания в зависимости от того, как был создан счёт:\n\n**Счёт создан через MCP-сервер** (`tochka_invoice`) — данные сохраняются автоматически. Проверка оплаты через `payment-status` API Точки. Признак оплаты: статус счёта в API Точки изменился на \"оплачен\".\n\n**Счёт создан вручную** (в интернет-банке) — нужно указать ИНН плательщика и сумму при добавлении в трекер (`tochka_track_invoice`). Проверка оплаты через банковскую выписку. Признаки оплаты (все условия одновременно):\n- Входящий платёж (Credit)\n- ИНН плательщика совпадает с `buyer_inn`\n- Дата платежа >= дата создания записи в трекере\n- Разница суммы платежа и суммы счёта не более 1 рубля\n\nПосле выставления счёта через MCP он автоматически попадает в отслеживание. При старте сессии Claude покажет неоплаченные и запустит периодическую проверку.\n\n### Локальный справочник товаров\n| Инструмент | Описание |\n|------------|----------|\n| `goods_list` | Список всех товаров |\n| `goods_add` | Добавить товар (название, единица измерения, цена) |\n| `goods_remove` | Удалить товар по названию |\n\nТовары хранятся локально в `~/.config/mcp-server-tochka-bank/goods.json`.\n\n## Настройка\n\n### Шаг 1. Получить JWT-токен в банке Точка\n\n1. Войдите в [интернет-банк Точка](https://i.tochka.com)\n2. Перейдите в **Настройки** → **Интеграции и API**\n3. Нажмите **«Создать токен»** (JWT)\n4. Выберите разрешения:\n   - `ReadAccountsBasic`, `ReadAccountsDetail` — информация о счетах\n   - `ReadBalances` — баланс\n   - `ReadStatements` — выписки\n   - `ReadCustomerData` — данные клиентов\n   - `CreatePaymentForSign`, `ReadPaymentData` — платежи\n   - `ManageInvoiceData` — счета и закрывающие документы\n   - `ReadAcquiringData`, `MakeAcquiringOperation` — эквайринг и подписки\n5. Скопируйте сгенерированный токен\n\n### Шаг 2. Подключить MCP-сервер\n\n#### Claude Code (CLI в терминале)\n\n**Способ 1: через uvx** (не требует установки пакета)\n\n> Требуется [uv](https://docs.astral.sh/uv/) — если не установлен:\n> ```bash\n> curl -LsSf https://astral.sh/uv/install.sh | sh\n> ```\n\n```bash\nclaude mcp add tochka-bank \\\n  -e TOCHKA_TOKEN=ваш_токен \\\n  -- uvx mcp-server-tochka-bank\n```\n\n**Способ 2: через pip**\n\n```bash\npip install mcp-server-tochka-bank\n\nclaude mcp add tochka-bank \\\n  -e TOCHKA_TOKEN=ваш_токен \\\n  -- python -m mcp_server_tochka_bank\n```\n\nДля удаления:\n```bash\nclaude mcp remove tochka-bank\n```\n\n#### Claude Desktop (десктопное приложение)\n\nДобавьте в конфигурационный файл:\n\n| Клиент | ОС | Путь к файлу |\n|--------|----|-------------|\n| Claude Code | все | `~/.claude/settings.json` (секция `mcpServers`) |\n| Claude Desktop | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Claude Desktop | Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Claude Desktop | Linux | `~/.config/Claude/claude_desktop_config.json` |\n\n**Через uvx:**\n```json\n{\n  \"mcpServers\": {\n    \"tochka-bank\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-tochka-bank\"],\n      \"env\": {\n        \"TOCHKA_TOKEN\": \"ваш_токен\"\n      }\n    }\n  }\n}\n```\n\n**Через pip** (после `pip install mcp-server-tochka-bank`):\n```json\n{\n  \"mcpServers\": {\n    \"tochka-bank\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"mcp_server_tochka_bank\"],\n      \"env\": {\n        \"TOCHKA_TOKEN\": \"ваш_токен\"\n      }\n    }\n  }\n}\n```\n\nДля удаления — удалите блок `\"tochka-bank\"` из файла.\n\nТокен хранится только на вашем компьютере и передаётся серверу через переменную окружения.\n\n### Шаг 3. Проверить\n\nПопросите Claude: *«покажи баланс в банке Точка»* — он вызовет `tochka_balance`.\n\n## Примеры (MCP)\n\n- «покажи баланс» → `tochka_balance`\n- «выстави счёт ООО Рога и Копыта на 15 000 ₽» → `tochka_invoice`\n- «создай УПД к этому счёту» → `tochka_upd`\n- «оплати Попову 5000» → `tochka_search` (найти реквизиты) → `tochka_payment` (создать платёж) → ссылка на подпись\n- «оплати по реквизитам ...» → `tochka_payment`\n- «найди все операции с ИНН 7700000000» → `tochka_search`\n- «добавь товар: Виджет, шт., 500.00» → `goods_add`\n- «отслеживай оплату счёта №140» → `tochka_track_invoice`\n- «какие счета не оплачены?» → `tochka_pending_invoices`\n- «проверь оплату» → `tochka_check_invoices`\n\n## CLI-режим\n\nПакет можно использовать как CLI-инструмент в терминале. Без аргументов запускается MCP-сервер, с командой — CLI.\n\n### Требования\n\nПеременная окружения `TOCHKA_TOKEN` должна быть установлена:\n\n```bash\nexport TOCHKA_TOKEN=ваш_токен\n```\n\n### Команды\n\n```bash\n# Баланс\nmcp-server-tochka-bank balance\nmcp-server-tochka-bank all-balances\nmcp-server-tochka-bank account-detail --account-id 40702810100000000001/044525000\n\n# Поиск операций по ИНН или названию\nmcp-server-tochka-bank search 7700000000\nmcp-server-tochka-bank search робокасса --days 60\n\n# Входящие поступления за месяц (для налоговых отчётов)\nmcp-server-tochka-bank incoming --month 3 --year 2026\nmcp-server-tochka-bank incoming --month 3 --year 2026 --inn 3532015985\n\n# Выписки и транзакции\nmcp-server-tochka-bank statements-list --limit 10\nmcp-server-tochka-bank card-transactions\n\n# Клиенты\nmcp-server-tochka-bank customers\nmcp-server-tochka-bank customer 100000001\n\n# Счета и документы\nmcp-server-tochka-bank delete-invoice <document_id>\nmcp-server-tochka-bank send-invoice-email <document_id> buyer@example.com\nmcp-server-tochka-bank download-closing-document <document_id> /tmp/upd.pdf\nmcp-server-tochka-bank payments-for-sign\n\n# Эквайринг\nmcp-server-tochka-bank acquiring-payments --page 1\nmcp-server-tochka-bank acquiring-payment <operation_id>\nmcp-server-tochka-bank acquiring-retailers\n\n# Подписки\nmcp-server-tochka-bank subscriptions\nmcp-server-tochka-bank subscription-status <operation_id>\n\n# Разрешения\nmcp-server-tochka-bank consents\nmcp-server-tochka-bank consent <consent_id>\n\n# Справочник товаров\nmcp-server-tochka-bank goods list\nmcp-server-tochka-bank goods add --name \"Виджет\" --unit \"шт.\" --price \"500.00\"\nmcp-server-tochka-bank goods remove --name \"Виджет\"\n\n# Отслеживание оплаты\nmcp-server-tochka-bank pending-invoices\nmcp-server-tochka-bank check-invoices --days 30\n```\n\nВсе команды выводят результат в JSON.\n\n## Лицензия\n\nMIT\n",
  "bytes": 9598,
  "sha": "ee60539c214c2a924eb153f20746068488eeeeaf3d978bc46d1c567883fdeaa1",
  "repo_slug": "dontsovcmc/mcp-server-tochka-bank",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dontsovcmc_tochka_bank_b73195b8/readme"
}