How do I install the mcp flutterwave mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

The recorded environment keys are `FLW_SECRET_KEY`, `FLW_ENCRYPTION_KEY`, `ANTHROPIC_API_KEY`. Keep credentials outside committed files and confirm the configuration required by your installed version.

SSyncDev

Start a project

MCP Flutterwave MCP Server

MCP Server to interact with Flutterwave APIs.

Remote serverstreamable-http

What is the MCP Flutterwave MCP Server?

MCP Server to interact with Flutterwave APIs.

What you get

An MCP (Model Context Protocol) server that enables AI assistants to interact with the Flutterwave API — create payment links, charge customers directly, manage transfers, collect via virtual accounts, pay bills, and more.

Checkout — — Create hosted payment links and disable them
Direct Charges — — Charge customers via card, bank account, mobile money, M-Pesa, or USSD
Full card auth flow — — PIN, AVS (Address Verification), 3D Secure redirect, and OTP validation all handled automatically
Charge Validation — — Validate OTP-based charges with a dedicated tool
Transactions — — Verify by ID or reference, view event timeline, resend failed webhooks
Transfers — — Initiate single transfers, manage beneficiaries

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
create_checkout	Create a hosted Flutterwave payment link
disable_checkout	Disable an existing payment link
charge_card	Directly charge a debit or credit card — handles PIN, AVS, 3DS, and OTP flows
charge_bank_account	Debit a bank account (NGN / GHS)
charge_mobile_money	Mobile money — Ghana, Uganda, Rwanda, Zambia, Francophone Africa
charge_mpesa	M-Pesa charge (KES)
charge_ussd	USSD charge (NGN)
validate_charge	Validate a pending charge using OTP
read_transaction	Get transaction details by ID
read_transaction_with_reference	Get transaction details by tx_ref
read_transaction_timeline	View the event timeline for a transaction
resend_transaction_webhook	Resend a failed webhook
create_transfer	Initiate a bank transfer
create_beneficiary	Save a new transfer beneficiary
list_beneficiaries	List all saved beneficiaries
create_payment_plan	Create a recurring payment plan
get_payment_plans	List payment plans with optional filters
create_virtual_account	Create a dedicated bank account number for a customer (NGN or GHS)
get_virtual_account	Retrieve a virtual account's status and details by order_ref
update_virtual_account	Link or update the BVN on an NGN virtual account
list_virtual_account_bulk	List all accounts created in a bulk batch
get_bill_categories	List available bill categories (AIRTIME, CABLEBILLS, UTILITYBILLS, etc.)
get_bill_providers	List billers/providers for a category
get_bill_items	List payable items for a specific biller
validate_bill_customer	Validate a customer account before payment (meter number, smartcard, etc.)
pay_bill	Submit a bill payment
get_bill_status	Check payment status and retrieve prepaid tokens (electricity)
request_fx_quote	Submit a Request For Quote (RFQ) for a currency conversion
get_fx_quote	Poll the quote status — wait for READY before trading
initiate_fx_trade	Lock in a READY quote and execute the trade
get_fx_trade	Poll trade status until SETTLED or FAILED
initiate_bvn_verification	Begin a BVN identity check — returns a single-use customer consent URL
get_bvn_details	Retrieve full BVN identity data after consent is given
resolve_bank_account	Look up the account holder name for a bank account number
verify_card_bin	Look up card brand, type, issuer, and country from the first 6 digits
get_stablecoin_fee	Get the transfer fee before sending — shows net amount the recipient receives
send_stablecoin	Send USDC or USDT to a Polygon wallet address
convert_to_stablecoin	Convert NGN or USD fiat balance into USDC or USDT

How to install the MCP Flutterwave MCP Server

{
  "mcpServers": {
    "flutterwave": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "FLW_SECRET_KEY=YOUR_SECRET_KEY",
        "-e",
        "FLW_ENCRYPTION_KEY=YOUR_ENCRYPTION_KEY",
        "ghcr.io/bajoski34/mcp-flutterwave:latest"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use MCP Flutterwave to Checkout.”
“Use MCP Flutterwave to Transactions.”
“Use MCP Flutterwave to Transfers.”

Frequently asked questions

MCP Server to interact with Flutterwave APIs. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the MCP Flutterwave MCP Server

Stripe

Official

Access Stripe billing and payment tools through its MCP server. Connect with OAuth or a supported agent API key and choose the intended account.

Payments & CommerceRemoteTypeScript★ 1.1k

Git

Official

Local repository surgery — status, diffs, commits, branches and history for any repo on disk.

Developer ToolsPython★ 63.0k

ONCE — AI Agent Huddle

Track GitHub issue and Stripe test-payment outcomes; recover uncertain supported actions.

Payments & CommerceRemote

AgentShield

Smart contract security for AI agents — verify, monitor, freeze, x402 payments

Payments & Commerce

Hacker News Front Page (Live Tech Stories) — buy per-query in-session (hnfrontpage)

Hacker News front page: top stories, points, links. Register in-session — free testnet funds.