mighty-mono-code— plugin

<p align="center"> <img src="https://img.shields.io/badge/tools-4-brightgreen" alt="4 tools" /> <img src="https://img.shields.io/badge/tests-60%20passing-brightgreen" alt="60 tests passing" /> <img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+" /> <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License" /> <img src="https://img.shields.io/badge/MCP-FastMCP-purple" alt="FastMCP" /> <img src="https://img.shields.io/badge/security-SSRF%20protected-orange" alt="SSRF protected" /> </p>

<h1 align="center">Mighty Mono MCP</h1>

<p align="center"> The most complete Monobank MCP server for Claude.<br/> Найповніший Monobank MCP сервер для Claude. </p>

<p align="center"> <strong>Claude Desktop</strong> · <strong>Claude Code</strong> · <strong>Claude Cowork</strong> · <strong>claude.ai</strong> · <strong>Claude Mobile</strong> </p>

Products / Продукти

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 / Інструменти

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 / Встановлення

<details> <summary><strong>Option A: Claude Code (plugin)</strong></summary>

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.

</details>

<details> <summary><strong>Option B: Claude Cowork (plugin)</strong></summary>

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

</details>

<details> <summary><strong>Option C: Claude Desktop (local, stdio)</strong></summary>

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.

</details>

<details> <summary><strong>Option D: claude.ai + Mobile (remote connector)</strong></summary>

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.

</details>

<details> <summary><strong>Option E: Standalone skills (no server)</strong></summary>

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.

</details>

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

Ask Claude things like:

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 / Порівняння

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

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](https://github.com/a-i-mighty) — building AI-powered tools that just work.

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