Flutterwave MCP server

Connect Flutterwave to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Flutterwave MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list transactions tool in Flutterwave
  • Use the manage payment plans tool in Flutterwave
  • Use the pay bill tool in Flutterwave
  • Use the manage subscriptions tool in Flutterwave
  • Use the create refund tool in Flutterwave
  • Use the list settlements tool in Flutterwave

Supported Tools

list_transactions

List Transactions

Retrieve payment transactions with explicit date bounds and optional status, currency, customer email or transaction-reference filters. Returns paginated details including the payment method.

manage_payment_plans

Manage Payment Plans

Create, list, retrieve, update, or cancel payment plans for recurring billing. Payment plans define subscription parameters (amount, interval, duration). When you charge a customer with a plan, they are automatically subscribed for future billing cycles.

pay_bill

Pay Bill

Pay bills including Airtime, Data bundles, Cable TV (DSTV, GOtv), Power/Electricity, Tolls, and more. Requires the biller code, item code, and customer identifier. Use the "List Bill Categories" tool first to find valid biller and item codes.

manage_subscriptions

Manage Subscriptions

List, cancel, or reactivate customer subscriptions. Subscriptions are created automatically when a customer is charged with a payment plan. Filter subscriptions by customer email, plan ID, or status.

create_refund

Create Refund

Initiate a full or partial refund for a completed transaction. Provide the transaction ID and optionally an amount for partial refunds. If no amount is specified, a full refund is processed.

list_settlements

List Settlements

Retrieve settlement records showing how collected funds were settled to your bank account. Filter by date range or get details for a specific settlement. Includes gross amount, fees, refunds, chargebacks, and net amount.

create_virtual_account

Create Virtual Account

Generate a virtual bank account number for receiving payments via bank transfer. Supports dynamic (temporary, single-use) and static (permanent) accounts. Currently available for NGN and GHS.

list_transfers

List Transfers

Retrieve payout transfers with date, status or exact-reference filters and pagination. Fetch a specific transfer by ID to inspect its provider processing status.

create_transfer

Create Transfer

Initiate a payout/transfer to a bank account or mobile money wallet. Supports multiple currencies (NGN, USD, EUR, GHS, KES, etc.) and cross-currency transfers. You can optionally check transfer fees and exchange rates before sending.

resolve_bank_account

Resolve Bank Account

Look up and verify bank account details by account number and bank code. Returns the account holder's name for identity verification. Can also list banks for a given country to find the correct bank code.

get_transfer_rate

Get Transfer Rate

Get a cross-currency transfer rate quote with source and destination amounts. This read does not initiate a transfer or lock a rate.

list_refunds

List Refunds

Retrieve a list of refunds or get details for a specific refund. Filter by date range and page through results.

verify_transaction

Verify Transaction

Verify the status and details of a payment transaction. You can verify by either the Flutterwave transaction ID or your unique transaction reference (tx_ref). Use this to confirm that a payment was successful, check the charged amount and currency, and inspect the payment method.

list_bill_categories

List Bill Categories

Retrieve available bill payment categories and billers. Returns biller codes and item codes needed for making bill payments. Optionally filter by category or country, or get items for a specific biller.

get_transaction_fee

Get Transaction Fee

Calculate the fees that will be charged for a transaction of a given amount and currency. Also supports checking transfer/payout fees. Useful for displaying fee breakdowns to customers before payment.

manage_beneficiaries

Manage Beneficiaries

Create, list, retrieve, or delete saved transfer beneficiaries. Beneficiaries are saved recipient details for recurring payouts, so you don't have to enter bank details each time.

get_virtual_account

Get Virtual Account

Read a virtual account by its exact order reference. Returns account details and expiry when supplied; it does not prove a payment was collected.

get_bill_payment

Get Bill Payment

Query a bill payment using its transaction reference with provider status requested. The API response envelope indicates retrieval success, not delivery of the purchased service.

Connect Flutterwave to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Flutterwave in Metorial. In your Metorial portal, enable the Flutterwave MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Flutterwave tools.

Run Flutterwave through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Flutterwave and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Flutterwave tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Flutterwave

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Technical notes for Flutterwave

Use the supported Flutterwave API v3 to inspect transactions, fees, payouts, refunds and settlements; manage payment plans, subscriptions and beneficiaries; issue and retrieve virtual accounts; discover banks and bill products, and submit and inspect bill payments. API v3 Secret Keys determine test or live mode. Financial requests may be asynchronous and require status readback.

Frequently asked questions

Common questions about connecting Flutterwave to AI agents with Metorial.

  1. How many tools does the Flutterwave MCP server have?
    The Flutterwave MCP server exposes 18 tools, including List Transactions, Manage Payment Plans, Pay Bill. Each one is governed and traced through Metorial.
  2. Flutterwave exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Flutterwave MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Flutterwave and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Flutterwave MCP server yourself or use the hosted gateway.

Connect Flutterwave to production AI agents

See how Metorial gives your team governed access to Flutterwave, with tracing and security controls built in.