Mighty Mono MCP

The most complete Monobank MCP server for Claude.
Найповніший Monobank MCP сервер для Claude.

Claude Desktop · Claude Code · Claude Cowork · claude.ai · Claude Mobile

Products / Продукти

| Product | Platform | Install | |---------|----------|---------| | mighty-mono-mcp | Claude Desktop | MCP server (stdio) — add to claude_desktop_config.json | | mighty-mono-code | Claude Code | Plugin — install from marketplace or --plugin-dir | | mighty-mono-work | Claude Cowork | Plugin — install from marketplace | | Standalone skills | Any Claude product | Copy SKILL.md files to .claude/skills/ |

All products share the same 4 tools and security-hardened server.

Why Mighty Mono? / Чому Mighty Mono?

Most Monobank MCP servers give you 1-2 tools with raw JSON output. Mighty Mono gives you 4 hardened tools with Markdown-formatted responses, income/expense totals, jar progress tracking, and SSRF-protected webhook setup. It works everywhere Claude does — Desktop, browser, and mobile.

Більшість Monobank MCP серверів мають 1-2 інструменти з сирим JSON. Mighty Mono дає 4 захищені інструменти з Markdown-форматуванням, підрахунком доходів/витрат, прогресом банок та SSRF-захищеним вебхуком. Працює скрізь, де працює Claude — Desktop, браузер і мобільний.

Tools / Інструменти

| Tool | Auth | Description / Опис | |------|------|--------------------| | mono_get_currency_rates | No | Exchange rates with optional currency filter. Cached 5 min. / Курси валют з фільтром. Кеш 5 хв. | | mono_get_client_info | Yes | Accounts, balances, jars with progress %, FOP accounts / Рахунки, баланси, банки з прогресом, ФОП | | mono_get_statements | Yes | Transactions with income/expense/net totals, cashback, MCC codes / Транзакції з підсумками, кешбек, MCC | | mono_set_webhook | Yes | Real-time transaction notifications via webhook / Сповіщення в реальному часі через вебхук |

Quick Start / Швидкий старт

1. Get your token / Отримайте токен

Go to https://api.monobank.ua/ → log in with Monobank app → copy your personal API token.

Перейдіть на https://api.monobank.ua/ → увійдіть через додаток Monobank → скопіюйте токен.

2. Install / Встановлення

Option A: Claude Code (plugin)

Install mighty-mono-code from the Claude Code marketplace, or test locally:

git clone https://github.com/a-i-mighty/mighty-mono-mcp.git
claude code --plugin-dir mighty-mono-mcp/mighty-mono-code

Enter your Monobank token when prompted. Dependencies install automatically.

Option B: Claude Cowork (plugin)

Install mighty-mono-work from the Claude Cowork marketplace. Same setup as Claude Code — enter your token, and you're ready.

Option C: Claude Desktop (local, stdio)

git clone https://github.com/a-i-mighty/mighty-mono-mcp.git
cd mighty-mono-mcp
pip install -r mighty-mono-mcp/requirements.txt

Edit your Claude Desktop config:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "monobank": {
      "command": "python",
      "args": ["C:\\path\\to\\mighty-mono-mcp\\mighty-mono-mcp\\server.py"],
      "env": {
        "MONOBANK_TOKEN": "your_token_here"
      }
    }
  }
}

Restart Claude Desktop. Done.

Option D: claude.ai + Mobile (remote connector)

This method works on Claude Desktop, claude.ai in browser, AND the Claude mobile app.

Step 1. Install cloudflared (one-time):

# Windows
winget install cloudflare.cloudflared
# macOS
brew install cloudflare/cloudflare/cloudflared

Step 2. Start the server:

set MONOBANK_TOKEN=your_token_here    # Windows
export MONOBANK_TOKEN=your_token_here  # macOS/Linux
python remote/server.py

Step 3. Open a tunnel (in a second terminal):

cloudflared tunnel --url http://localhost:8000

Step 4. Add to Claude:

Go to claude.ai → Settings → Connectors → + Add
Name: Monobank
URL: https://your-tunnel-url.trycloudflare.com/mcp
Leave OAuth empty → Save

Works instantly on browser and mobile.

Option E: Standalone skills (no server)

Copy individual skill files from customize/skills/ to your .claude/skills/ directory:

# Copy all 4 skills
cp -r customize/skills/mono-* ~/.claude/skills/

# Or just the ones you need
cp -r customize/skills/mono-currency-rates ~/.claude/skills/

These skills teach Claude how to use the Monobank API directly via curl — no MCP server required.

What it looks like / Як це виглядає

Ask Claude things like:

| You say / Ви кажете | Claude does / Claude робить | |----------------------|----------------------------| | "What's the USD/UAH rate?" | Pulls rates, shows Markdown table | | "Show my balances" | Lists all accounts + jars with progress bars | | "How much did I spend last week?" | Fetches transactions, calculates income/expenses/net | | "What's my biggest expense this month?" | Pulls statements, analyzes by amount | | "Set webhook at https://my-server.com/hook" | Configures real-time notifications |

Security / Безпека

This server was security-audited before release:

SSRF protection — webhook URLs are validated against private/reserved IPs (127.0.0.1, 192.168.x.x, 169.254.x.x, IPv6 loopback)
Path traversal protection — account IDs are regex-validated, no injection possible
Input validation — all inputs validated via Pydantic with strict models (extra="forbid")
No secret leaks — error handler sanitizes exceptions, no internal paths exposed
Token stays local — your API token is only sent to api.monobank.ua, never stored or logged
MCP annotations — tools declare readOnlyHint, destructiveHint, idempotentHint for safe AI behavior

Tests / Тести

60 tests covering helpers, validation, security, and all 4 tools:

pip install pytest pytest-asyncio
pytest tests/ -v

tests/test_server.py::TestWebhookInputValidation::test_localhost_blocked PASSED
tests/test_server.py::TestWebhookInputValidation::test_private_ip_blocked PASSED
tests/test_server.py::TestStatementsInputValidation::test_path_traversal_blocked PASSED
tests/test_server.py::TestHandleApiError::test_generic_error_no_leak PASSED
...
============================== 60 passed in 0.50s ==============================

Comparison / Порівняння

| Feature | Mighty Mono | Server A | Server B | Server C | |---------|:--------------:|:--------:|:--------:|:--------:| | Tools | 4 | 3 | 2 | 1 | | Webhook support | Yes | No | No | No | | Remote connector (claude.ai/mobile) | Yes | No | No | No | | Markdown output | Yes | JSON | JSON | Partial | | Income/expense totals | Yes | No | No | No | | Jar progress % | Yes | No | No | No | | FOP/business accounts | Yes | No | No | No | | Currency filter | Yes | No | N/A | N/A | | SSRF protection | Yes | No | No | No | | Path traversal protection | Yes | No | No | No | | MCP annotations | Yes | No | No | No | | Tests | 60 | 0 | 0 | 0 | | Security audit | Yes | No | No | No |

Rate Limits / Обмеження

| Endpoint | Limit / Ліміт | |----------|---------------| | Currency rates | No limit (cached 5 min server-side) | | Client info | 1 request per 60 seconds | | Statements | 1 request per 60 seconds, max 31-day window | | Webhook setup | No documented limit |

Project Structure / Структура

monobank-mcp/
├── mighty-mono-mcp/       # Claude Desktop (stdio server)
│   ├── server.py          # MCP server (4 tools, FastMCP)
│   ├── manifest.json      # Claude Desktop manifest
│   └── requirements.txt
├── mighty-mono-code/      # Claude Code plugin
│   ├── .claude-plugin/    # Plugin manifest
│   ├── skills/            # 4 specialized skills
│   ├── server/            # Bundled server
│   └── hooks/             # Auto-dependency installer
├── mighty-mono-work/      # Claude Cowork plugin
│   └── (same structure as mighty-mono-code)
├── customize/skills/      # Standalone skills (manual install)
├── remote/                # Remote HTTP server (claude.ai/mobile)
├── tests/                 # 60 tests
├── demo.html              # Interactive showcase
└── start.bat              # Windows quick-start (remote)

Requirements / Вимоги

Python 3.10+
Monobank personal API token (get one here)
For remote mode: cloudflared

License / Ліцензія

MIT — use it, fork it, improve it.

Built by / Створено

AI Mighty — building AI-powered tools that just work.

_{If this helped you, star the repo — it helps others find it too.}
_{Якщо це було корисно — поставте зірку, це допомагає іншим знайти проєкт.}

MCP Servers