Monobank

Exposes Monobank data as MCP tools to fetch client info and statements.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nklymok-monobank-mcp": {
      "command": "python3.11",
      "args": [
        "/path/to/monobank-mcp/main.py"
      ],
      "env": {
        "MONOBANK_API_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

You can access your Monobank data as MCP tools, enabling programmatic queries for client info and statements from your Monobank account using a lightweight Python MCP server.

How to use

Install and run the Monobank MCP Server, then connect your MCP client to the local/remote MCP server. You will have two MCP tools available: get_client_info to fetch client profile, accounts, and jars metadata, and get_statement to retrieve account statements for a chosen period. Use these tools to automate data retrieval, build dashboards, or integrate Monobank data into your applications.

How to install

Prerequisites: Python 3.x and a package manager to install dependencies.

uv pip install -r pyproject.toml # or use your preferred tool

Configuration and usage notes

Create a configuration that registers the MCP server so your MCP client can discover and communicate with it.

{
  "mcpServers": {
    "monobank-mcp": {
      "command": "python3.11 /path/to/monobank-mcp/main.py"
    }
  }
}

Run and access the tools

Set up your environment with your Monobank token and start using the MCP client to call get_client_info and get_statement. The tools are available immediately after the server starts.

Security and usage notes

Protect your Monobank API token. Store it securely, and avoid embedding it in code or logs. The server expects the token to be provided via environment variables as shown in the configuration.

Troubleshooting tips

If you encounter connection issues, verify that the MCP server process is running and that your MCP client is configured to point to the correct server name (monobank-mcp) and port. Ensure the MONOBANK_API_TOKEN is set in the environment where the server runs.

Notes on tools and limits

The available MCP tools are:

get_client_info — Fetches client profile, list of accounts and jars.
get_statement — Retrieves transaction list for a specific account and time range. Rate limits apply: get_client_info and get_statement are limited to 1 request per 60 seconds respectively.