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.

Warning!!!

This MCP is in active development.

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) [✓]

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

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"
      }
    }
  }
}