Monobank MCP Server

What is Monobank MCP Server?

Monobank MCP Server is an MCP server that connects Claude and other MCP clients to the Monobank API. It exposes accounts, transactions, exchange rates, and webhook configuration as AI‑accessible tools. Data is pre‑processed for LLM consumption (units, timestamps, ISO codes, human‑readable permissions) and cached server‑side for one hour to stay within Monobank’s rate limits.

How to use Monobank MCP Server?

Add the server to your Claude Desktop configuration or run claude mcp add monobank -- npx -y @dirgen/monobank-mcp for Claude Code. Provide your personal API token via the MONOBANK_API_TOKEN environment variable (obtain one at api.monobank.ua). The server exposes public tools (exchange rates, no token required) and personal tools (accounts, statements, webhooks) once the token is set.

Key features of Monobank MCP Server

• Exposes Monobank accounts, transactions, and rates as MCP tools
• Pre‑processes data: amounts in base units, ISO 8601 timestamps, human‑readable permissions
• Caches responses for 1 hour to avoid Monobank’s 1‑request‑per‑60‑second rate limit
• Public tools for exchange rates (no token required)
• Personal tools: client info, statements, webhook management
• Destructive webhook setters warn before overwriting the current URL

Use cases of Monobank MCP Server

• Query account balances and jar details through an AI chat interface
• Fetch exchange rates for specific currency pairs without logging into Monobank
• Retrieve transaction statements for a given account within a 31‑day window
• Check or update the webhook URL attached to a personal token
• Discover FOP (business) accounts via the managedClients field

FAQ from Monobank MCP Server

How do I get a personal API token?

Open api.monobank.ua, scan the QR code with the Monobank app, and copy the generated token. The token is passed as an environment variable and never leaves your machine.

What are the rate limits?

Monobank personal endpoints allow 1 request per 60 seconds. The server’s 1‑hour cache serves repeated reads locally, so most usage won’t hit the limit. If exceeded, a clear error requests a 60‑second wait.

Can I fetch statements older than 31 days?

No. Each monobank-personal-statement request accepts a date range of up to 31 days. Split longer periods into multiple calls.

Which currency pairs are available?

Only UAH pairs (UAH/USD, UAH/EUR, etc.) and EUR/USD are supported. Use the monobank-bank-currency tool to list all available pairs.

Why don’t I see the managedClients field in client info?

That field appears only if your token is linked to a FOP (sole proprietor) account registered with Monobank. All personal tokens are identical; managedClients is simply absent when no business accounts exist.