# Monnify MCP

> Monnify MCP connects your Nigerian payment gateway to your AI agent, letting you manage complex financial operations through natural conversation. You can create customer virtual bank accounts, check real-time transaction statuses, and track payouts and settlements without manually logging into a dashboard or calling support.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** payment-gateway, virtual-accounts, transaction-monitoring, nigeria-fintech, financial-services

## Description

Need to handle payments in Nigeria? This MCP lets you connect directly to Monnify's merchant account using your AI agent. Instead of juggling dashboards and API calls, you just talk to your agent about what you need done. You can list all transactions, check the status of a payment reference, or create dedicated virtual accounts for new customers on demand. It’s built specifically for managing Nigerian payments, giving you real-time visibility into everything from initial card payments to final bank settlements.

When you use your agent through Vinkius, it handles the connection and execution flow, making complex financial tasks feel like simple chat commands. You can monitor daily collections by checking outgoing transfers or pull digital invoices instantly. It’s all about taking away the friction of traditional payment management.

## Tools

### get_account_details
Retrieves the specific details of a reserved customer bank account.

### list_settlements
Gathers a list detailing all payouts and merchant settlements received into your main account.

### get_transaction
Pulls the full details for one specific payment transaction based on its reference number.

### init_payment
Starts a new payment process and generates the necessary checkout link or URL for card payments.

### list_reserved_accounts
Provides an overview of all virtual accounts you have reserved for customers.

### list_banks
Retrieves a list of every supported Nigerian bank that Monnify works with.

### list_monnify_invoices
Lists all digital invoices generated and stored on the Monnify platform for your business.

### list_transactions
Provides a summary view of all payment transactions that have occurred through Monnify.

### list_disbursements
Lists and tracks outgoing bank transfers or payouts initiated from your account.

### reserve_account
Creates a new, dedicated virtual bank account for a customer immediately.

## Prompt Examples

**Prompt:** 
```
List my most recent transactions on Monnify.
```

**Response:** 
```
I've fetched your recent transactions. You have 8 transactions today, totaling ₦45,000. Most are 'SUCCESSFUL', but one with reference 'REF-123' is 'PENDING'. Would you like the details for the pending one?
```

**Prompt:** 
```
Reserve a virtual account for a new customer named 'Ayo Balogun'.
```

**Response:** 
```
Initializing account reservation... I've successfully reserved a virtual account for Ayo Balogun. The Account Number is 1234567890 (Wema Bank) and the Account Name is 'YOUR_COMPANY Ayo Balogun'. Shall I provide the payment reference?
```

**Prompt:** 
```
List all Nigerian banks supported by Monnify.
```

**Response:** 
```
Retrieving supported banks... Monnify supports 25+ banks including Access Bank, GTBank, Zenith Bank, First Bank, and United Bank for Africa (UBA). Would you like to see the full list with their bank codes?
```

## Capabilities

### Check Payment History
Retrieve a comprehensive list of recent payments, including their status and unique references.

### Manage Virtual Accounts
Create dedicated virtual bank accounts for customers or get full details on existing reserved accounts.

### Process Payments On Demand
Start new payment processes and generate the necessary checkout URLs for card or transfer payments.

### Track Funds Movement
List and track outgoing bank transfers (disbursements) and monitor final settlement payouts to your main corporate account.

### Reference Financial Records
Access digital invoices, list supported Nigerian banks, or get the details for any specific transaction reference.

## Use Cases

### The Customer Service Inquiry
A customer calls asking about a payment from three days ago. Instead of having the agent ask for an account number, you simply tell it to get_transaction using the reference ID they provide, giving them instant status confirmation.

### New User Onboarding
A startup needs to onboard 50 new beta users quickly. You use reserve_account repeatedly and then list_reserved_accounts to confirm all accounts are live before starting testing payments using init_payment.

### End-of-Week Reconciliation
It's time to close books. Your agent automatically runs list_settlements, lists_disbursements, and pulls list_monnify_invoices to compile a complete financial picture for the accounting team.

### Troubleshooting Failed Payments
A merchant notices payments are failing. They use list_banks first to confirm supported banks, then check list_transactions to identify which bank codes might be causing issues.

## Benefits

- Stop manually checking statuses. Use get_transaction or list_transactions to instantly confirm if a payment is successful, pending, or failed.
- Speed up onboarding. With reserve_account and list_reserved_accounts, you can provision unique virtual accounts for new users in seconds via your agent's command.
- Simplify reconciliation. Monitor outgoing funds with list_disbursements and track final payouts using list_settlements, all from one conversation.
- Reduce friction at checkout. The init_payment tool generates payment links instantly, allowing you to guide customers through payments without complex setups.
- Full visibility into records. Use list_monnify_invoices or list_transactions to pull every necessary record for auditing and customer support.

## How It Works

The bottom line is that once connected, your AI agent handles all the necessary calls to Monnify so you don't have to write a single line of code.

1. First, subscribe to this MCP and provide your Monnify API Key and Secret Key credentials.
2. Next, authorize your AI agent client (like Cursor or Claude) through the Vinkius marketplace.
3. Finally, simply tell your agent what you need—for example, 'List all transactions from yesterday,' and it executes the call using the stored keys.

## Frequently Asked Questions

**How do I check my recent transactions using Monnify MCP?**
You use list_transactions to get a summary view. This tool provides a quick overview of all payments, letting you see the status and references for immediate checks.

**What is the difference between list_settlements and list_disbursements in Monnify MCP?**
list_settlements tracks money coming *into* your corporate bank account from Monnify. list_disbursements track money going *out* of your account, like payouts or transfers.

**Can I create a new virtual account with the Monnify MCP?**
Yes, you use reserve_account to instantly generate and provision a unique virtual bank account for any customer. You can then list_reserved_accounts to see all active accounts.

**What if I need details on one specific payment? Monnify MCP?**
Use get_transaction, feeding it the relevant reference ID. This pulls the complete history and status for that single transaction, eliminating guesswork.

**Does Monnify MCP help me list supported banks?**
Yes, the list_banks tool provides a current and comprehensive list of all Nigerian banks that Monnify supports for transactions and payouts.