mcp-flutterwave

Name: mcp-flutterwave
Author: bajoski34

@bajoski34

Repository Homepage

About mcp-flutterwave

MCP Server to interact with flutterwave

Basic information

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.

Comments

More Other MCP servers

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K