Connector guide2-minute read10 MCP toolsEnglish · Deutsch · Italiano

How to Connect Flutterwave to Gemini — via MCP

Manage Flutterwave (Africa payments: payments, customers, subscriptions, transfers, refunds, payouts) from any AI agent. 10 tools, Bearer secret.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

MCP connector

Flutterwave

Manage Flutterwave (Africa payments: payments, customers, subscriptions, transfers, refunds, payouts) from any AI agent. 10 tools, Bearer secret.

Tools

10

Region

INTL

Category

payments

Authentication

Bearer Token

Required env vars

FLUTTERWAVE_SECRET_KEY
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Flutterwave in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

TL;DR

Manage Flutterwave (Africa payments: payments, customers, subscriptions, transfers, refunds, payouts) from any AI agent. 10 tools, Bearer secret.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Flutterwave, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Flutterwave + Gemini

Manage Flutterwave (Africa payments: payments, customers, subscriptions, transfers, refunds, payouts) from any AI agent. 10 tools, Bearer secret.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

FLUTTERWAVE_SECRET_KEY

Step 1 — Get credentials

This connector wraps the Flutterwave API v3 (api.flutterwave.com/v3).

Setup:

  1. Sign in at https://app.flutterwave.comSettings → API.
  2. Note your Secret Key (FLWSECK_TEST-... for test, FLWSECK-... for live) AND public key (used client-side).
  3. Set FLUTTERWAVE_SECRET_KEY.

Authentication: Authorization: Bearer ${FLUTTERWAVE_SECRET_KEY}.

Test vs Live: secret key prefix determines mode. Test transactions never touch real cards.

Amounts: Flutterwave uses major-unit decimal floats (₦1.50 = 1.50), unlike Paystack — pay attention.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 3 — Add the connector in Gemini

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. Get your MCP API key from AnythingMCP → Profile → MCP API Keys → New Key.
  2. Save the file and restart gemini.
  3. Run /mcp inside the Gemini CLI — Flutterwave should be listed as available.
  4. Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp to the tools array of your request with the same Bearer header.

Available tools

ToolWhat it does
flutterwave_create_paymentCreate a payment — returns a hosted checkout URL (`data
flutterwave_verify_transactionVerify a transaction by Flutterwave's transaction_id (NOT your tx_ref)
flutterwave_verify_by_referenceVerify a transaction by your tx_ref
flutterwave_list_transactionsList transactions
flutterwave_create_subscription_planCreate a recurring payment plan
flutterwave_list_subscriptionsList subscriptions
flutterwave_cancel_subscriptionCancel a subscription
flutterwave_initiate_transferInitiate a transfer (payout to a bank account)
flutterwave_refund_transactionRefund a transaction
flutterwave_list_banksList supported banks for a country

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with Bearer headers.

Next steps

Was this guide helpful?

Ready to ship

Your Flutterwave agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Related guides