Mcp Flutterwave
Connects Claude to Flutterwave's payment infrastructure with nine tools covering the full transaction lifecycle. You can confirm transaction status, resend failed webhooks, create and disable payment links, manage transfers and beneficiaries, retry failed payments, and pull transaction timelines. Ships with MCP-UI support that renders Flutterwave-branded cards for transactions, payment links, and transfers right in the client. Requires a Flutterwave secret key and lets you scope which tools to enable via command line args. Reach for this when you're building payment workflows, debugging transaction issues, or need AI-assisted customer support for Flutterwave payments without switching contexts.
- GitHub stars
- 2
- tools
- 38
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Oct 6, 2025
Tools
38 toolsPublic tool metadata for what this MCP can expose to an agent.
create_checkoutCreate a hosted Flutterwave payment link
Create a hosted Flutterwave payment link
No parameter schema in public metadata yet.
disable_checkoutDisable an existing payment link
Disable an existing payment link
No parameter schema in public metadata yet.
charge_cardDirectly charge a debit or credit card — handles PIN, AVS, 3DS, and OTP flows
Directly charge a debit or credit card — handles PIN, AVS, 3DS, and OTP flows
No parameter schema in public metadata yet.
charge_bank_accountDebit a bank account (NGN / GHS)
Debit a bank account (NGN / GHS)
No parameter schema in public metadata yet.
charge_mobile_moneyMobile money — Ghana, Uganda, Rwanda, Zambia, Francophone Africa
Mobile money — Ghana, Uganda, Rwanda, Zambia, Francophone Africa
No parameter schema in public metadata yet.
charge_mpesaM-Pesa charge (KES)
M-Pesa charge (KES)
No parameter schema in public metadata yet.
charge_ussdUSSD charge (NGN)
USSD charge (NGN)
No parameter schema in public metadata yet.
validate_chargeValidate a pending charge using OTP
Validate a pending charge using OTP
No parameter schema in public metadata yet.
read_transactionGet transaction details by ID
Get transaction details by ID
No parameter schema in public metadata yet.
read_transaction_with_referenceGet transaction details by `tx_ref`
Get transaction details by `tx_ref`
No parameter schema in public metadata yet.
read_transaction_timelineView the event timeline for a transaction
View the event timeline for a transaction
No parameter schema in public metadata yet.
resend_transaction_webhookResend a failed webhook
Resend a failed webhook
No parameter schema in public metadata yet.
create_transferInitiate a bank transfer
Initiate a bank transfer
No parameter schema in public metadata yet.
create_beneficiarySave a new transfer beneficiary
Save a new transfer beneficiary
No parameter schema in public metadata yet.
list_beneficiariesList all saved beneficiaries
List all saved beneficiaries
No parameter schema in public metadata yet.
create_payment_planCreate a recurring payment plan
Create a recurring payment plan
No parameter schema in public metadata yet.
get_payment_plansList payment plans with optional filters
List payment plans with optional filters
No parameter schema in public metadata yet.
create_virtual_accountCreate a dedicated bank account number for a customer (NGN or GHS)
Create a dedicated bank account number for a customer (NGN or GHS)
No parameter schema in public metadata yet.
get_virtual_accountRetrieve a virtual account's status and details by `order_ref`
Retrieve a virtual account's status and details by `order_ref`
No parameter schema in public metadata yet.
update_virtual_accountLink or update the BVN on an NGN virtual account
Link or update the BVN on an NGN virtual account
No parameter schema in public metadata yet.
list_virtual_account_bulkList all accounts created in a bulk batch
List all accounts created in a bulk batch
No parameter schema in public metadata yet.
get_bill_categoriesList available bill categories (AIRTIME, CABLEBILLS, UTILITYBILLS, etc.)
List available bill categories (AIRTIME, CABLEBILLS, UTILITYBILLS, etc.)
No parameter schema in public metadata yet.
get_bill_providersList billers/providers for a category
List billers/providers for a category
No parameter schema in public metadata yet.
get_bill_itemsList payable items for a specific biller
List payable items for a specific biller
No parameter schema in public metadata yet.
validate_bill_customerValidate a customer account before payment (meter number, smartcard, etc.)
Validate a customer account before payment (meter number, smartcard, etc.)
No parameter schema in public metadata yet.
pay_billSubmit a bill payment
Submit a bill payment
No parameter schema in public metadata yet.
get_bill_statusCheck payment status and retrieve prepaid tokens (electricity)
Check payment status and retrieve prepaid tokens (electricity)
No parameter schema in public metadata yet.
request_fx_quoteSubmit a Request For Quote (RFQ) for a currency conversion
Submit a Request For Quote (RFQ) for a currency conversion
No parameter schema in public metadata yet.
get_fx_quotePoll the quote status — wait for READY before trading
Poll the quote status — wait for READY before trading
No parameter schema in public metadata yet.
initiate_fx_tradeLock in a READY quote and execute the trade
Lock in a READY quote and execute the trade
No parameter schema in public metadata yet.
get_fx_tradePoll trade status until SETTLED or FAILED
Poll trade status until SETTLED or FAILED
No parameter schema in public metadata yet.
initiate_bvn_verificationBegin a BVN identity check — returns a single-use customer consent URL
Begin a BVN identity check — returns a single-use customer consent URL
No parameter schema in public metadata yet.
get_bvn_detailsRetrieve full BVN identity data after consent is given
Retrieve full BVN identity data after consent is given
No parameter schema in public metadata yet.
resolve_bank_accountLook up the account holder name for a bank account number
Look up the account holder name for a bank account number
No parameter schema in public metadata yet.
verify_card_binLook up card brand, type, issuer, and country from the first 6 digits
Look up card brand, type, issuer, and country from the first 6 digits
No parameter schema in public metadata yet.
get_stablecoin_feeGet the transfer fee before sending — shows net amount the recipient receives
Get the transfer fee before sending — shows net amount the recipient receives
No parameter schema in public metadata yet.
send_stablecoinSend USDC or USDT to a Polygon wallet address
Send USDC or USDT to a Polygon wallet address
No parameter schema in public metadata yet.
convert_to_stablecoinConvert NGN or USD fiat balance into USDC or USDT
Convert NGN or USD fiat balance into USDC or USDT
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
FLW_SECRET_KEY*secretYour SECRET API key for the service
Readme
mcp-flutterwave
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.
Details
- Repository
- github.com/bajoski34/mcp-flutterwave
- Package
mcp-flutterwave- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active