> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brama.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Monobank Personal

> Персональний/ФОП банківський рахунок Monobank – рахунки, виписки, курси валют. Read-only, нуль зберігання транзакцій.

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

## Чому 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`) – невалідний токен не збережеться.

<Tip>
  За поточної моделі tenant'а це підключення бачить лише власник акаунта. Якщо колись з'явиться можливість додавати учасників команди – видимість персональних банківських даних треба буде переглянути окремо.
</Tip>

<Warning>
  Monobank обмежує Personal API до **1 запиту на 60 секунд** на токен. Часті повторні виклики (особливо `get_statement`) повертають помилку rate-limit – агент отримає про це зрозуміле повідомлення, повторювати запит одразу не варто.
</Warning>

## MCP tools (live)

<Card title="brama_monobankpersonal_get_accounts" icon="wallet">
  Список рахунків і карток tenant'а – тип, валюта, баланс, кредитний ліміт, IBAN.

  **Параметри:** немає.

  Use: "скільки в мене на рахунку", "покажи всі мої картки", отримання `account id` для `get_statement`.
</Card>

<Card title="brama_monobankpersonal_get_statement" icon="receipt">
  Виписка за період – до 31 дня за один виклик.

  **Параметри:**

  * `from` *(required)* – початкова дата, формат `YYYY-MM-DD`
  * `to` *(optional)* – кінцева дата, формат `YYYY-MM-DD`; якщо не вказано – сьогодні
  * `account` *(optional)* – id рахунку з `get_accounts`; якщо не вказано – рахунок за замовчуванням

  **Повертає:** дату/час, опис операції, суму, баланс після операції, контрагента (якщо є).

  Use: "покажи витрати за минулий тиждень", "які були платежі 15 числа", дайджест витрат за період.
</Card>

<Card title="brama_monobankpersonal_get_currency_rates" icon="coins">
  Поточний курс Monobank (купівля/продаж) для основних валютних пар. Публічні дані, токен на цей виклик не потрібен.

  **Параметри:** немає.

  Use: "який зараз курс долара", "по скільки продає Monobank євро".
</Card>

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

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