monobank

This MCP server exposes Monobank data inside MCP-enabled clients (like Claude Desktop). It provides core tools to access real-time currency rates, your client information, and transaction history, along with helper utilities and predefined resources and prompts to help you reason about banking data in natural language. Use the Monobank Tools to fetch currency rates, client info, and statements, and leverage Resources to attach structured data to conversations. Prompts are available to generate overviews, interpret statements, and analyze currency records, making it easier to build insightful AI-assisted reports of your finances.

Prerequisites:

• Docker installed and running on your system
• A Monobank API token obtained from Monobank API Portal
• Access to a MCP-compatible client (e.g., Claude Desktop)

Option A: Docker (recommended)

1. Pull and run the container with token:

# (Replace your_api_token with your actual token)
docker run --rm -i -e MONOBANK_API_TOKEN=your_api_token makyarm/monobank-mcp-server:latest

2. Configure your MCP client to point to this server. Example client config:

{
  "mcpServers": {
    "monobank": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "MONOBANK_API_TOKEN=your_api_token",
        "makyarm/monobank-mcp-server:latest"
      ]
    }
  }
}

3. Restart the MCP client to load the new configuration.

Option B: Manual installation (Java/Spring/Maven based)

1. Clone the repository and build the project to obtain the server JAR:

git clone https://github.com/yourusername/monobank-mcp-server.git
cd monobank-mcp-server
mvn clean package

2. Run or configure your MCP client to launch the JAR (provide token via environment or config as shown):

{
  "mcpServers": {
    "monobank": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/target/monobank-mcp-server.jar"
      ],
      "env": {
        "MONOBANK_API_TOKEN": "your_api_token"
      }
    }
  }
}

3. Restart the MCP client to load the new configuration.

Tips and common issues:

• Keep your MONOBANK_API_TOKEN private; do not share publicly.
• The server provides read-only access to Monobank data.
• If you rotate tokens, update the environment variable in your MCP client config.
• Docker method requires Docker to be installed and running with network access to Monobank APIs.
• Some MCP clients may cache resources; reference resources explicitly to ensure up-to-date data.
• Ensure your environment allows external network calls from the container or JVM process.