mcp-flutterwave

An MCP (Model Context Protocol) server that enables AI assistants to interact with Flutterwave, providing tools for confirming transactions, send failed hooks, and more.

Features

• Confirm Transactions (Already included)
• Retry Failed Transactions (Automatically retry transactions with recoverable errors) [✓]
• Retrieve Transaction History (Fetch and analyze past transactions) [✓]
• Send Failed Hooks (Already included)
• Generate Payment Links [✓]
• Automated Customer Support (AI chatbot integrated with Flutterwave for transaction inquiries) [✓]
• Manage Transfers and Beneficiaries (Already included)[✓]

Available Tools

• get-transactions: Get the final status of a transaction with a transaction ID
• resent-failed-webhook: Resend failed webhook for a transaction
• create-checkout: Create a payment link for customers
• disable-checkout: Disable a checkout transaction link
• retry-transaction: Analyze and provide guidance for retrying a failed transaction
• get-transaction-timeline: Get the timeline/history of events for a transaction
• get-beneficiaries: Get the list of beneficiaries for a transfer
• get-transfers: Get the list of transfers for a customer
• create-transfer: Create a transfer for a customer
• create-beneficiary: Create a beneficiary for transfers

Installation

Via npm (Recommended)

npm install -g mcp-flutterwave

Via GitHub

git clone https://github.com/bajoski34/mcp-flutterwave.git
cd mcp-flutterwave
npm install
npm run build

Usage with Claude Desktop

Add the following to your claude_desktop_config.json. See here for more details.

Using npm installation

{
  "mcpServers": {
    "flutterwave": {
      "command": "mcp-flutterwave",
      "args": [
        "--tools=create_checkout,disable_checkout,read_transaction,resend_transaction_webhook"
      ],
      "env": {
        "FLW_SECRET_KEY": "YOUR_SECRET_KEY"
      }
    }
  }
}

Using local build

{
  "mcpServers": {
    "flutterwave": {
      "command": "node",
      "args": [
        "/path/to/mcp-flutterwave/build/index.js",
        "--tools=create_checkout,disable_checkout,read_transaction,resend_transaction_webhook"
      ],
      "env": {
        "FLW_SECRET_KEY": "YOUR_SECRET_KEY"
      }
    }
  }
}

Setup Steps

1. Install the package

   npm install -g mcp-flutterwave

2. Get your Flutterwave secret key

   • Log into your Flutterwave dashboard
   • Go to Settings > API Keys
   • Copy your Secret Key

3. Configure Claude Desktop

   • Add the configuration to your claude_desktop_config.json
   • Replace YOUR_SECRET_KEY with your actual Flutterwave secret key

4. Start using with Claude

   • Open Claude Desktop
   • Ask questions related to Flutterwave transactions, payments, etc.

Contributing

We welcome contributions! Please read our Contributing Guide for details on how to get started, development guidelines, and how to submit changes.