mcp-flutterwave
@bajoski34
About mcp-flutterwave
MCP Server to interact with flutterwave
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"flutterwave": {
"command": "npx",
"args": [
"-y",
"mcp-flutterwave",
"--tools=checkout.create",
"--secret-key=FLW_SECRET_KEY"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is 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. It currently targets the Flutterwave v3 API.
How to use mcp-flutterwave?
Install globally via npm, run with npx mcp-flutterwave --tools=all, or run as a Docker container. Configure the server by setting the environment variables FLW_SECRET_KEY and FLW_ENCRYPTION_KEY. The server communicates over stdio and must be launched by an MCP client (e.g., Claude Desktop).
Key features of mcp-flutterwave
- Create and disable hosted payment links
- Direct card, bank, mobile money, M-Pesa, and USSD charges
- Automated multi-step card authorization (PIN, AVS, 3DS, OTP)
- Verify transactions, resend webhooks, manage beneficiaries
- Generate static or dynamic NGN/GHS virtual accounts
- Pay airtime, data, cable TV, and electricity bills (Nigeria)
- FX trade (RFQ then trade) and stablecoin transfers (USDC/USDT)
- BVN verification, bank account resolution, card BIN lookup
Use cases of mcp-flutterwave
- An AI customer support agent creates payment links and validates charges for users.
- An automated billing assistant pays recurring utility bills and checks payment status.
- A financial assistant initiates FX conversions or sends stablecoins from a balance.
- A verification tool resolves bank account names and verifies BVN identity.
- A virtual account manager creates and updates dedicated bank accounts for customers.
FAQ from mcp-flutterwave
What Flutterwave API version does this server use?
It currently targets the Flutterwave v3 API. Support for v4 is coming soon.
What are the runtime requirements?
Node.js 20 or later is required for the npm/npx installation. The server communicates over stdio and must be launched by an MCP client.
How do I handle card charges that require additional verification?
The charge_card tool automatically detects the required authorization mode (PIN, AVS, 3DS redirect, or OTP) and tells the AI assistant what step to take next.
Are virtual accounts available for both NGN and GHS?
Yes, virtual accounts can be created for NGN (Nigeria) and GHS (Ghana). NGN accounts require a BVN for static (reusable) accounts; GHS accounts do not.
Is the bill payment feature limited to a specific country?
Yes, bill payments are currently available for Nigeria only (country: NG). Supported categories include airtime, data, cable TV, electricity, internet, taxes, and more.
Frequently asked questions
What Flutterwave API version does this server use?
It currently targets the Flutterwave v3 API. Support for v4 is coming soon.
What are the runtime requirements?
Node.js 20 or later is required for the npm/npx installation. The server communicates over stdio and must be launched by an MCP client.
How do I handle card charges that require additional verification?
The `charge_card` tool automatically detects the required authorization mode (PIN, AVS, 3DS redirect, or OTP) and tells the AI assistant what step to take next.
Are virtual accounts available for both NGN and GHS?
Yes, virtual accounts can be created for NGN (Nigeria) and GHS (Ghana). NGN accounts require a BVN for static (reusable) accounts; GHS accounts do not.
Is the bill payment feature limited to a specific country?
Yes, bill payments are currently available for Nigeria only (`country: NG`). Supported categories include airtime, data, cable TV, electricity, internet, taxes, and more.
Basic information
More Other MCP servers
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Nginx UI
0xJackyYet another WebUI for Nginx
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Comments