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

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.

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.

Comments

Basic information

More Other MCP servers

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K