{
  "markdown": "# Monobank MCP Server\n\nMCP (Model Context Protocol) server for integrating with Monobank API.\n\n## Quick Install\n\nDownload the latest `.mcpb` bundle from the [Releases](https://github.com/akutishevsky/monobank-mcp-server/releases) page and open it — Claude Desktop or Claude Code will handle the rest. You'll be prompted to enter your Monobank API token during installation.\n\n## Prerequisites\n\n- Node.js 18.0.0 or higher\n- A Monobank API token. You can obtain it at: https://api.monobank.ua/\n\n**Note:** Your API token is only used locally and is never tracked or transmitted anywhere except to Monobank's API.\n\n## Available Tools\n\nThe server provides three tools:\n\n1. **get_currency_rates** - Get currency exchange rates. Public endpoint; works without an API token.\n2. **get_client_info** - Get client information, accounts and jars. Requires a token.\n3. **get_statement** - Get the statement for an account or jar over a date range. Requires a token. Maximum range is 31 days + 1 hour.\n\n### Behaviour worth knowing\n\n- **Amounts are returned in currency units, not cents.** A balance of 100,000.00 UAH is reported as `100000`, not `10000000`. This applies to every monetary field in both `get_client_info` and `get_statement`, including `commissionRate`, which Monobank returns as an absolute amount despite its name.\n- **Responses are cached in memory** so that Monobank's rate limits are not exceeded: 5 minutes for currency rates, 60 seconds for client info and for each distinct statement query. A repeated call inside that window returns the cached result instead of failing with `HTTP 429`.\n- **Statement dates** are ISO 8601 `YYYY-MM-DD`, interpreted as UTC. The `to` date is **inclusive** — a statement from `2024-10-01` to `2024-10-31` covers all of October 31. Omit `to` to mean \"up to now\".\n- **The statement `account` parameter defaults to `0`**, the client's default account. Account and jar identifiers returned by `get_client_info` are also accepted.\n- **`MONOBANK_API_TOKEN` is only needed for `get_client_info` and `get_statement`.** The server starts without it and `get_currency_rates` keeps working; the two authenticated tools return an error explaining that the variable is unset.\n\n## MCP Configuration\n\nTo use this server with an MCP client, add it to your configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"monobank\": {\n      \"command\": \"npx\",\n      \"args\": [\"monobank-mcp-server\"],\n      \"env\": {\n        \"MONOBANK_API_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Example Prompts\n\n### English\n- \"Show me the current USD to UAH exchange rate\"\n- \"Get my account balance and recent transactions\"\n- \"Show me all transactions from the last week\"\n- \"What did I spend money on yesterday?\"\n- \"Show my statement for October 2024\"\n- \"Get all my credit card transactions from the last 3 days\"\n\n### Українською\n- \"Покажи поточний курс долара\"\n- \"Скільки грошей на моїх рахунках?\"\n- \"Покажи виписку за вчора\"\n- \"На що я витратив гроші цього тижня?\"\n- \"Покажи всі транзакції за жовтень\"\n- \"Скільки я витратив на їжу за останній місяць?\"\n\n## MCPB (One-Click Installation)\n\nThis server is available as an MCPB bundle for one-click installation in Claude Desktop and Claude Code.\n\nTo build the `.mcpb` bundle locally:\n\n```bash\nnpm run pack:mcpb\n```\n\nThis produces `monobank-mcp-server.mcpb` which can be installed directly in any MCPB-compatible client. During installation, you'll be prompted to enter your Monobank API token securely.\n\n## License\n\nMIT\n",
  "bytes": 3469,
  "sha": "0b253a5295de493927aee6e5c5e11f8fc689053c0b608069aa8f98267dcf21a5",
  "repo_slug": "akutishevsky/monobank-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_akutishevsky_monobank_mcp_serv_374cbf54/readme"
}