Сервер MCP (Model Context Protocol) для интеграции с Monobank API.

Быстрая установка

Загрузите последний пакет .mcpb со страницы Releases и откройте его — Claude Desktop или Claude Code обработает все остальное. Вам будет предложено ввести свой токен API Monobank во время установки.

Предпосылки

Node.js 18.0.0 или выше

• Токен Monobank API. Вы можете получить его по адресу: https://api.monobank.ua/

Примечание: Токен API используется только локально и никогда не отслеживается и не передается нигде, кроме API Monobank.

Доступные инструменты

Сервер предоставляет три инструмента:

1. get currency rates - Получить валютные курсы. Публичная конечная точка; работает без токена API.
2. get client info - Получить информацию о клиентах, счетах и банках. Требуется жетон.
3. get statement - Получите выписку для учетной записи или банка в диапазоне дат. Требуется жетон. Максимальный диапазон составляет 31 день + 1 час.

Поведение, которое стоит знать

** Суммы возвращаются в валютных единицах, а не в центах. Баланс в 100 000,00 грн сообщается как [[Т2]], а не [[Т3]].

Monobank MCP Server

MCP (Model Context Protocol) server for integrating with Monobank API.

Quick Install

Download the latest .mcpb bundle from the Releases page and open it — Claude Desktop or Claude Code will handle the rest. You’ll be prompted to enter your Monobank API token during installation.

Prerequisites

• Node.js 18.0.0 or higher
• A Monobank API token. You can obtain it at: https://api.monobank.ua/

Note: Your API token is only used locally and is never tracked or transmitted anywhere except to Monobank’s API.

Available Tools

The server provides three tools:

1. get_currency_rates - Get currency exchange rates. Public endpoint; works without an API token.
2. get_client_info - Get client information, accounts and jars. Requires a token.
3. get_statement - Get the statement for an account or jar over a date range. Requires a token. Maximum range is 31 days + 1 hour.

Behaviour worth knowing

• Amounts are returned in currency units, not cents. A balance of 100,000.00 UAH is reported as 100000, not 10000000. This applies to every monetary field in both get_client_info and get_statement, including commissionRate, which Monobank returns as an absolute amount despite its name.
• Responses are cached in memory so that Monobank’s rate limits are not exceeded: 5 minutes for currency rates, 60 seconds for client info and for each distinct statement query. A repeated call inside that window returns the cached result instead of failing with HTTP 429.
• Statement dates are ISO 8601 YYYY-MM-DD, interpreted as UTC. The to date is inclusive — a statement from 2024-10-01 to 2024-10-31 covers all of October 31. Omit to to mean “up to now”.
• The statement account parameter defaults to 0, the client’s default account. Account and jar identifiers returned by get_client_info are also accepted.
• MONOBANK_API_TOKEN is only needed for get_client_info and get_statement. The server starts without it and get_currency_rates keeps working; the two authenticated tools return an error explaining that the variable is unset.

MCP Configuration

To use this server with an MCP client, add it to your configuration:

{
  "mcpServers": {
    "monobank": {
      "command": "npx",
      "args": ["monobank-mcp-server"],
      "env": {
        "MONOBANK_API_TOKEN": "your_token_here"
      }
    }
  }
}

Example Prompts

English

• “Show me the current USD to UAH exchange rate”
• “Get my account balance and recent transactions”
• “Show me all transactions from the last week”
• “What did I spend money on yesterday?”
• “Show my statement for October 2024”
• “Get all my credit card transactions from the last 3 days”

Українською

• “Покажи поточний курс долара”
• “Скільки грошей на моїх рахунках?”
• “Покажи виписку за вчора”
• “На що я витратив гроші цього тижня?”