# Monobank MCP Server

Monobank MCP Server exposes your Monobank personal account as Model Context Protocol (MCP) tools.
> See [this repository](https://github.com/Aler1x/Monobank-MCP) by [@Aler1x](https://github.com/Aler1x) for Node.js/TypeScript implementation.

## Features

- Lightweight Python 3 server.
- Two ready-to-use MCP tools:
  - `get_client_info` – returns client, accounts and jars metadata.
  - `get_statement` – returns account statement for a given period (≤ 31 days).

## Quick Start

1. **Install dependencies**
   ```bash
   uv pip install -r pyproject.toml # or use your preferred tool
   ```
2. **Create `.env`** (in the project root) containing your Monobank token:
   ```dotenv
   MONOBANK_API_TOKEN=<your_personal_token>
   ```
3. **Register the server in your MCP configuration**
   ```json
   {
     "mcpServers": {
       "monobank-mcp": {
         "command": "python3.11 /path/to/monobank-mcp/main.py"
       }
     }
   }
   ```
4. **Run your MCP client** – the two tools will be available immediately.

## Tool Reference

| Tool              | Description                                                                                                                       | Rate limits      |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| `get_client_info` | Fetches client profile, list of accounts and jars.                                                                                | 1 request / 60 s |
| `get_statement`   | Retrieves transaction list for a specific account and time range.<br/>Parameters: `account_id`, `from_timestamp`, `to_timestamp`. | 1 request / 60 s |

## Environment Variables

| Name                 | Required | Description                       |
| -------------------- | -------- | --------------------------------- |
| `MONOBANK_API_TOKEN` | ✅       | Your personal Monobank API token. |

## License

MIT