Monobank MCP Server

Name: Monobank MCP Server
Author: todesstoss

@todesstoss

代码仓库

关于 Monobank MCP Server

A Monobank MCP (Model Context Protocol) Server

#monobank #api #server

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

todesstoss

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.