Flutterwave MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Flutterwave MCP or direct API to process payments, monitor transactions, issue refunds, and manage customers through natural language.

Flutterwave logoFlutterwave
Api Key

Flutterwave is a global payments platform enabling businesses to accept and send payments across Africa and beyond. Its robust APIs simplify cross-border transactions and financial operations.

53 Tools

Try Flutterwave now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Flutterwave
Try asking
TOOLS

Supported Tools

Every Flutterwave action and event your agent gets out of the box.

Cancel Payment Plan

Tool to cancel a payment plan.

Create Beneficiary

Tool to create a new transfer beneficiary.

Create Bulk Tokenized Charge

Tool to create a bulk tokenized charge batch for charging multiple previously tokenized cards.

Create Bulk Virtual Account Numbers

Tool to create multiple virtual account numbers.

Create Payment Link

Tool to create a hosted payment link.

Create Payment Plan

Tool to create a new payment plan.

Create Refund

Tool to create a refund for a transaction.

Create Subaccount

Tool to create a new subaccount.

Create Virtual Account

Tool to create a new virtual account number.

Delete Beneficiary

Tool to delete a beneficiary by ID.

Delete Subaccount

Tool to delete a subaccount by ID.

Disable Payment Link

Tool to disable a Flutterwave payment link.

Fetch Beneficiary

Tool to retrieve details of a specific beneficiary by ID.

Fetch Subaccount

Tool to retrieve details of a specific subaccount by ID.

Generate Transaction Reference

Tool to generate a unique transaction reference.

Get All Subscriptions

Tool to retrieve all subscriptions, including cancelled ones.

Retrieve all transactions

Tool to retrieve a list of all transactions with optional filters.

Get All Wallet Balances

Tool to retrieve all wallet balances across currencies.

Get Balances per Currency

Tool to retrieve wallet balance for a specific currency.

Get Bank Branches

Tool to retrieve branch codes for a specific bank.

Get Banks by Country

Tool to retrieve all banks in a specified country.

Get Bill Categories

Tool to retrieve available bill categories.

Get Bulk Tokenized Charge Status

Tool to retrieve the status of a bulk tokenized charge operation by ID.

Get Bulk Virtual Account

Tool to fetch bulk virtual account details using batch ID.

Get Multiple Refund Transactions

Tool to retrieve multiple refund transactions with optional filters.

Get Payment Plan

Tool to retrieve details of a specific payment plan by ID.

Get Payment Plans

Tool to retrieve a list of all payment plans.

Get Refund

Tool to retrieve details of a specific refund by ID.

Get Transaction

Tool to retrieve details of a specific transaction by ID.

Get Transaction Fee

Tool to retrieve the fee for a specific transaction.

Get Transfer Fee

Tool to retrieve the fee for initiating a transfer.

Get Transfer Rates

Tool to retrieve exchange rates for transfers between currencies.

Get Virtual Account Number

Tool to fetch details of a virtual account number by order reference.

Get Wallet Statement

Tool to retrieve wallet balance history with optional filters.

Initiate BVN Verification

Tool to initiate BVN verification consent.

Initiate Mobile Money Tanzania

Tool to initiate a mobile money payment in Tanzania.

List All Beneficiaries

Tool to list all saved beneficiaries.

List Biller Products

Tool to retrieve all products available under a specific biller.

List Billers

Tool to retrieve available billers.

List Chargebacks

Tool to retrieve a list of chargebacks with optional filtering by Flutterwave reference.

List Payout Subaccount Refunds

Tool to list all payout subaccount refunds with pagination support.

List Payout Subaccounts

Tool to list all payout subaccounts.

List Recurring Bills

Tool to retrieve all recurring bill payments.

List all settlements

Tool to retrieve all settlements with optional filters.

List All Subaccounts

Tool to fetch all collection subaccounts.

List Transfers

Tool to fetch a list of bulk transfers from your Flutterwave account.

Resolve Bank Account

Tool to verify and resolve bank account details.

Resolve Card BIN

Tool to resolve and retrieve card BIN information from Flutterwave.

Update Payment Plan

Tool to update an existing payment plan.

Update Subaccount

Tool to update an existing subaccount.

Validate Bill Item

Tool to validate a bill service before payment.

Verify Transaction by Reference

Tool to verify a transaction using its transaction reference.

View Transaction Timeline

Tool to retrieve the event timeline for a transaction.

SETUP GUIDE

Connect Flutterwave MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a payment link for NGN 5,000 for customer order #12345' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Flutterwave API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Flutterwave Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a payment link for a $100 invoice'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Flutterwave actions with your Agent

Why Use Composio?

AI Native Flutterwave Integration

  • Supports both Flutterwave MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Flutterwave data

Managed Auth

  • Built-in API key management and secure credential storage
  • Central place to manage, scope, and revoke Flutterwave access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Flutterwave
  • Scoped, least privilege access to Flutterwave resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Flutterwave requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Flutterwave.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Flutterwave tool your agent needs.Free to start.

Start building