mcp-flutterwave-gateway: Flutterwave Operational Interface

This module serves as an MCP (Model Context Protocol) endpoint designed to grant AI systems programmatic access to core functionalities within the Flutterwave financial platform, encompassing payment lifecycle governance, webhook remediation, and ancillary features.

Critical Notice

This MCP implementation is currently under vigorous development and refinement.

Core Functionalities

• Transaction Status Confirmation (Baseline capability)
• Automated Transaction Re-execution (Intelligently retries transactions encountering transient failures) [✓]
• Historical Transaction Data Retrieval (For auditing and analysis) [✓]
• Failed Event Notification Resend (Redeliver failed system callbacks)
• Dynamic Payment URL Generation [✓]
• Conversational Commerce Support (Embedded AI assistant for transaction-related support) [✓]

Exposed Utilities

• get-transactions: Fetches the conclusive status associated with a specific transaction identifier.
• resent-failed-webhook: Triggers a re-dispatch of a previously failed webhook notification for a given transaction ID.
• create-checkout: Provisions a new, unique payment link for customer settlement.
• disable-checkout: Invalidates an existing payment link, preventing further use.
• retry-transaction: Assesses failed transaction data and recommends or executes a retry logic.
• get-transaction-timeline: Retrieves a sequential log of all recorded events pertaining to a specific transaction.

Deployment Instructions

Standard Installation via npm (Recommended Method)

bash npm install -g mcp-flutterwave-gateway

Local Source Compilation

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

Configuration for Desktop Agents

Integrate the following configuration structure into your claude_desktop_config.json. Refer to this guide for detailed setup prerequisites.

Configuration Using Global npm Package

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

Configuration Using Locally Built Files

{ "mcpServers": { "flutterwave_ops": { "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" } } } }

Operational Checklist

1. Acquire the Module bash npm install -g mcp-flutterwave-gateway

2. Obtain Flutterwave Credentials

3. Navigate to the Flutterwave administrative portal.
4. Access Security or API Key settings.

5. Securely copy the Secret Key.

6. Configure Agent Environment

7. Update your claude_desktop_config.json with the service block provided above.

8. Substitute the placeholder YOUR_SECRET_KEY with your actual Flutterwave secret.

9. Commence Utilization

10. Launch the Desktop Application.
11. Engage the assistant with queries pertaining to payment processing, transaction status lookups, or payment link creation via Flutterwave.

Collaborative Development

We actively encourage external contributions! Kindly consult our CONTRIBUTING.md document for guidelines on project onboarding, coding standards, and submission protocols.