home / mcp / monobank mcp server

Monobank MCP Server

Provides access to Monobank data via MCP prompts for currency rates, client info, and statements.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "akutishevsky-monobank-mcp-server": {
      "url": "https://mcp.monobank.example/mcp",
      "headers": {
        "MONOBANK_API_TOKEN": "your_token_here"
      }
    }
  }
}

You run a Monobank MCP Server to connect your Monobank data with clients through the MCP (Model Context Protocol). It lets you securely obtain currency rates, client information, and account statements via simple MCP prompts, while keeping your Monobank API token local to your runtime.

How to use

To use this server with an MCP client, start the server locally with your Monobank API token and then send prompts to access currency rates, client info, or statements. Use natural language prompts such as asking for current currency rates, checking account balances, or requesting statements for a specific date range. The server enforces rate limits per tool to protect both you and the service.

How to install

Prerequisites you need before installation are Node.js 18.0.0 or higher and a Monobank API token. You obtain your API token from the Monobank API portal.

Install and run the MCP server locally with the following steps.

# 1) Ensure you have Node.js 18+ installed
node -v

# 2) Install or run the MCP server using npx (no global install required)
MONOBANK_API_TOKEN=your_token_here npx monobank-mcp-server

Additional content

Configuration notes: you provide your Monobank API token as an environment variable when starting the server. The server exposes three tools you can call through MCP prompts: get_currency_rates, get_client_info, and get_statement. Each tool has its own rate limits to manage usage (currency rates once every 5 minutes; client info and statements more frequently within their limits).

Available tools

get_currency_rates

Fetch current currency exchange rates with a rate limit of once every 5 minutes.

get_client_info

Retrieve client information and account details with a rate limit of once per 60 seconds.

get_statement

Retrieve account statements for a specified date range with a rate limit of once per 60 seconds (max 31 days + 1 hour).