Advertise
MCP.so
Sign In

MCP Flutterwave

@bajoski34

RepositoryHomepage

Basic information

Category

Other

License

MIT

Transports

stdio

Author

bajoski34

Submitted by

Abraham J. Olaobaju

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

1

What Flutterwave API version does this server use?

It currently targets the Flutterwave v3 API. Support for v4 is coming soon.

2

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.

3

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.

4

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.

5

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

Soar Flight Booking MCP

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

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.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

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K
Advertise