Skip to main content
Glama
monobank-mcp

monobank-mcp

by todesstoss

monobank-mcp

npm version License: MIT Node.js

MCP server for Monobank — exposes your accounts, transactions, exchange rates, and webhook configuration as tools for Claude and other MCP clients.

Responses are pre-processed for LLM consumption: amounts are in base currency units (not cents), timestamps are ISO 8601, currency codes are ISO 4217 strings, and permissions are decoded to human-readable names. Frequently-accessed data is cached server-side for 1 hour so repeated reads never hit the Monobank rate limit.

Quick Start — Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "monobank": {
      "command": "npx",
      "args": ["-y", "@dirgen/monobank-mcp"],
      "env": {
        "MONOBANK_API_TOKEN": "your_token_here"
      }
    }
  }
}

Related MCP server: Monobank MCP Server

Quick Start — Claude Code

claude mcp add monobank -- npx -y @dirgen/monobank-mcp

Then add your token to .claude/settings.json:

{
  "mcpServers": {
    "monobank": {
      "env": { "MONOBANK_API_TOKEN": "your_token_here" }
    }
  }
}

Getting a Token

Open api.monobank.ua and scan the QR code with the Monobank app to generate your personal API token. The token never leaves your machine — it is passed directly to the server process as an environment variable.

Available Tools

Public — no token required

Tool

Description

monobank-bank-currency

All Monobank exchange rates. Returns baseCurrency / quoteCurrency (ISO 4217), date (ISO 8601), and rateSell / rateBuy (traded pairs) or rateCross (cross rates).

monobank-bank-currency-rate

Exchange rate for a single currency pair. Inputs: baseCurrency, quoteCurrency (defaults to UAH). Faster than fetching the full list.

Personal — requires MONOBANK_API_TOKEN

Tool

Description

monobank-personal-client-info

Full client profile: identity, decoded token permissions, all accounts and jars including FOP/business accounts (managedClients). Account id fields are what you pass to the statement tool.

monobank-personal-accounts

Compact account and jar list (id, type, currencyCode, balance, maskedPan). Use this for quick account discovery before fetching statements.

monobank-personal-statement

Transaction history for an account. Inputs: accountId (from client-info, or "0" for default UAH account), fromDate, toDate (ISO 8601 with timezone). Maximum range: 31 days per request.

monobank-get-webhook

Returns the webhook URL currently configured for this token. Empty string means no webhook is set.

monobank-set-webhook

⚠️ Destructive. Sets the webhook URL. Overwrites the existing URL immediately with no confirmation — check the current value with monobank-get-webhook first.

monobank-unset-webhook

⚠️ Destructive. Removes the webhook by setting the URL to empty string.

Caching

The server caches responses to stay within Monobank's rate limits and avoid redundant API calls:

Data

Cache TTL

Client info (/personal/client-info)

1 hour

Currency rates (/bank/currency)

1 hour

Statement with a fixed toDate

1 hour

Statement without toDate

Not cached (open-ended range → stale data risk)

Webhook mutations automatically invalidate the client-info cache so the next read reflects the updated URL.

Rate Limits

Monobank personal endpoints allow 1 request per 60 seconds. If the limit is hit, the server returns a clear error message telling you to wait 60 seconds. The 1-hour cache means most repeated reads are served locally without hitting the API at all.

Developer Setup

Requires Node.js ≥ 24.17.0 and pnpm.

git clone https://github.com/todesstoss/monobank-mcp
cd monobank-mcp
pnpm install

Create a .env file:

MONOBANK_API_TOKEN=your_token_here
pnpm start       # run the MCP server
pnpm inspect     # open MCP Inspector in the browser for interactive testing
pnpm typecheck   # type-check without emitting
pnpm lint        # lint src/

Troubleshooting

Invalid token / 401 — regenerate your token at api.monobank.ua. Tokens expire if unused.

Rate limit / 429 — wait 60 seconds. The server will tell you when this happens. Repeated reads within an hour are served from cache and won't trigger this.

Statement range > 31 days — split the request into multiple calls, each covering ≤ 31 days. The tool will tell you if the range is too wide.

Currency pair not found — use monobank-bank-currency to see all available pairs. Only UAH pairs and EUR/USD are available.

No managedClients in client-info — this field only appears if you are registered as a FOP (sole proprietor) with Monobank. All tokens are the same personal token — managedClients is simply absent if you have no FOP accounts.

License

MIT

Available Tools

8 tools
monobank-bank-currencyA
Read-onlyIdempotent

Returns Monobank exchange rates for all supported currencies.

Response fields:

  • baseCurrency / quoteCurrency: ISO 4217 currency codes (e.g. 'USD', 'EUR', 'UAH'). quoteCurrency is almost always 'UAH' — except the EUR/USD pair.

  • date: ISO 8601 timestamp of the last rate update.

  • rateSell: rate at which the bank sells baseCurrency (you pay in quoteCurrency). Present only for directly traded pairs.

  • rateBuy: rate at which the bank buys baseCurrency (you receive in quoteCurrency). Present only for directly traded pairs.

  • rateCross: mid-market rate for all other currencies. Use when rateSell/rateBuy are absent.

Inputs: no named parameters.

monobank-bank-currency-rateA
Read-onlyIdempotent

Returns the Monobank exchange rate for a specific currency pair. Faster than monobank-bank-currency when you need just one rate.

quoteCurrency defaults to 'UAH'. The only non-UAH pair available is EUR/USD.

Inputs: baseCurrency (required), quoteCurrency.

monobank-get-webhookA
Read-onlyIdempotent

Returns the webhook URL currently configured for this Monobank token. Empty string means no webhook is set.

Inputs: no named parameters.

monobank-personal-accountsA
Read-onlyIdempotent

Returns a compact list of all Monobank accounts and jars linked to this token. Use this to discover accountId values before calling monobank-personal-statement.

Each account: id (use as accountId), type (card product), currencyCode, balance, maskedPan. Each jar: id, title, currencyCode, balance, goal (0 if no target set).

Inputs: no named parameters.

monobank-personal-client-infoA
Read-onlyIdempotent

Returns Monobank client profile: identity, token permissions, and all linked accounts and jars.

Top-level fields:

  • clientId / name: client identity.

  • webhookUrl: currently configured webhook URL (empty string if not set).

  • permissions: array of scopes granted to this token (e.g. ['personal-info', 'statement', 'fop', 'jar', 'monobank']).

  • managedClients: FOP/business accounts linked to this token (present only for business tokens). Each has clientId, tin, name, and accounts.

Each account:

  • id: use this as accountId when calling monobank-personal-statement.

  • type: card product ('black', 'white', 'platinum', 'iron', 'fop', 'yellow', 'eAid').

  • currencyCode: ISO 4217 code (e.g. 'UAH', 'USD').

  • balance / creditLimit: amounts in the base currency unit (already divided).

  • cashbackType: cashback programme ('UAH', 'Miles', or empty).

  • iban / maskedPan / sendId: payment identifiers.

Each jar (savings goal):

  • balance / goal: amounts in the base currency unit (already divided). goal is 0 if no target is set.

Inputs: no named parameters.

monobank-personal-statementA
Read-onlyIdempotent

Returns a list of transactions for a Monobank account. Maximum range is 31 days per request.

Inputs:

  • accountId: account id from monobank-personal-client-info. Use '0' for the default UAH account.

  • fromDate: start of range, ISO 8601 with timezone (e.g. '2026-06-01T00:00:00+03:00').

  • toDate: end of range, ISO 8601 with timezone. Defaults to now if omitted.

Each transaction:

  • amount: transaction amount in base currency unit. Negative = debit (money out), positive = credit (money in).

  • operationAmount: original amount in the operation currency (differs from amount when currencyCode != account currency).

  • currencyCode: ISO 4217 code of the operation currency.

  • balance: account balance after this transaction.

  • commissionRate / cashbackAmount: fee charged and cashback earned, in base currency unit.

  • mcc / originalMcc: Merchant Category Code (ISO 18245).

  • hold: true if the transaction is pending (not yet settled).

  • description: merchant or transfer name.

  • receiptId / invoiceId: identifiers for receipt lookup.

  • counterName / counterIban / counterEdrpou: counterparty info for transfers (present when available).

Inputs: fromDate (required), accountId (required), toDate.

monobank-set-webhookA
Destructive

Sets the webhook URL for this Monobank token. Monobank will send real-time push notifications to this URL for every new transaction.

WARNING: Each token supports only one webhook URL. Calling this tool overwrites the existing URL with no confirmation. Use monobank-get-webhook to check the current value first.

Inputs: url (required).

monobank-unset-webhookA
DestructiveIdempotent

Removes the webhook URL for this Monobank token. Monobank will stop sending push notifications. Safe to call even if no webhook is currently set.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between monobank-bank-currency and monobank-bank-currency-rate, and between monobank-personal-client-info and monobank-personal-accounts. The descriptions clearly differentiate these, so an agent can choose correctly.

    Naming Consistency4/5

    All tool names use the 'monobank-' prefix and lowercase hyphens, but the pattern is not fully consistent: data retrieval tools use noun phrases (e.g., monobank-personal-statement), while webhook tools use verb-noun phrases (e.g., monobank-set-webhook). This is a minor deviation from a fully uniform convention.

    Tool Count5/5

    With 8 tools, the server is well-scoped for a personal finance integration, covering currency rates, client information, accounts, statements, and webhook management without unnecessary redundancy.

    Completeness4/5

    The tool surface covers the essential read operations (rates, client info, accounts, statements) and the full webhook lifecycle, which matches the server's informational purpose. Minor gaps exist, such as no way to fetch a single account's details directly, but the accounts list provides a workaround.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      A Model Context Protocol server that allows AI assistants to connect to and manage Israeli bank accounts, fetch transactions, and handle authentication for all major Israeli banks and credit card companies.
      2
      38
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes Monobank personal account data through MCP tools, allowing users to fetch client info, accounts, and jars. It also enables retrieving account statements for specific time periods.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server for Max messenger that lets AI assistants send and read messages, manage chats, and interact with the Max platform API.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI assistants to retrieve and format Monobank account statements and transactions by date range.
      8 npm
      5
      MIT