Skip to main content
Glama

@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

MONEI_API_KEY

Yes (stdio)

—

Your Monei API key. Not required in HTTP/SSE mode — pass via Authorization: Bearer header instead

MONEI_TRANSPORT

No

stdio

Transport mode: stdio, http, or sse

PORT

No

3000

HTTP/SSE server port

MONEI_TIMEOUT

No

30000

Request timeout in milliseconds. Max 120000

MONEI_API_URL

No

https://api.monei.cc

Override the live API base URL


Transport modes

Mode

Use case

How to start

stdio

Claude Desktop, local Cursor

Default — just run the server

http

Custom agents, API integrations

MONEI_TRANSPORT=http node dist/index.js

sse

Cursor remote, Claude.ai

MONEI_TRANSPORT=sse node dist/index.js

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

chainId

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

Generates a payment link the user can open to deposit NGN.

Inputs:

Field

Type

Required

Description

amount

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

reference

string

Yes

Reference from monei_generate_deposit_link

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

amount

number

Yes

Amount in NGN

bankCode

string

Yes

Bank code from monei_get_banks

accountNumber

string

Yes

10-digit account number

transactionPin

string

Yes

User's 4-6 digit transaction PIN

narration

string

No

Transfer description

Always call monei_verify_bank_account first 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

receiver

string

Yes

Recipient email or phone number

amount

number

Yes

Amount in NGN

transactionPin

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

accountNumber

string

Yes

10-digit bank account number

bankCode

string

Yes

Bank code from monei_get_banks

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

to

string

Yes

Recipient wallet address (0x...)

amount

string

Yes

Amount to send as a string (e.g. "0.1")

chainId

number

Yes

Chain ID

tokenAddress

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

to

string

Yes

Recipient Solana address

amount

string

Yes

Amount to send

tokenMintAddress

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

amount

string

Yes

Amount to swap

chainId

number

Yes

Chain ID

tokenIn

string

No

ERC-20 contract to sell. Omit when selling native token

tokenOut

string

No

ERC-20 contract to buy. Omit when buying native token

slippageBps

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

amount

number|string

Yes

Amount to swap

inputMint

string

No

Mint address of token to sell. Omit when selling SOL

outputMint

string

No

Mint address of token to buy. Omit when buying SOL

slippageBps

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

token

string

Yes

Token to sell: USDT, USDC, or CNGN

network

string

Yes

Network: base, polygon, arbitrum-one, bnb-smart-chain, ethereum, optimism

amount

number

Yes

Amount of token to sell

fiat

string

No

Fiat to receive. Default: NGN

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

amount

number

Yes

Amount of token to sell

token

string

Yes

Token to sell: USDT, USDC, or CNGN

network

string

Yes

Network the token is on

fiatCurrency

string

No

Default: NGN

bankCode

string

Yes

Destination bank code

accountNumber

string

Yes

Destination account number

accountName

string

Yes

Account holder name from monei_verify_bank_account

Returns:

{
  "reference": "string",
  "status": "string",
  "amounts": { "crypto": {}, "fiat": {}, "exchangeRate": 0, "totalFee": 0 },
  "onChain": { "depositAddress": "string" }
}

Call monei_get_offramp_quote first to show the rate. Call monei_verify_bank_account to get the accountName. 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

reference

string

Yes

Reference from monei_sell_crypto_for_naira

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

category

string

Yes

AIRTIME, MOBILEDATA, CABLEBILLS, or UTILITYBILLS

billerName

string

Conditional

Required for non-electricity categories (e.g. MTN, DSTV)

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

AIRTIME

phoneNumber, biller, amount

MOBILEDATA

phoneNumber, biller, itemCode

UTILITYBILLS

meterNumber, disco, amount

CABLEBILLS

smartcardNumber, biller, itemCode

All categories also accept isSchedule, scheduleData, saveBeneficiary, beneficiaryName.

Always call monei_get_bill_providers first to get valid biller and itemCode values.

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

reference

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_KEY is set in claude_desktop_config.json

  • Restart 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_ENV matches the environment your key belongs to (sandbox vs live)

  • In HTTP/SSE mode, check the Authorization: Bearer header 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 /sse connection 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 of 100 for an amount)

  • All amount fields use z.coerce.number() so string numbers are accepted

  • If 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 tools
monei_check_deposit_statusCheck Deposit StatusA
Read-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_get_accountGet AccountA
Read-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 BanksA
Read-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 HistoryA
Read-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 ProvidersA
Read-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 PortfolioA
Read-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 AddressA
Read-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 QuoteA
Read-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 PortfolioA
Read-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 NetworksA
Read-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 TransactionA
Read-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 HistoryA
Read-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 WalletA
Read-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 BillA
Destructive

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:

  1. Call monei_get_bill_providers to get valid biller codes and item codes

  2. Confirm the user has sufficient NGN balance using monei_get_wallet

  3. 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 NairaA
Destructive

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:

  1. Check the user has sufficient balance using monei_get_evm_portfolio or monei_get_wallet

  2. Call monei_get_offramp_quote to show the user the current rate and expected NGN amount

  3. Call monei_verify_bank_account to get the account holder name — pass that name as accountName

  4. 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)A
Destructive

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:

  1. Confirm sufficient balance using monei_get_evm_portfolio for the relevant chain

  2. Ask for the user's transaction PIN if not already provided — never store or log it

  3. 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)A
Destructive

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:

  1. Confirm sufficient balance using monei_get_solana_portfolio

  2. Ask for the user's transaction PIN if not already provided — never store or log it

  3. 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 BankA
Destructive

Sends NGN from the user's Monei wallet to any Nigerian bank account.

Before calling this tool:

  1. Confirm the user has sufficient NGN balance using monei_get_wallet

  2. Call monei_verify_bank_account to get the account holder's name and show it to the user for confirmation

  3. 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 UserA
Destructive

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:

  1. Confirm sufficient NGN balance using monei_get_wallet

  2. 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:

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)A
Destructive

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:

  1. Confirm the user has sufficient balance using monei_get_evm_portfolio

  2. If the user doesn't know contract addresses, look them up from their portfolio token list

  3. 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)A
Destructive

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:

  1. Confirm the user has sufficient balance using monei_get_solana_portfolio

  2. Mint addresses for common tokens: USDC = EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, USDT = Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB

  3. 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 OfframpA
Read-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 AccountA
Read-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

    A4.1/5.0

    Scored across 24 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers