Monobank MCP Server

@todesstoss

About Monobank MCP Server

A Monobank MCP (Model Context Protocol) Server

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

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.

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.

Overview

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.

Frequently asked questions

How do I get a personal API token?

Open [api.monobank.ua](https://api.monobank.ua/index.html), 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?

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.