Monobank MCP Server
This server integrates with Monobank's API via MCP to provide currency rates, client account info, and account statements.
Get Currency Rates (
get_currency_rates): Fetch current exchange rates (public endpoint, no token needed). Cached for 5 minutes.Get Client Info (
get_client_info): Retrieve client details, list of accounts and jars (requires Monobank API token). Cached for 60 seconds.Get Statement (
get_statement): Obtain transaction history for a specific account or jar over a date range (max 31 days + 1 hour). Uses ISO 8601 dates, thetodate is inclusive, and defaults to the primary account if not specified (requires token). Cached per query for 60 seconds.
Key behaviors:
Monetary amounts are returned in currency units (not cents).
In-memory caching prevents hitting Monobank's rate limits.
The server starts without a token and partially works (currency rates).
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 Server show me my account balance and recent transactions"
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 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.
Related MCP server: Monobank MCP Server
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:
get_currency_rates - Get currency exchange rates. Public endpoint; works without an API token.
get_client_info - Get client information, accounts and jars. Requires a token.
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, not10000000. This applies to every monetary field in bothget_client_infoandget_statement, includingcommissionRate, 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. Thetodate is inclusive — a statement from2024-10-01to2024-10-31covers all of October 31. Omittoto mean "up to now".The statement
accountparameter defaults to0, the client's default account. Account and jar identifiers returned byget_client_infoare also accepted.MONOBANK_API_TOKENis only needed forget_client_infoandget_statement. The server starts without it andget_currency_rateskeeps 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"
Українською
"Покажи поточний курс долара"
"Скільки грошей на моїх рахунках?"
"Покажи виписку за вчора"
"На що я витратив гроші цього тижня?"
"Покажи всі транзакції за жовтень"
"Скільки я витратив на їжу за останній місяць?"
MCPB (One-Click Installation)
This server is available as an MCPB bundle for one-click installation in Claude Desktop and Claude Code.
To build the .mcpb bundle locally:
npm run pack:mcpbThis produces monobank-mcp-server.mcpb which can be installed directly in any MCPB-compatible client. During installation, you'll be prompted to enter your Monobank API token securely.
License
MIT
Available Tools
3 toolsget_client_infoA
Get information about a client and a list of their accounts and jars. The tool can be called not more than 1 time per 60 seconds, otherwise an error will be thrown.
Inputs: no named parameters.
get_currency_ratesA
Get a basic list of currency rates from Monobank. The information can be refreshed once per 5 minutes, otherwise an error will be thrown.
Inputs: no named parameters.
get_statementC
Get Monobank statement for the time from {from} to {to} time in seconds in Unix time format. The maximum time for which it is posssible to obtain a statement is 31 days + 1 hour (2682000 seconds). The statement can be retrieved not more than once per 60 seconds, otherwise an error will be thrown.
Inputs: input (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct resource: currency rates, client/account info, and transaction statements. No overlap or ambiguity between them.
All three tools follow the exact same get_noun pattern, with clear and uniform naming. This is perfectly consistent.
With 3 tools, the server is tightly scoped to the core Monobank personal API endpoints. Each tool earns its place, and the count is ideal for this narrow domain.
The server covers all primary read-only Monobank API operations: currency rates, client info, and statements. No obvious gaps exist for the intended functionality, as the API itself offers few other personal endpoints.
Maintenance
Related MCP Connectors
Chat with your bank data: balances, transactions, budgets, bills. Reads only, never moves money.
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Connect AI agents to bank accounts, transactions, balances, and investments.
Ask your AI about your own accounts, debts, budgets and goals. OAuth sign-in, read-only by default.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with Monobank personal accounts through MCP tools to fetch client information, account details, and transaction statements for specified time periods.216 npm2MIT
- 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 gradedqualityDmaintenanceEnables AI assistants to perform Nigerian banking operations including account management, payments, and identity verification through the Mono Open Banking API.59MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Monzo bank accounts, including checking balances, listing transactions, and managing pots through natural language via the MCP protocol.914 npmMIT