monobank-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@monobank-mcp what are the current exchange rates?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
monobank-mcp
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-mcpThen 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 |
| All Monobank exchange rates. Returns |
| Exchange rate for a single currency pair. Inputs: |
Personal — requires MONOBANK_API_TOKEN
Tool | Description |
| Full client profile: identity, decoded token permissions, all accounts and jars including FOP/business accounts ( |
| Compact account and jar list (id, type, currencyCode, balance, maskedPan). Use this for quick account discovery before fetching statements. |
| Transaction history for an account. Inputs: |
| Returns the webhook URL currently configured for this token. Empty string means no webhook is set. |
| ⚠️ Destructive. Sets the webhook URL. Overwrites the existing URL immediately with no confirmation — check the current value with |
| ⚠️ 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 ( | 1 hour |
Currency rates ( | 1 hour |
Statement with a fixed | 1 hour |
Statement without | 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 installCreate a .env file:
MONOBANK_API_TOKEN=your_token_herepnpm 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 toolsmonobank-bank-currencyARead-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-rateARead-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-webhookARead-onlyIdempotent
Returns the webhook URL currently configured for this Monobank token. Empty string means no webhook is set.
Inputs: no named parameters.
monobank-personal-accountsARead-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-infoARead-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-statementARead-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-webhookADestructive
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-webhookADestructiveIdempotent
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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
Model Context Protocol server for Studex tools, notifications, and profile integrations
Related MCP Servers
- AlicenseDqualityDmaintenanceA 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.238ISC
- FlicenseNot gradedqualityDmaintenanceExposes 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.-
- AlicenseNot gradedqualityDmaintenanceA 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
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to retrieve and format Monobank account statements and transactions by date range.8 npm5MIT