Flutterwave MCP Server

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. Its 38 documented tools cover charge, account, bill, transaction. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-11 · ★ 3 · #465 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Flutterwave

before you install - you'll need

Set FLW_SECRET_KEY, FLW_ENCRYPTION_KEY, ANTHROPIC_API_KEY before connecting.

Claude Code

claude mcp add bajoski34-mcp-flutterwave -- npx -y mcp-flutterwave

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "bajoski34-mcp-flutterwave": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-flutterwave"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mcp-flutterwave - unscoped; check the name against the project README before installing

registry namespace io.github.bajoski34 is GitHub-verified and matches the repo owner

03 · What Flutterwave can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a hosted Flutterwave payment link, validate a pending charge using OTP, get transaction details by ID, and get transaction details by tx_ref.

Capability map

Tools grouped from the project's README - what Flutterwave lets an agent do.

Charge

6 tools - e.g. Directly charge a debit or credit card - handles PIN, AVS, 3DS, and OTP flows; Debit a bank account (NGN / GHS); Mobile money - Ghana, Uganda, Rwanda, Zambia, Francophone Africa

charge_card · charge_bank_account · charge_mobile_money · charge_mpesa · charge_ussd · validate_charge

Bill

5 tools - e.g. List available bill categories (AIRTIME, CABLEBILLS, UTILITYBILLS, etc.); List billers/providers for a category; List payable items for a specific biller

get_bill_categories · get_bill_providers · get_bill_items · pay_bill · get_bill_status

Transaction

4 tools - e.g. Get transaction details by ID; Get transaction details by tx_ref; View the event timeline for a transaction

read_transaction · read_transaction_with_reference · read_transaction_timeline · resend_transaction_webhook

read & search

4 tools - e.g. List all saved beneficiaries; Poll the quote status - wait for READY before trading; Poll trade status until SETTLED or FAILED

list_beneficiaries · get_fx_quote · get_fx_trade · get_bvn_details

Virtual

4 tools - e.g. Create a dedicated bank account number for a customer (NGN or GHS); Retrieve a virtual account's status and details by order_ref; Link or update the BVN on an NGN virtual account

create_virtual_account · get_virtual_account · update_virtual_account · list_virtual_account_bulk

create & write

3 tools - e.g. Create a hosted Flutterwave payment link; Initiate a bank transfer; Save a new transfer beneficiary

create_checkout · create_transfer · create_beneficiary

Stablecoin

3 tools - e.g. Get the transfer fee before sending - shows net amount the recipient receives; Send USDC or USDT to a Polygon wallet address; Convert NGN or USD fiat balance into USDC or USDT

get_stablecoin_fee · send_stablecoin · convert_to_stablecoin

Payment

2 tools - e.g. Create a recurring payment plan; List payment plans with optional filters

create_payment_plan · get_payment_plans

Latest releases

1.4.1 · 2026-06-17

update and version bump

1.4.0 · 2026-06-17

New Features added · Stablecoin · Card. USSD, Fawry, and more Charge · KYC, KYB verification · MCP App to test features with Claude.

1.3.2 · 2025-11-08

Added Payout/Transfer initiation · Transfer Beneficiary Management [Listing and Creating Beneficiaries]

04 · Who maintains Flutterwave

mcp-flutterwave is maintained by bajoski34. It's the only MCP server we track from this author; the repo dates to Mar 2025.

05 · Facts

repository: github.com/bajoski34/mcp-flutterwave
category: other - ranked #465 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-06-17)
registry: io.github.bajoski34/mcp-flutterwave (active, first published 2025-10-06)
packages: npm:mcp-flutterwave

06 · Flutterwave FAQ

Is Flutterwave still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-11 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Flutterwave do?

With this server connected, an agent can create a hosted Flutterwave payment link, validate a pending charge using OTP, get transaction details by ID, and get transaction details by tx_ref.

How do I install Flutterwave?

Run `npx -y mcp-flutterwave`. The README documents 3 environment variables (FLW_SECRET_KEY, FLW_ENCRYPTION_KEY, ANTHROPIC_API_KEY) to set first. Set FLW_SECRET_KEY, FLW_ENCRYPTION_KEY, ANTHROPIC_API_KEY before connecting. You can also paste the ready-made client config above.

Does Flutterwave run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Flutterwave

Alternatives to Flutterwave

Maintained other servers if Flutterwave isn't the fit.

More MCP servers to compare · Criterion · Maxential Thinking MCP · Bamwor MCP Server · Banana Prompts MCP · Bank Sync

More TypeScript MCP servers · Openevidence MCP · Balldontlie Api MCP Server · Scrapi · see all