MCP Flutterwave

@bajoski34

Basic information

About MCP Flutterwave

MCP Server to interact with flutterwave

MCP 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"
      ]
    }
  }
}

MCP Flutterwave tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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.

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.

Comments

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.