MCP.so
登录

Monobank MCP Server

@todesstoss

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

todesstoss

关于 Monobank MCP Server

A Monobank MCP (Model Context Protocol) Server

#monobank#api#server

Monobank MCP Server 配置

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

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

Monobank MCP Server 工具

2

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.

概览

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

常见问题

1

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.

2

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.

3

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.

4

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.

5

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.

评论

其他 分类下的更多 MCP 服务器