Monei MCP Server
Allows interaction with the Ethereum blockchain for portfolio queries, sending ETH and ERC-20 tokens, and swapping tokens on Ethereum via the Monei API.
Allows interaction with the Optimism blockchain for portfolio queries, sending ETH and ERC-20 tokens, and swapping tokens on Optimism via the Monei API.
Allows interaction with the Polygon blockchain for portfolio queries, sending MATIC and ERC-20 tokens, and swapping tokens on Polygon via the Monei API.
Allows interaction with the Solana blockchain for portfolio queries, sending SOL and SPL tokens, and swapping tokens on Solana via the Monei API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Monei MCP Server What's my wallet balance?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@mrmonei/mcp-server
MCP server for the Monei API. Gives any AI agent access to wallets, transfers, crypto sends, swaps, offramp, and bill payments through natural language.
Works with Claude Desktop, Cursor, and any MCP compatible agent platform.
Quick start
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"monei": {
"command": "npx",
"args": ["-y", "@mrmonei/mcp-server"],
"env": {
"MONEI_API_KEY": "your_api_key_here",
}
}
}
}Restart Claude Desktop. You should see the Monei tools available in the tools menu.
Cursor (local)
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"monei": {
"command": "npx",
"args": ["-y", "@mrmonei/mcp-server"],
"env": {
"MONEI_API_KEY": "your_api_key_here"
}
}
}
}Cursor (remote via Railway)
{
"mcpServers": {
"monei": {
"url": "https://mcp.monei.cc/sse",
"headers": {
"Authorization": "Bearer your_api_key_here"
}
}
}
}Related MCP server: starling-bank-mcp
Environment variables
Variable | Required | Default | Description |
| Yes (stdio) | — | Your Monei API key. Not required in HTTP/SSE mode — pass via |
| No |
| Transport mode: |
| No |
| HTTP/SSE server port |
| No |
| Request timeout in milliseconds. Max 120000 |
| No |
| Override the live API base URL |
Transport modes
Mode | Use case | How to start |
| Claude Desktop, local Cursor | Default — just run the server |
| Custom agents, API integrations |
|
| Cursor remote, Claude.ai |
|
In http and sse modes the server is stateless and multi-user. Each client passes their own API key via Authorization: Bearer <key>. One deployed server serves many users.
Tool reference
Account
monei_get_account
Returns the authenticated user's profile.
Inputs: none
Returns:
{
"id": "string",
"email": "string",
"firstName": "string",
"lastName": "string",
"phone": "string"
}Example prompt: "Who am I logged in as?"
Wallet
monei_get_wallet
Returns NGN balance and all subwallets.
Inputs: none
Returns:
{
"ngnBalance": "number",
"subWallets": [{ "id": "string", "type": "string", "balance": "number" }]
}Example prompt: "What's my wallet balance?"
monei_get_evm_portfolio
Returns the full token portfolio for an EVM chain including USD values.
Inputs:
Field | Type | Required | Description |
| number | Yes | Chain ID. 56=BSC, 137=Polygon, 8453=Base, 1=Ethereum |
Example prompt: "What tokens do I have on Base?"
monei_get_solana_portfolio
Returns SOL and all SPL token balances with USD values.
Inputs: none
Example prompt: "Show my Solana wallet"
monei_get_my_solana_address
Returns the user's Solana wallet address.
Inputs: none
Example prompt: "What's my Solana address? I want to receive SOL."
monei_get_supported_networks
Lists all supported EVM chains with chain IDs and names.
Inputs: none
Example prompt: "What chains do you support?"
Deposits
monei_generate_deposit_link
Generates a payment link the user can open to deposit NGN.
Inputs:
Field | Type | Required | Description |
| number | Yes | Amount in NGN to deposit |
Returns:
{
"paymentLink": "string",
"reference": "string"
}Example prompt: "I want to deposit ₦50,000 into my Monei account"
monei_check_deposit_status
Checks the status of a deposit by reference.
Inputs:
Field | Type | Required | Description |
| string | Yes | Reference from |
Example prompt: "Did my deposit go through?"
NGN Payouts
monei_send_naira_to_bank
Sends NGN to a Nigerian bank account.
Inputs:
Field | Type | Required | Description |
| number | Yes | Amount in NGN |
| string | Yes | Bank code from |
| string | Yes | 10-digit account number |
| string | Yes | User's 4-6 digit transaction PIN |
| string | No | Transfer description |
Always call
monei_verify_bank_accountfirst and show the account name to the user before sending.
Example prompt: "Send ₦20,000 to my GTBank account 0123456789"
monei_send_naira_to_user
Sends NGN to another Monei user by email or phone.
Inputs:
Field | Type | Required | Description |
| string | Yes | Recipient email or phone number |
| number | Yes | Amount in NGN |
| string | Yes | User's 4-6 digit transaction PIN |
Example prompt: "Send ₦5,000 to john@gmail.com"
Banking utilities
monei_get_banks
Returns the full list of supported Nigerian banks with their codes.
Inputs: none
Example prompt: "What banks do you support?" / "What's the bank code for GTBank?"
monei_verify_bank_account
Verifies a bank account number and returns the account holder name.
Inputs:
Field | Type | Required | Description |
| string | Yes | 10-digit bank account number |
| string | Yes | Bank code from |
Returns:
{
"accountName": "string",
"accountNumber": "string",
"bankCode": "string"
}Always call this before any bank payout and show the account name to the user for confirmation.
Example prompt: "Verify account 0123456789 at GTBank"
Crypto sends
monei_send_crypto_evm
Sends native tokens or ERC-20s on any supported EVM chain.
Inputs:
Field | Type | Required | Description |
| string | Yes | Recipient wallet address (0x...) |
| string | Yes | Amount to send as a string (e.g. "0.1") |
| number | Yes | Chain ID |
| string | No | ERC-20 contract address. Omit for native token sends |
Example prompts:
"Send 0.01 ETH to 0x742d..."
"Send 100 USDT on BSC to 0x..."
monei_send_crypto_solana
Sends SOL or SPL tokens on Solana.
Inputs:
Field | Type | Required | Description |
| string | Yes | Recipient Solana address |
| string | Yes | Amount to send |
| string | No | SPL token mint address. Omit for SOL sends |
Example prompts:
"Send 2 SOL to 5AH3..."
"Send 50 USDC on Solana to 5AH3..."
Token swaps
monei_swap_tokens_evm
Swaps tokens on EVM. Routes automatically based on whether tokens are native or ERC-20.
Inputs:
Field | Type | Required | Description |
| string | Yes | Amount to swap |
| number | Yes | Chain ID |
| string | No | ERC-20 contract to sell. Omit when selling native token |
| string | No | ERC-20 contract to buy. Omit when buying native token |
| number | No | Slippage tolerance in basis points. Default: 50 (0.5%) |
Example prompts:
"Swap 0.1 ETH for USDC on Base"
"Swap 100 USDC for USDT on Polygon"
monei_swap_tokens_solana
Swaps tokens on Solana. Routes automatically between SOL and SPL tokens.
Inputs:
Field | Type | Required | Description |
| number|string | Yes | Amount to swap |
| string | No | Mint address of token to sell. Omit when selling SOL |
| string | No | Mint address of token to buy. Omit when buying SOL |
| number | No | Slippage tolerance in basis points. Default: 50 (0.5%) |
Example prompts:
"Swap 1 SOL for USDC"
"Swap 100 USDC for SOL"
Offramp
monei_get_offramp_quote
Gets the live exchange rate for selling crypto to NGN.
Inputs:
Field | Type | Required | Description |
| string | Yes | Token to sell: |
| string | Yes | Network: |
| number | Yes | Amount of token to sell |
| string | No | Fiat to receive. Default: |
Example prompt: "What's the rate for selling 100 USDT on Base today?"
monei_sell_crypto_for_naira
Sells crypto and settles the proceeds to a Nigerian bank account.
Inputs:
Field | Type | Required | Description |
| number | Yes | Amount of token to sell |
| string | Yes | Token to sell: |
| string | Yes | Network the token is on |
| string | No | Default: |
| string | Yes | Destination bank code |
| string | Yes | Destination account number |
| string | Yes | Account holder name from |
Returns:
{
"reference": "string",
"status": "string",
"amounts": { "crypto": {}, "fiat": {}, "exchangeRate": 0, "totalFee": 0 },
"onChain": { "depositAddress": "string" }
}Call
monei_get_offramp_quotefirst to show the rate. Callmonei_verify_bank_accountto get theaccountName. Show both to the user for confirmation before calling this.
Example prompt: "Sell 100 USDT on Base to my GTBank account 0123456789"
monei_track_offramp
Checks the status of an offramp transaction.
Inputs:
Field | Type | Required | Description |
| string | Yes | Reference from |
Statuses: initiated → awaiting_deposit → deposit_received → processing → fiat_sent → completed
Example prompt: "What's the status of my USDT sale?"
Bill payments
monei_get_bill_providers
Lists available billers and packages for a bill category.
Inputs:
Field | Type | Required | Description |
| string | Yes |
|
| string | Conditional | Required for non-electricity categories (e.g. |
Example prompts:
"What MTN data plans are available?"
"What electricity providers do you support?"
monei_pay_bill
Pays a bill. Routes to the correct payment method based on category.
Common inputs: category (required), plus category-specific fields:
Category | Required fields |
|
|
|
|
|
|
|
|
All categories also accept isSchedule, scheduleData, saveBeneficiary, beneficiaryName.
Always call
monei_get_bill_providersfirst to get validbilleranditemCodevalues.
Example prompts:
"Buy ₦1,000 MTN airtime for 08012345678"
"Pay ₦5,000 to my IKEDC meter 12345678901"
"Subscribe DSTV Compact for smartcard 1234567890"
"Pay my DSTV every month on the 1st"
monei_get_bill_history
Returns recent bill payment history across all categories.
Inputs: none
Example prompt: "Show my recent bill payments"
Transactions
monei_get_transaction_history
Returns recent wallet transactions.
Inputs: none
Example prompt: "Show my recent transactions"
monei_get_transaction
Gets a single transaction by ID or reference.
Inputs:
Field | Type | Required | Description |
| string | Yes | Transaction ID or reference string |
Example prompt: "What happened with transaction ref_abc123?"
Common agent patterns
These natural language prompts work well out of the box:
Check balance and send naira
"Check my balance, then send ₦10,000 to my GTBank account 0123456789. The bank code is 058."
Agent flow: get_wallet → verify_bank_account → confirm with user → send_naira_to_bank
Full offramp flow
"I want to sell 200 USDT on Polygon to my Access Bank account 0987654321"
Agent flow: get_offramp_quote → get_banks → verify_bank_account → show rate + account name → confirm → sell_crypto_for_naira → track_offramp
Buy airtime
"Buy ₦500 Airtel airtime for 08098765432"
Agent flow: get_bill_providers (AIRTIME, Airtel) → get_wallet → pay_bill
Swap and check
"Swap 0.05 ETH for USDC on Base, then show me my updated portfolio"
Agent flow: get_evm_portfolio → confirm → swap_tokens_evm → get_evm_portfolio
Peer transfer
"Send ₦2,000 to jane@example.com from my Monei wallet"
Agent flow: get_wallet → confirm balance → send_naira_to_user
Troubleshooting
Tools not showing up in Claude Desktop
Check that
MONEI_API_KEYis set inclaude_desktop_config.jsonRestart Claude Desktop fully after config changes
Check stderr logs:
tail -f ~/Library/Logs/Claude/mcp*.log(macOS)
Authentication failed — your API key is invalid or expired
Verify your API key in the Monei dashboard
Make sure
MONEI_ENVmatches the environment your key belongs to (sandbox vs live)In HTTP/SSE mode, check the
Authorization: Bearerheader is being sent
Rate limit exceeded — please wait a moment
The server automatically retries up to 3 times with exponential backoff
If you see this in a tool response, the retries were exhausted — wait 30 seconds and try again
Session not found or expired (SSE mode)
The SSE session expired (1 hour TTL) or the server restarted
Re-open the
/sseconnection your MCP client will reconnect automatically in most cases
Zod validation errors on tool inputs
The agent passed a wrong type (e.g.
"100"instead of100for an amount)All amount fields use
z.coerce.number()so string numbers are acceptedIf you see this, check the exact field name in the error message and fix the agent prompt
Security
API keys never appear in logs, error messages, or stack traces
Transaction PINs are request-scoped. never stored, cached, or logged
Zod validation runs before the SDK is touched. invalid input is rejected immediately
License
MIT
Available Tools
24 toolsmonei_check_deposit_statusCheck Deposit StatusARead-onlyIdempotent
Checks the status of a deposit by its reference string.
Use this after generating a deposit link to confirm whether the user has completed payment. Poll this every 30-60 seconds if the user is waiting.
Args:
reference (string): The reference returned from monei_generate_deposit_link
Returns: { "reference": string, "status": string, // "PENDING" | "COMPLETED" | "FAILED" | "CANCELLED" "amount": number, "currency": string, "paidAt": string | null }
Examples:
"Did my deposit go through?" -> call this with the reference from the deposit link
"Check if the ₦50k arrived" -> call this with the deposit reference
Inputs: reference (required).
monei_generate_deposit_linkGenerate Deposit LinkA
Generates a payment link the user can open to deposit NGN into their Monei wallet.
This is the simplest deposit path and works in one call. The user opens the returned link, completes payment via their bank, and the funds arrive in their NGN wallet. Card and USSD multi-step flows are not supported through this tool.
Args:
amount (number): Amount in NGN to deposit (e.g. 50000 for ₦50,000)
customerEmail (string, optional): Pre-fills the email field on the payment page
customerName (string, optional): Pre-fills the name field on the payment page
customerPhone (string, optional): Pre-fills the phone field on the payment page
Returns: { "paymentLink": string, // URL the user opens to complete the deposit }
After returning the link, tell the user to open it to complete payment. Then they can ask you to check the status using the reference.
Examples:
"I want to deposit ₦50,000" -> amount: 50000
"Add ₦10k to my wallet" -> amount: 10000
Inputs: amount (required), customerName, customerEmail, customerPhone.
monei_get_accountGet AccountARead-onlyIdempotent
Returns the profile of the currently authenticated Monei user.
Use this at the start of a session to identify who is logged in, confirm the user's name and email, or check their verification status before proceeding with financial operations.
Returns: { "id": string, // Internal user ID "firstName": string, "lastName": string, "email": string, "phone": string, "verified": boolean, // Whether the account is fully verified (KYC) "haveTransactionPin": boolean, // Whether the user has set a transaction PIN "lastLoggedIn": string // ISO timestamp of last login }
Examples:
"Who am I logged in as?" -> call this tool
"Is my account verified?" -> check 'verified' field in response
"Do I have a transaction PIN set?" -> check 'haveTransactionPin' field
Error handling:
Returns error if API key is invalid or expired
Returns error if the account has been suspended
Inputs: no named parameters.
monei_get_banksGet BanksARead-onlyIdempotent
Returns the full list of Nigerian banks supported by Monei, including their bank codes.
Call this before any payout to a bank account if you do not already have the bank code. The bank code is required for both send_naira_to_bank and verify_bank_account.
Returns: { "banks": [ { "name": string, // Human-readable bank name (e.g. "Guaranty Trust Bank") "code": string, // Bank code to use in other tools (e.g. "058") } ] }
Examples:
"What banks do you support?" -> call this, show bank names
"What's the code for GTBank?" -> call this, find GTBank in list, return its code
User mentions a bank by name but you don't have its code -> call this first
Inputs: no named parameters.
monei_get_bill_historyGet Bill HistoryARead-onlyIdempotent
Returns the user's recent bill payment history across all categories: airtime, data, electricity, and cable TV.
Use this when the user wants to review past bill payments, check if a payment went through, or audit utility spending.
Returns: { "bills": [ { "id": string, "reference": string, "type": string, // "AIRTIME" | "MOBILEDATA" | "UTILITYBILLS" | "CABLEBILLS" "billerName": string, "customer": string, // Phone, meter number, or smartcard depending on type "amount": number, "status": string, // "PENDING" | "SUCCESS" | "FAILED" "token": string | null, // Electricity token for prepaid meters "units": string | null, "createdAt": string } ], "total": number, "page": number, "totalPages": number }
Examples:
"Show my recent bill payments" -> call this
"Did my electricity payment go through?" -> call this, filter by type=UTILITYBILLS
"When did I last buy MTN airtime?" -> call this, filter by type=AIRTIME
Inputs: no named parameters.
monei_get_bill_providersGet Bill ProvidersARead-onlyIdempotent
Returns available billers and packages for a given bill category.
Always call this before monei_pay_bill to get the correct biller codes and item codes needed for payment.
Routing:
UTILITYBILLS → returns all electricity providers (no billerName needed)
AIRTIME, MOBILEDATA, CABLEBILLS → requires billerName to filter (e.g. "MTN", "DSTV")
Args:
category (string): "AIRTIME" | "MOBILEDATA" | "CABLEBILLS" | "UTILITYBILLS"
billerName (string, optional): Network or provider to filter by. Required for non-electricity categories.
Returns for AIRTIME/MOBILEDATA/CABLEBILLS: { "providers": [ { "billerCode": string, // Use as 'biller' or 'disco' in monei_pay_bill "itemCode": string, // Use as 'itemCode' in monei_pay_bill (data/cable only) "name": string, // Human-readable package name "amount": number, // Fixed price (0 means user-specified amount) "validityPeriod": string | null } ] }
Returns for UTILITYBILLS: { "providers": [ { "name": string, // e.g. "Ikeja Electric" "code": string, // Use as 'disco' in monei_pay_bill "billerCode": string } ] }
Examples:
"What MTN data plans are available?" -> category: "MOBILEDATA", billerName: "MTN"
"What electricity providers do you support?" -> category: "UTILITYBILLS"
"Show me DSTV packages" -> category: "CABLEBILLS", billerName: "DSTV"
"Buy MTN airtime" -> category: "AIRTIME", billerName: "MTN" to get the biller code first
Inputs: category (required), billerName.
monei_get_evm_portfolioGet EVM PortfolioARead-onlyIdempotent
Returns the full token portfolio for the user's EVM wallet on a specific chain, including native token and all ERC-20 holdings with USD values.
Use this when the user wants a detailed breakdown of their crypto holdings on a specific EVM network (BSC, Polygon, Base, etc.). For a simple balance check, use monei_get_wallet instead.
Args:
chainId (number): The EVM chain to query. Common values: 56 (BSC), 137 (Polygon), 8453 (Base), 1 (Ethereum), 42161 (Arbitrum), 10 (Optimism).
Returns: { "walletAddress": string, "network": string, "totalPortfolioValueUSD": string, "nativeToken": { "name": string, "symbol": string, "balance": string, "balanceUSD": string, "priceUSD": string }, "tokens": [ { "name": string, "symbol": string, "contractAddress": string, "balance": string, "balanceUSD": string } ], "updatedAt": string }
Examples:
"What tokens do I have on BSC?" -> chainId: 56
"Show my Polygon holdings" -> chainId: 137
"What's my USDC balance on Base?" -> chainId: 8453, then check tokens array for USDC
Inputs: chainId (required).
monei_get_my_solana_addressGet My Solana AddressARead-onlyIdempotent
Returns the user's Solana wallet address so they can share it to receive SOL or SPL tokens.
Use this specifically when the user says "What's my Solana address?" or "I want to receive SOL/USDC on Solana" or "Share my Solana wallet". For full portfolio details, use monei_get_solana_portfolio instead.
Returns: { "address": string // Solana wallet address (base58 encoded) }
Examples:
"What's my Solana address?" -> call this, show address
"I want to receive USDC on Solana" -> call this, present the address to share
Inputs: no named parameters.
monei_get_offramp_quoteGet Offramp QuoteARead-only
Gets the current exchange rate and expected NGN payout for selling a specific amount of crypto.
Call this before monei_sell_crypto_for_naira to show the user the rate and how much NGN they will receive. The rate is live — it will be locked when the sell is actually initiated.
Args:
token (string): Token to sell — "USDT", "USDC", or "CNGN"
network (string): Network the token is on — "base", "polygon", "arbitrum-one", "bnb-smart-chain", "ethereum", "optimism", "lisk", "scroll", "starknet"
amount (number): Amount of the token to sell (e.g. 100 for 100 USDT)
fiat (string, optional): Fiat to receive — defaults to "NGN"
Returns: { "token": string, "network": string, "amount": number, "fiat": string, "rate": string | number // Exchange rate data returned by the API }
Examples:
"What's the rate for selling 100 USDT on Base?" -> token: "USDT", network: "base", amount: 100
"How much naira will I get for 50 USDC on Polygon?" -> token: "USDC", network: "polygon", amount: 50
Inputs: token (required), amount (required), network (required), fiat.
monei_get_solana_portfolioGet Solana PortfolioARead-onlyIdempotent
Returns the full token portfolio for the user's Solana wallet, including SOL balance and all SPL token holdings with USD values.
Use this when the user wants a breakdown of what they hold on Solana. For a simple balance check, use monei_get_wallet instead.
Args:
network (string, optional): 'mainnet-beta' (default), 'devnet', or 'testnet'.
Returns: { "address": string, // Solana wallet address "nativeBalance": string, // SOL balance "nativeBalanceUsd": number, "tokens": [ { "mintAddress": string, "name": string, "symbol": string, "balance": string, "valueUsd": number, "priceUsd": number } ], "totalValueUsd": number }
Examples:
"What's in my Solana wallet?" -> call with default network
"Do I have any USDC on Solana?" -> check tokens array for USDC symbol
"What's my SOL balance?" -> check nativeBalance field
Inputs: network.
monei_get_supported_networksGet Supported NetworksARead-onlyIdempotent
Returns all EVM blockchain networks supported by Monei, including chain IDs, native tokens, and block explorer URLs.
Use this when:
The user asks what chains or networks are supported
The user mentions a chain name and you need the chain ID to pass to another tool
You need to help the user pick a network before a swap or crypto send
Returns: { "networks": [ { "chainId": number, "name": string, // e.g. "BNB Smart Chain" "nativeToken": string, // e.g. "BNB" "blockExploreUrl": string, "isTestnet": boolean } ] }
Examples:
"What networks do you support?" -> call this
"What's the chain ID for Polygon?" -> call this, find Polygon in the list
Inputs: no named parameters.
monei_get_transactionGet TransactionARead-onlyIdempotent
Returns the full details of a single transaction by its reference string.
Use this when the user provides a specific transaction reference and wants to know its current status or details. For browsing recent activity, use monei_get_transaction_history instead.
Args:
reference (string): Transaction reference returned from a previous operation (e.g. "TXN_abc123xyz")
Returns: { "id": string, "reference": string, "type": string, "nature": string, "amount": number, "currency": string, "status": string, "narration": string | null, "metadata": object | null, "createdAt": string, "updatedAt": string }
Examples:
"What's the status of transaction TXN_abc123?" -> reference="TXN_abc123"
"Show me the details for ref_456xyz" -> reference="ref_456xyz"
Error handling:
Returns error if the reference does not exist or belongs to a different user
Inputs: reference (required).
monei_get_transaction_historyGet Transaction HistoryARead-onlyIdempotent
Returns the user's recent transaction history across all transaction types.
Use this when the user wants to review past activity, check if a payment went through, or audit recent sends, swaps, or bill payments.
Returns: { "transactions": [ { "id": string, "reference": string, "type": string, // e.g. "OFFRAMP", "SWAP", "TRANSFER", "BILL_PAYMENT" "nature": string, // e.g. "DEBIT" | "CREDIT" "amount": number, "currency": string, "status": string, // e.g. "COMPLETED", "PENDING", "FAILED" "narration": string, "createdAt": string } ] }
Examples:
"Show my recent transactions" -> call this
"Did my USDT sale go through?" -> call this, filter by type=OFFRAMP
"What did I spend money on recently?" -> call this, show narration fields
Inputs: no named parameters.
monei_get_walletGet WalletARead-onlyIdempotent
Returns the user's full wallet overview including NGN balance and all subwallets (EVM and Solana).
Call this at the start of any transaction flow to confirm the user has sufficient balance before attempting sends, swaps, or offramp. This is the single source of truth for all balances.
Args:
chainId (number, optional): If provided, filters the EVM portfolio to a specific chain.
Returns: { "nairaBalance": number, // NGN balance "subwallets": [ { "id": string, "type": "FIAT" | "CRYPTO", "currency": string, "balance": number, "chain": "EVM" | "SOLANA" | null, "publicAddress": string | null } ] }
Examples:
"What's my balance?" -> call this, show nairaBalance and subwallet balances
"Do I have enough USDT to send 100?" -> check the relevant subwallet balance
"What's my EVM wallet address?" -> find the subwallet with chain='EVM' and show publicAddress
Inputs: chainId.
monei_pay_billPay BillADestructive
Pays a utility bill, buys airtime, purchases a data bundle, or subscribes to cable TV.
Routes to the correct payment method based on the 'category' field:
AIRTIME → airtime top-up for a phone number
MOBILEDATA → data bundle purchase for a phone number
UTILITYBILLS → electricity payment by meter number
CABLEBILLS → cable TV subscription by smartcard number
Before calling:
Call monei_get_bill_providers to get valid biller codes and item codes
Confirm the user has sufficient NGN balance using monei_get_wallet
For data and cable, call monei_validate_bill first to confirm the customer details
Args depend on category:
AIRTIME:
phoneNumber (string): Phone to top up
biller (string): Biller code from monei_get_bill_providers
amount (number): Amount in NGN
MOBILEDATA:
phoneNumber (string): Phone to buy data for
biller (string): Biller code from monei_get_bill_providers
itemCode (string): Data bundle code from monei_get_bill_providers
UTILITYBILLS:
meterNumber (string): Electricity meter number
disco (string): Provider code from monei_get_bill_providers
amount (number): Amount to pay in NGN
CABLEBILLS:
smartcardNumber (string): Decoder smartcard/IUC number
biller (string): Provider code from monei_get_bill_providers
itemCode (string): Package code from monei_get_bill_providers
All categories also accept optional:
isSchedule (boolean): Set true to schedule for a later date
scheduleData: { executionDate, isRecurring?, recurrencePattern? }
saveBeneficiary (boolean): Save recipient for future use
beneficiaryName (string): Label for the saved beneficiary
Returns: { "id": string, "reference": string, "billerName": string, "customer": string, "amount": number, "status": string, // "PENDING" | "SUCCESS" | "FAILED" "token": string | null, // Electricity token (for prepaid meters) "units": string | null // Electricity units (for prepaid meters) }
Examples:
"Buy ₦1,000 MTN airtime for 08012345678" -> category: "AIRTIME"
"Get me 1GB MTN data for 08012345678" -> category: "MOBILEDATA"
"Pay ₦5,000 to my IKEDC meter 12345678901" -> category: "UTILITYBILLS"
"Subscribe DSTV Compact for smartcard 1234567890" -> category: "CABLEBILLS"
"Pay my DSTV every month on the 1st" -> include isSchedule: true, scheduleData with recurrence
Inputs: no named parameters.
monei_sell_crypto_for_nairaSell Crypto for NairaADestructive
Sells cryptocurrency and sends the NGN proceeds to a Nigerian bank account.
Handles the complete offramp flow: takes the token details, fiat currency, and destination bank account, then initiates the swap.
Before calling this tool:
Check the user has sufficient balance using monei_get_evm_portfolio or monei_get_wallet
Call monei_get_offramp_quote to show the user the current rate and expected NGN amount
Call monei_verify_bank_account to get the account holder name — pass that name as accountName
Show the verified account name, rate, and expected payout to the user and get explicit confirmation
Args:
amount (number): Amount of token to sell (e.g. 100 for 100 USDT)
token (string): Token to sell — "USDT", "USDC", or "CNGN"
network (string): Network the token is on — "base", "polygon", "arbitrum-one", "bnb-smart-chain", "ethereum", "optimism", "lisk", "scroll", "starknet"
fiatCurrency (string): Fiat to receive — defaults to "NGN"
bankCode (string): Destination bank code from monei_get_banks
accountNumber (string): Destination 10-digit bank account number
accountName (string): Account holder name from monei_verify_bank_account
Returns: { "id": string, "reference": string, // Use with monei_track_offramp to monitor progress "status": string, // Initial status e.g. "initiated" or "awaiting_deposit" "amounts": object, // Crypto and fiat amounts with exchange rate and fees "beneficiary": object, // Destination bank details "onChain": object, // Deposit address and on-chain details "timestamps": object }
After initiating, tell the user their reference and that settlement typically takes 5–10 minutes. Use monei_track_offramp to check progress.
Inputs: token (required), amount (required), network (required), bankCode (required), +3 more.
monei_send_crypto_evmSend Crypto (EVM)ADestructive
Sends cryptocurrency from the user's Monei EVM wallet to an external wallet address.
Handles both native tokens (ETH, BNB, MATIC) and ERC-20 tokens (USDT, USDC) with a single tool. Routing is automatic: if tokenAddress is provided it sends the ERC-20, otherwise it sends the native token.
Before calling:
Confirm sufficient balance using monei_get_evm_portfolio for the relevant chain
Ask for the user's transaction PIN if not already provided — never store or log it
Show the recipient address and amount to the user and get explicit confirmation before sending
Args:
to (string): Recipient EVM wallet address (0x...)
amount (string): Amount to send as a string to avoid floating point errors
chainId (number): Chain to send on (56=BSC, 137=Polygon, 8453=Base, 1=Ethereum, etc.)
tokenAddress (string, optional): ERC-20 contract address — omit for native tokens (ETH/BNB/MATIC)
transactionPin (string): User's 4-6 digit PIN — ask at runtime, never store
Returns: { "txHash": string, // Transaction hash to track on the block explorer "amount": string, "to": string, "chainId": number }
Examples:
"Send 0.01 ETH to 0x742d..." -> chainId: 1, amount: "0.01", no tokenAddress
"Send 100 USDT on BSC to 0x..." -> chainId: 56, amount: "100", tokenAddress: USDT contract on BSC
"Send 50 MATIC to 0x..." -> chainId: 137, amount: "50", no tokenAddress
Security: Never log or store the transactionPin.
Inputs: to (required), amount (required), chainId (required), transactionPin (required), +1 more.
monei_send_crypto_solanaSend Crypto (Solana)ADestructive
Sends cryptocurrency from the user's Monei Solana wallet to an external wallet address.
Handles both native SOL and SPL tokens (USDC, USDT on Solana) with a single tool. Routing is automatic: if tokenMintAddress is provided it sends the SPL token, otherwise it sends SOL.
Before calling:
Confirm sufficient balance using monei_get_solana_portfolio
Ask for the user's transaction PIN if not already provided — never store or log it
Show the recipient address and amount to the user and get explicit confirmation before sending
Args:
to (string): Recipient Solana wallet address (base58 encoded)
amount (string): Amount to send as a string
network (string, optional): "mainnet-beta" (default), "devnet", or "testnet"
tokenMintAddress (string, optional): SPL token mint address — omit to send native SOL
transactionPin (string): User's 4-6 digit PIN — ask at runtime, never store
Returns: { "signature": string, // Solana transaction signature "status": string, "amount": string, "token": string, // "SOL" or the SPL token symbol "to": string, "network": string }
Examples:
"Send 2 SOL to 5AH3..." -> amount: "2", no tokenMintAddress
"Send 50 USDC on Solana to 5AH3..." -> amount: "50", tokenMintAddress: USDC mint address on Solana
Security: Never log or store the transactionPin.
Inputs: to (required), amount (required), transactionPin (required), network, +1 more.
monei_send_naira_to_bankSend Naira to BankADestructive
Sends NGN from the user's Monei wallet to any Nigerian bank account.
Before calling this tool:
Confirm the user has sufficient NGN balance using monei_get_wallet
Call monei_verify_bank_account to get the account holder's name and show it to the user for confirmation
Ask for the user's transaction PIN if not already provided — never store or log it
Args:
amount (number): Amount in NGN to send (e.g. 20000 for ₦20,000)
bankCode (string): Bank code from monei_get_banks (e.g. "058" for GTBank)
accountNumber (string): 10-digit recipient bank account number
transactionPin (string): User's 4-6 digit transaction PIN — ask for this at runtime
narration (string, optional): Note for the transfer (max 100 characters)
Returns: { "reference": string, "status": string, // "PENDING" | "COMPLETED" | "FAILED" "amount": number, }
Examples:
"Send ₦20,000 to my GTBank account 0123456789" -> verify account first, then call with bankCode="058"
"Pay 5000 naira to account 0987654321 at UBA" -> verify, confirm name, then send
Security: Never log or store the transactionPin. Pass it directly to this call only.
Inputs: amount (required), bankCode (required), accountNumber (required), transactionPin (required), +1 more.
monei_send_naira_to_userSend Naira to Monei UserADestructive
Sends NGN to another Monei user identified by their email address or phone number.
This is faster than a bank transfer and works instantly between Monei users. Use this when the recipient is identified by email or phone rather than a bank account number.
Before calling:
Confirm sufficient NGN balance using monei_get_wallet
Ask for the user's transaction PIN if not provided — never store or log it
Args:
amount (number): Amount in NGN to send (e.g. 5000 for ₦5,000)
receiver (string): Recipient's registered Monei email or phone number (e.g. "john@gmail.com" or "08012345678")
transactionPin (string): User's 4-6 digit transaction PIN — ask for this at runtime
Returns: { "reference": string, "status": string, "amount": number, "currency": "NGN", "receiver": string, "createdAt": string }
Examples:
"Send ₦5,000 to john@gmail.com" -> receiver: "john@gmail.com"
"Transfer 2000 naira to 08012345678" -> receiver: "08012345678"
Error handling:
Returns error if the receiver is not a registered Monei user
Returns error if insufficient balance
Security: Never log or store the transactionPin. Pass it directly to this call only.
Inputs: amount (required), receiver (required), transactionPin (required).
monei_swap_tokens_evmSwap Tokens (EVM)ADestructive
Swaps one token for another on an EVM network using the user's Monei wallet.
Routing is automatic based on which fields you provide:
No tokenIn + tokenOut provided → Native to ERC-20 (e.g. ETH → USDC)
tokenIn + tokenOut both provided → ERC-20 to ERC-20 (e.g. USDC → USDT)
tokenIn provided + no tokenOut → ERC-20 to Native (e.g. USDC → ETH)
Before calling:
Confirm the user has sufficient balance using monei_get_evm_portfolio
If the user doesn't know contract addresses, look them up from their portfolio token list
Show the user what they are swapping and get confirmation before executing
Args:
amount (string): Amount to swap. Native-to-token: native amount (e.g. '0.1'). Token swaps: tokenIn amount.
chainId (number): Chain to swap on. 56=BSC, 137=Polygon, 8453=Base, 1=Ethereum, 42161=Arbitrum, 10=Optimism
tokenIn (string, optional): ERC-20 contract address of token to sell. Omit for native token sells.
tokenOut (string, optional): ERC-20 contract address of token to buy. Omit for native token buys.
slippageBps (number, optional): Slippage tolerance in basis points. Default 50 (0.5%).
Returns: { "txHash": string, // Transaction hash — can be checked on the block explorer "amount": string, "chainId": number, "route": string // Human-readable description of what was swapped }
Examples:
"Swap 0.1 ETH for USDC on Base" -> amount: "0.1", chainId: 8453, tokenOut: USDC contract
"Swap 100 USDC for USDT on BSC" -> amount: "100", chainId: 56, tokenIn: USDC contract, tokenOut: USDT contract
"Swap 50 USDC for BNB" -> amount: "50", chainId: 56, tokenIn: USDC contract, no tokenOut
Inputs: amount (required), chainId (required), tokenIn, tokenOut, +1 more.
monei_swap_tokens_solanaSwap Tokens (Solana)ADestructive
Swaps one token for another on Solana using the user's Monei wallet.
Routing is automatic based on which fields you provide:
outputMint provided + no inputMint → SOL to SPL token (e.g. SOL → USDC)
inputMint + outputMint both provided → SPL to SPL token (e.g. USDC → USDT)
inputMint provided + no outputMint → SPL token to SOL (e.g. USDC → SOL)
Before calling:
Confirm the user has sufficient balance using monei_get_solana_portfolio
Mint addresses for common tokens: USDC = EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, USDT = Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
Show the user what they are swapping and get confirmation before executing
Args:
amount (number|string): Amount to swap. SOL-to-token: number (e.g. 1). Token-to-SOL: string (e.g. '100'). Token-to-token: number.
inputMint (string, optional): Mint address of the SPL token to sell. Omit when selling SOL.
outputMint (string, optional): Mint address of the SPL token to buy. Omit when buying SOL.
slippageBps (number, optional): Slippage tolerance in basis points. Default 50 (0.5%).
Returns: { "signature": string, // Solana transaction signature "txUrl": string, // Explorer URL to view the transaction "route": string // Human-readable description of what was swapped }
Examples:
"Swap 1 SOL for USDC" -> amount: 1, outputMint: USDC mint, no inputMint
"Swap 100 USDC for SOL" -> amount: "100", inputMint: USDC mint, no outputMint
"Swap 50 USDC for USDT on Solana" -> amount: 50, inputMint: USDC mint, outputMint: USDT mint
Inputs: amount (required), inputMint, outputMint, slippageBps.
monei_track_offrampTrack OfframpARead-onlyIdempotent
Checks the current status of an offramp transaction by its reference.
Use this after monei_sell_crypto_for_naira to monitor settlement. Most transactions complete within 5–10 minutes. Poll every 30–60 seconds if the user is waiting.
Possible statuses: initiated, quote_created, awaiting_deposit, deposit_received, pending, processing, fiat_sent, completed, failed, cancelled, refunded, expired.
Args:
reference (string): The reference returned from monei_sell_crypto_for_naira
Returns: { "id": string, "reference": string, "status": string, "cryptoAmount": number, "fiatAmount": number, "exchangeRate": number, "fromCurrency": string, "toCurrency": string, "createdAt": string, "updatedAt": string, "completedAt": string | null }
Examples:
"What's the status of my USDT sale?" -> call with the reference from the sell
"Did my offramp complete?" -> check status field — "completed" means NGN has been sent
Inputs: reference (required).
monei_verify_bank_accountVerify Bank AccountARead-onlyIdempotent
Verifies a Nigerian bank account number and returns the account holder's name.
Always call this before sending naira to a bank account. Surfacing the account name to the user before they confirm the transaction prevents sending to the wrong account.
Args:
accountNumber (string): 10-digit Nigerian bank account number
bankCode (string): Bank code from monei_get_banks (e.g. "058" for GTBank)
Returns: { "accountName": string, "accountNumber": string, "bankCode": string }
Examples:
Before sending to 0123456789 at GTBank -> call this with accountNumber="0123456789", bankCode="058"
User says "send to my GTBank account 0123456789" -> verify first, show account name, confirm before sending
Error handling:
Returns error if the account number does not exist at the given bank
Returns error if the bank code is invalid (call monei_get_banks to find valid codes)
Inputs: bankCode (required), accountNumber (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Each tool maps to a distinct resource/action pair—wallet balances, EVM/Solana portfolios, sends, swaps, offramp, bank lookups, and bill payments. Status-checking tools are clearly separated by domain (deposit link, offramp, transaction, bill history), and descriptions explicitly point to the right tool for each scenario. No two tools appear interchangeable.
All tools share the consistent monei_ prefix and follow a predictable snake_case verb_noun pattern (get_, send_, swap_, pay_, verify_). Minor verb variation like check_deposit_status versus track_offramp is semantically appropriate and does not break the naming convention.
24 tools is at the upper end of the 16–25 heavy band, which feels like a lot for a single MCP server. The broad fintech scope—NGN wallet, EVM and Solana crypto operations, offramp, and bill payments—justifies much of the surface, but splitting into wallet/crypto/bills sub-servers would improve focus.
Core lifecycles are well covered: deposits generate and check, sends cover bank/user and EVM/Solana, offramp has quote/execute/track, and bills have providers/pay/history. However, monei_pay_bill instructs agents to call monei_validate_bill before data and cable payments, but that tool is not exposed in the server—a concrete dead-end in the bill-payment flow. A swap quote/preview tool is also absent, though slippage defaults soften that gap.
Maintenance
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server to provide AI agents money functionalities via Nostr and Cashu.661 npm17MIT
- AlicenseBqualityBmaintenanceMCP server for Starling Bank API integration, enabling AI agents to manage accounts, view transactions, and send payments via natural language.24119 npm8MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that lets any AI agent operate a wallet directly on-chain: create wallets, send, swap, bridge, and deploy contracts across EVM and Bitcoin networks.1MIT

moolre-mcpofficial
FlicenseBqualityDmaintenanceMCP server that exposes Moolre's API as 24 tools for AI agents, enabling account management, transfers, payments, SMS, and WhatsApp operations.24-