Monobank MCP Server
The Monobank MCP Server allows you to interact with Monobank personal banking accounts and retrieve public financial data through three tools:
get_client_info: Retrieve your client profile, accounts, and jars. Requires aMONOBANK_API_TOKEN.get_statement: Fetch transaction history for a specific account over a defined period (up to 31 days + 1 hour). Specifyaccount_id(or'0'for default),from_timestamp, andto_timestamp. Returns amounts in main currency units (e.g., hryvnias) with ISO 8601 UTC timestamps. Rate-limited to 1 request per 60 seconds. Requires aMONOBANK_API_TOKEN.get_currency_rates: Fetch public Monobank exchange rates using ISO 4217 numeric currency codes. No API token required.
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 my account statement for the last week"
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 (Node.js/TypeScript)
Node.js/TypeScript implementation of the Monobank MCP Server originally written in Python.
Monobank MCP Server exposes your Monobank personal account (and public exchange rates) as Model Context Protocol (MCP) tools.
About This Version
This is a Node.js/TypeScript port of the original Python implementation by @nklymok.
Original Python version: https://github.com/nklymok/Monobank-MCP
This TypeScript version: Maintains the same core personal-account tools with Node.js/TypeScript ecosystem benefits, plus a public rates tool that needs no token.
Related MCP server: Monobank MCP Server
Features
TypeScript/Node.js MCP server using the official
@modelcontextprotocol/sdkMCP tools:
get_client_info– client identity, accounts, and jars (requiresMONOBANK_API_TOKEN).get_statement– account statement for a time window (requires token). Validates the period before calling the API; responses use amounts in main units and ISO 8601 UTC times for transactions.get_currency_rates– public currency exchange rates from Monobank (GET /bank/currency). No API token required.
Usage (Published Package)
The easiest way to use this MCP server is via the published npm package:
Register the server in your MCP configuration
{ "mcpServers": { "monobank-mcp": { "command": "npx", "args": ["-y", "@alerix/monobank-mcp"], "env": { "MONOBANK_API_TOKEN": "your_token_here" } } } }Set
MONOBANK_API_TOKENonly if you useget_client_infoorget_statement.get_currency_ratesworks without it.Run your MCP client – the tools will be available according to your configuration.
Development
If you want to contribute or modify the server:
Clone and install dependencies
git clone https://github.com/aler1x/monobank-mcp.git cd monobank-mcp npm installRun the server after install (
preparerunsnpm run build). For personal tools, setMONOBANK_API_TOKEN.Windows (PowerShell):
$env:MONOBANK_API_TOKEN="your_token_here" node dist/index.jsWindows (Command Prompt):
set MONOBANK_API_TOKEN=your_token_here node dist\index.jsmacOS/Linux:
export MONOBANK_API_TOKEN=your_token_here node dist/index.jsOr one line:
MONOBANK_API_TOKEN=your_token_here node dist/index.jsDevelopment with hot reload (uses
tsx --watch):MONOBANK_API_TOKEN=your_token_here npm run devBuild (TypeScript →
dist/):npm run build
Tool Reference
Tool | Description | Token | Rate limits (Monobank) |
| Fetches client profile, list of accounts and jars. | Yes | 1 request / 60 s |
| Retrieves transactions for an account and period. Parameters: | Yes | 1 request / 60 s |
| Public exchange rates (ISO 4217 numeric currency codes). Same data as Monobank | No | Per Monobank public API |
API Token
Personal tools need a Monobank personal API token. See the official docs: https://api.monobank.ua/index.html
Environment Variables
Name | Required | Description |
| For | Your personal Monobank API token from https://api.monobank.ua/index.html. Not used by |
License
MIT
Available Tools
2 toolsget_client_infoA
Get client information from Monobank API. This tool retrieves information about the client, their accounts, and jars. It requires a Monobank API token with the necessary permissions.
Inputs: no named parameters.
get_statementA
Get account statement for a given period. Rate limit: 1 request per 60 seconds. Max period: 31 days + 1 hour. Rules: 1. Fetch from default account (account_id = '0') unless another account is specified. 2. Amounts are converted from the smallest currency unit (e.g., kopiyka, cent) to the main unit and returned as decimals. 3. Transaction timestamps ('time') are converted from Unix timestamps to ISO 8601 datetime strings (UTC). 4. Fields 'id', 'invoiceId', 'counterEdrpou', and 'counterIban' are omitted from the returned results.
Inputs: account_id (required), from_timestamp (required), to_timestamp (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get_client_info retrieves client metadata, accounts, and jars, while get_statement fetches transaction data for a specific period. There is no overlap or ambiguity between these functions.
Both tools follow a consistent verb_noun naming pattern (get_client_info, get_statement) with identical verb style and snake_case formatting, making them predictable and easy to understand.
With only two tools, the server feels severely under-scoped for a banking API. Key operations like creating transactions, managing accounts, or updating client details are missing, limiting its utility for comprehensive financial tasks.
The toolset is highly incomplete for a banking domain. It only supports read operations (get_client_info, get_statement) with no ability to perform writes (e.g., transfers, payments), updates, or deletions, leaving significant gaps in typical banking workflows.
Related MCP Connectors
Authenticated MCP access to WebMoney wallets, transactions, messages and invoices.
Wise (https://wise.com) MCP, multi-currency account access via Personal Token + SCA key. Reads profi
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Remote MCP server for UETR tracking and SWIFT payment tracking. Read bank-reported transfer status and manage monitoring from your AI app, within your uetr.ai plan and team rights. Connect at https://uetr.ai/mcp with OAuth or an API key. A free uetr.ai account is enough to connect. uetr.ai is an independent information service and does not move or hold funds.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables integration with Monobank API to check currency exchange rates, view account balances, and retrieve transaction statements through natural language queries.379 npm11MIT
- 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 gradedqualityDmaintenanceAn MCP server that enables AI assistants to retrieve and format Monobank account statements and transactions by date range.8 npm5MIT
- AlicenseCqualityDmaintenanceEnables interaction with Monarch Money data via MCP tools for accounts, budgets, and transactions.689 npm4MIT