E-commerce & Retail · Finance

MCP Flutterwave logo

MCP Flutterwave

bajoski34/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.

Install

npm install -g mcp-flutterwave

Client configuration

{
  "mcpServers": {
    "flutterwave": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "FLW_SECRET_KEY=YOUR_SECRET_KEY",
        "-e",
        "FLW_ENCRYPTION_KEY=YOUR_ENCRYPTION_KEY",
        "ghcr.io/bajoski34/mcp-flutterwave:latest"
      ]
    }
  }
}

Environment variables

FLW_SECRET_KEYFLW_ENCRYPTION_KEYANTHROPIC_API_KEY
Category
E-commerce & Retail, Finance
License
MIT
Updated
Oct 6, 2026

About MCP Flutterwave

Also ships with a built-in web app that connects to the MCP server and lets you talk to a Claude-powered Flutterwave assistant directly in your browser.

Features

  • Checkout — Create hosted payment links and disable them

  • Direct Charges — Charge customers via card, bank account, mobile money, M-Pesa, or USSD

  • Full card auth flow — PIN, AVS (Address Verification), 3D Secure redirect, and OTP validation all handled automatically

  • Charge Validation — Validate OTP-based charges with a dedicated tool

  • Transactions — Verify by ID or reference, view event timeline, resend failed webhooks

  • Transfers — Initiate single transfers, manage beneficiaries

  • Payment Plans — Create and retrieve subscription plans

  • Virtual Accounts — Generate dedicated account numbers for NGN and GHS bank transfer collection (static or dynamic)

  • Bill Payments — Pay airtime, data, cable TV, electricity, internet bills and more (Nigeria)

  • FX Trade — Convert between NGN, GHS, and USD with live quotes (RFQ → trade in two steps)

Tools (38)

  • create_checkout

    Create a hosted Flutterwave payment link

  • disable_checkout

    Disable an existing payment link

  • charge_card

    Directly charge a debit or credit card — handles PIN, AVS, 3DS, and OTP flows

  • charge_bank_account

    Debit a bank account (NGN / GHS)

  • charge_mobile_money

    Mobile money — Ghana, Uganda, Rwanda, Zambia, Francophone Africa

  • charge_mpesa

    M-Pesa charge (KES)

  • charge_ussd

    USSD charge (NGN)

  • validate_charge

    Validate a pending charge using OTP

  • read_transaction

    Get transaction details by ID

  • read_transaction_with_reference

    Get transaction details by tx_ref

  • read_transaction_timeline

    View the event timeline for a transaction

  • resend_transaction_webhook

    Resend a failed webhook

  • create_transfer

    Initiate a bank transfer

  • create_beneficiary

    Save a new transfer beneficiary

  • list_beneficiaries

    List all saved beneficiaries

  • create_payment_plan

    Create a recurring payment plan

  • get_payment_plans

    List payment plans with optional filters

  • create_virtual_account

    Create a dedicated bank account number for a customer (NGN or GHS)

  • get_virtual_account

    Retrieve a virtual account's status and details by order_ref

  • update_virtual_account

    Link or update the BVN on an NGN virtual account

  • list_virtual_account_bulk

    List all accounts created in a bulk batch

  • get_bill_categories

    List available bill categories (AIRTIME, CABLEBILLS, UTILITYBILLS, etc.)

  • get_bill_providers

    List billers/providers for a category

  • get_bill_items

    List payable items for a specific biller

  • validate_bill_customer

    Validate a customer account before payment (meter number, smartcard, etc.)

  • pay_bill

    Submit a bill payment

  • get_bill_status

    Check payment status and retrieve prepaid tokens (electricity)

  • request_fx_quote

    Submit a Request For Quote (RFQ) for a currency conversion

  • get_fx_quote

    Poll the quote status — wait for READY before trading

  • initiate_fx_trade

    Lock in a READY quote and execute the trade

  • get_fx_trade

    Poll trade status until SETTLED or FAILED

  • initiate_bvn_verification

    Begin a BVN identity check — returns a single-use customer consent URL

  • get_bvn_details

    Retrieve full BVN identity data after consent is given

  • resolve_bank_account

    Look up the account holder name for a bank account number

  • verify_card_bin

    Look up card brand, type, issuer, and country from the first 6 digits

  • get_stablecoin_fee

    Get the transfer fee before sending — shows net amount the recipient receives

  • send_stablecoin

    Send USDC or USDT to a Polygon wallet address

  • convert_to_stablecoin

    Convert NGN or USD fiat balance into USDC or USDT

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Stripe Agent Toolkit logo

Stripe Agent Toolkit

stripe/agent-toolkit

677

It contains a collection of SDKs to help you integrate Stripe with LLMs and agent frameworks, including.

E-commerce & Retail
Uber Eats MCP Server logo

Uber Eats MCP Server

ericzakariasson/uber-eats-mcp-server

161

The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external tools.

E-commerce & Retail
MCP Odoo logo

MCP Odoo

tuanle96/mcp-odoo

95

ERPipe is the managed Odoo MCP gateway from the maintainer of erpipe-org/mcp-odoo, formerly tuanle96/mcp-odoo; the Python project remains the self-hosted server.

E-commerce & Retail
paypal logo

paypal

paypal/agent-toolkit

59

The PayPal Agent Toolkit enables popular agent frameworks including OpenAI's Agent SDK, LangChain, Vercel's AI SDK, and Model Context Protocol (MCP) to integrate with PayPal APIs through function calling. It includes support for TypeScript and is built on top of PayPal APIs and the PayPal SDKs.

E-commerce & Retail
Square MCP Server logo

Square MCP Server

square/square-mcp-server

44

This project follows the Model Context Protocol standard, allowing AI assistants to interact with Square's connect API.

E-commerce & Retail
MCP Sse Demo logo

MCP Sse Demo

cnych/mcp-sse-demo

43

Develops an intelligent mall SSE service based on the MCP protocol, integrating product queries, inventory management and order processing, and enabling real-time data interaction via the SSE protocol to enhance the shopping experience.

E-commerce & Retail