Skip to main content
Status: live. 3 read-only MCP tools у production: рахунки, виписка за період, курси валют. Нуль write-tools, нуль webhook – кожен запит іде напряму до Monobank у момент виклику, нічого не кешується й не зберігається на боці Brama.

​
Чому Monobank Personal

  • Найпопулярніший необанк України для ФОП і особистих рахунків – якщо ти фаундер, ймовірно рахунок вже там.
  • AI-агент відповідає на запити на кшталт “скільки в мене на рахунку”, “покажи витрати за останній тиждень”, “який зараз курс долара” – без переключення у застосунок Monobank.
  • Нуль зберігання транзакцій – архітектурна вимога, не просто MVP-обмеження. Brama НЕ кешує й не зберігає виписки на своєму боці; кожен виклик тула – це live-запит до Monobank в момент, коли про це попросив AI-агент. Саме ця властивість (а не сам факт BYO-токена) тримає інтеграцію в межах безкоштовного Personal API Monobank, а не Corporate API, призначеного для автономного/періодичного забору даних багатьох клієнтів.

​
Підключення

  1. Отримай Monobank Personal API token: застосунок Monobank → Ще → Розробникам → Токен для API. Або напряму на api.monobank.ua.
  2. app.brama.work → Integrations → Monobank Personal → встав токен.
Токен зберігається envelope-encrypted (AES-256-GCM), ізольовано per-tenant. Brama не має спільного Monobank-акаунта – Bring-Your-Own. Перед збереженням токен перевіряється живим запитом до Monobank (client-info) – невалідний токен не збережеться.
За поточної моделі tenant’а це підключення бачить лише власник акаунта. Якщо колись з’явиться можливість додавати учасників команди – видимість персональних банківських даних треба буде переглянути окремо.
Monobank обмежує Personal API до 1 запиту на 60 секунд на токен. Часті повторні виклики (особливо get_statement) повертають помилку rate-limit – агент отримає про це зрозуміле повідомлення, повторювати запит одразу не варто.

​
MCP tools (live)

brama_monobankpersonal_get_accounts

Список рахунків і карток tenant’а – тип, валюта, баланс, кредитний ліміт, IBAN.Параметри: немає.Use: “скільки в мене на рахунку”, “покажи всі мої картки”, отримання account id для get_statement.

brama_monobankpersonal_get_statement

Виписка за період – до 31 дня за один виклик.Параметри:
  • from (required) – початкова дата, формат YYYY-MM-DD
  • to (optional) – кінцева дата, формат YYYY-MM-DD; якщо не вказано – сьогодні
  • account (optional) – id рахунку з get_accounts; якщо не вказано – рахунок за замовчуванням
Повертає: дату/час, опис операції, суму, баланс після операції, контрагента (якщо є).Use: “покажи витрати за минулий тиждень”, “які були платежі 15 числа”, дайджест витрат за період.

brama_monobankpersonal_get_currency_rates

Поточний курс Monobank (купівля/продаж) для основних валютних пар. Публічні дані, токен на цей виклик не потрібен.Параметри: немає.Use: “який зараз курс долара”, “по скільки продає Monobank євро”.

​
Чого немає (свідомо)

  • Write-tools – жодних. Це read-only інтеграція банківського рахунку; ні перекази, ні платежі Brama не робить.
  • Webhook / автоматичні сповіщення – відсутні. Monobank підтримує webhook на транзакції, але Brama його не використовує – це б перетворило інтеграцію на постійний збір даних, що вже вимагає Corporate API за умовами Monobank.
  • Кешування виписок – кожен get_statement-виклик іде до Monobank наживо; нічого з попередніх запитів не зберігається й не переграється повторно.