Mono

v1.0.0Finance & Fintechstable

A comprehensive Model Context Protocol (MCP) server for Nigerian banking operations using the Mono Open Banking API.

aiai-agentsfastmcpmcpmono-api
Share:
59
Stars
0
Downloads
0
Weekly
0/5

What is Mono?

Mono is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive model context protocol (mcp) server for nigerian banking operations using the mono open banking api.

A comprehensive Model Context Protocol (MCP) server for Nigerian banking operations using the Mono Open Banking API.

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A comprehensive Model Context Protocol (MCP) server for Nige

Use Cases

Nigerian open banking via Mono API
Account and transaction management
sin4ch

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedFeb 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mono

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Mono

The Mono MCP Server integrates Claude and other AI agents with Nigeria's open banking ecosystem through the Mono Open Banking API. It exposes 12 tools covering linked account management, balance retrieval, transaction history, payment initiation via Mono DirectPay, BVN identity verification, and support for all Nigerian bank codes — enabling AI-driven financial workflows for Nigerian banking customers and fintech developers.

Prerequisites

  • Python 3.9 or higher with uv package manager installed
  • A Mono Open Banking API account and API secret key
  • Mono webhook secret for HMAC signature verification
  • A database URL for SQLAlchemy (SQLite works for local development)
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Clone the repository

Clone the mono-mcp repository to your local machine.

git clone https://github.com/sin4ch/mono-mcp.git
cd mono-mcp
2

Install dependencies with uv

Use uv to install all project dependencies, which is the recommended approach for this project.

uv sync
3

Configure environment variables

Copy the example environment file and fill in your Mono API credentials, webhook secret, and database URL.

cp .env.example .env
# Edit .env with your Mono API key, webhook secret, and database URL
4

Verify the installation

Check that the package imports correctly before connecting a client.

python -c "from mono_banking_mcp.server import mcp; print('Package installed successfully')"
5

Configure Claude Desktop

Add the server to your claude_desktop_config.json so Claude can call the Mono banking tools. Alternatively, use the hosted deployment at https://mono-banking-mcp.fastmcp.app/mcp.

Mono Examples

Client configuration

Add this to your claude_desktop_config.json for local deployment. Replace paths and credential values accordingly.

{
  "mcpServers": {
    "mono-banking": {
      "command": "uv",
      "args": ["run", "python", "-m", "mono_banking_mcp.server"],
      "cwd": "/path/to/mono-mcp",
      "env": {
        "MONO_API_KEY": "your_mono_api_key",
        "MONO_WEBHOOK_SECRET": "your_webhook_secret",
        "DATABASE_URL": "sqlite:///./mono.db"
      }
    }
  }
}

Prompts to try

Use these prompts in Claude to interact with Nigerian bank accounts via the Mono API.

- "List all my linked bank accounts"
- "Show me the balance for account [account_id]"
- "Get my last 20 transactions for account [account_id]"
- "Verify the account name for account number 0123456789 at Zenith Bank"
- "Initiate a payment of ₦5000 to account 0123456789"
- "Display all supported Nigerian banks and their codes"

Troubleshooting Mono

Authentication errors when calling Mono API tools

Verify that MONO_API_KEY in your .env is correct and that your Mono account has the appropriate permissions for the operations you are attempting (read-only vs. payment initiation requires different access levels).

Database errors on startup

Ensure DATABASE_URL is set correctly. For local development, sqlite:///./mono.db creates a file-based SQLite database in the project directory with no extra setup. For PostgreSQL, ensure the database exists and the connection string is correct.

Webhook signature verification failures

Confirm that MONO_WEBHOOK_SECRET matches exactly what is configured in your Mono dashboard. HMAC verification is sensitive to whitespace and encoding; copy the secret directly from the Mono developer console.

Frequently Asked Questions about Mono

What is Mono?

Mono is a Model Context Protocol (MCP) server that comprehensive model context protocol (mcp) server for nigerian banking operations using the mono open banking api. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mono?

Follow the installation instructions on the Mono GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Mono?

Mono works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Mono free to use?

Yes, Mono is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mono": { "command": "npx", "args": ["-y", "mono"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Mono?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides