
Mcp Flutterwave
io.github.bajoski34由 GitHub 帳號 bajoski34 發布v1.2.0更新於 Oct 24, 2026
MCP Server to interact with Flutterwave APIs.
概覽
一個本機 MCP 伺服器,讓 AI 助理呼叫 Flutterwave 支付 API:結帳連結、卡片與行動支付扣款、轉帳、虛擬帳戶、帳單、外匯與穩定幣。
- 可以做什麼
- 建立與停用託管結帳付款連結,並透過信用卡、銀行帳戶、行動錢包、M-Pesa 或 USSD 向客戶扣款,涵蓋 PIN、AVS、3DS 與 OTP 流程及 OTP 驗證。依 ID 或參考號查詢交易、檢視事件時間軸並重送失敗的 webhook。發起轉帳、管理收款人,建立或列出付款方案。建立、查詢與更新虛擬帳戶,列出批次清單。查詢並支付帳單(僅奈及利亞)及查看帳單狀態。申請外匯報價並執行交易,進行 BVN 驗證、銀行帳戶解析與卡 BIN 查詢,以及在 Polygon 上發送或兌換 USDC/USDT。
- 適用情境
- 適合讓助理端到端操作 Flutterwave 商戶帳戶:收款、查詢交易狀態、付款、透過虛擬帳戶收款、支付奈及利亞帳單、兌換貨幣或轉移穩定幣。若只是唯讀查看其他支付服務商的資料,則不需要使用。
- 執行需求
- 透過 stdio 在本機執行,由 Claude Desktop 等 MCP 用戶端啟動;npm/npx 套件需要 Node.js 20 或更新版本,也可使用 Docker。需要 Flutterwave 金鑰,放在環境變數 FLW_SECRET_KEY 中;信用卡扣款另需 FLW_ENCRYPTION_KEY。需要可存取 Flutterwave v3 API 的網路。透過 --tools 參數啟用工具(all 或逗號分隔清單)。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Mcp Flutterwave,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
mcp-flutterwave
[CI] [npm version] [npm downloads] [Docker] [License: MIT] [Node.js] [MCP]
An MCP (Model Context Protocol) server that enables AI assistants to interact with the Flutterwave API — create payment links, charge customers directly, manage transfers, collect via virtual accounts, pay bills, and more.
Note: This server currently targets the Flutterwave v3 API. Support for v4 is coming soon.
Also ships with a built-in web app that connects to the MCP server and lets you talk to a Claude-powered Flutterwave assistant directly in your browser.
Contents
- Features
- Installation
- Available Tools
- Card Charge Flow
- Virtual Accounts
- Bill Payment Flow
- FX Trade Flow
- Verification
- Stablecoins
- Web App
- MCP Server Setup
- Usage with Claude Desktop
- MCP-UI Components
- Contributing
- Changelog
- Security
- License
Features
- Checkout — Create hosted payment links and disable them
- Direct Charges — Charge customers via card, bank account, mobile money, M-Pesa, or USSD
- Full card auth flow — PIN, AVS (Address Verification), 3D Secure redirect, and OTP validation all handled automatically
- Charge Validation — Validate OTP-based charges with a dedicated tool
- Transactions — Verify by ID or reference, view event timeline, resend failed webhooks
- Transfers — Initiate single transfers, manage beneficiaries
- Payment Plans — Create and retrieve subscription plans
- Virtual Accounts — Generate dedicated account numbers for NGN and GHS bank transfer collection (static or dynamic)
- Bill Payments — Pay airtime, data, cable TV, electricity, internet bills and more (Nigeria)
- FX Trade — Convert between NGN, GHS, and USD with live quotes (RFQ → trade in two steps)
- Verification — BVN identity verification, bank account name resolution, and card BIN lookup
- Stablecoins — Send USDC/USDT to Polygon wallets, or convert NGN/USD fiat into stablecoins
- Rich UI — Every tool returns a branded HTML card rendered inline in supported clients
- Web App — A standalone browser chat interface powered by Claude + this MCP server
Installation
npm
npx (no install needed)
Docker
Pull the image:
The server communicates over stdio, so it must be launched by an MCP client — not run standalone. Configure Claude Desktop to use the Docker image as the MCP server:
The -i flag keeps stdin open so Claude Desktop can communicate with the server over stdio.
Requirements: Node.js 20 or later (for npm/npx).
Available Tools
Checkout
Direct Charges
Transactions
Transfers
Payment Plans
Virtual Accounts
Bill Payments
FX Trade
Verification
Stablecoins
Card Charge Flow
Direct card charges are multi-step. The charge_card tool handles every stage automatically and tells Claude what to do next.
Authorization parameters
When a second call is needed, pass authorization alongside the original card details:
AMEX cards
American Express transactions require the card_holder_name field in addition to standard card details.
Payload encryption
Card payloads are encrypted with 3DES-ECB using your FLW_ENCRYPTION_KEY before they are sent to Flutterwave (PCI DSS requirement). The encryption is handled automatically — set the environment variable and the server does the rest.
Virtual Accounts
Virtual accounts give each customer a dedicated bank account number to make transfers into. Flutterwave notifies your webhook when a payment arrives.
NGN static account
GHS dynamic account
After creation, save the order_ref — it is the key for retrieving or updating the account via get_virtual_account and update_virtual_account.
Bill Payment Flow
Bill payments follow a 6-step discovery flow. Skip validate_bill_customer for airtime and mobile data.
Supported categories
Bill payments are available for Nigeria only (
country: NG).
FX Trade Flow
Currency conversion uses a two-step quote-then-trade flow. Quotes are valid for 5 minutes and available weekdays only (Monday–Friday).
Supported currency pairs
Quote statuses
Trade statuses
Key constraints
- Minimum trade: $1,000 USD equivalent in the base currency
- Quote lifetime: 5 minutes from issuance (READY state)
- One-time use: Each quote can only be used for one trade
- Approved quantity: May differ from requested quantity due to liquidity or account limits — always use
approved_quantityfor reconciliation - Account enablement: Contact [email protected] to enable FX trading on your account
Verification
Bank Account Resolution
Verify a recipient's account details before sending a transfer. Always show the resolved name to the user before proceeding.
Common bank codes: 044 Access Bank · 057 Zenith Bank · 058 GTBank · 033 UBA · 011 First Bank
Card BIN Lookup
Identify card metadata from the first 6 digits of a card number.
AMEX cards identified via BIN require the
card_holder_namefield when callingcharge_card.
BVN Verification (Nigeria)
Two-step consent flow — customer must approve data sharing on the NIBSS portal.
Requires Flutterwave account enablement — contact [email protected]. If the customer has already consented,
initiate_bvn_verificationreturnsurl: nulland you can callget_bvn_detailsimmediately.
Stablecoins
Send USDC or USDT over the Polygon network, or convert NGN/USD fiat balances into stablecoins. Always call get_stablecoin_fee first so the user knows the net amount the recipient will receive.
Wallet-to-wallet transfer
Fiat-to-stablecoin conversion
Key constraints
Web App
The app/ directory contains a standalone browser chat interface that wraps this MCP server with a Claude-powered conversation loop.
[Flutterwave MCP-UI components: transaction, payment link and transfer cards]
How it works
The web app uses three Anthropic Advanced Tool Use features:
- Tool Search — non-core tools are deferred and loaded on demand, reducing token usage by ~85%
- Programmatic Tool Calling — Claude can write code that calls multiple tools in sequence without inflating the conversation context
- Tool Use Examples — curated
input_examplesfor every tool improve parameter accuracy from ~72% to ~90%
The app returns a rich branded UI card for every tool response — checkout links, transaction details, charge states, transfer summaries, virtual accounts, bill receipts — rendered inline in the chat.
Running the web app
Prerequisites
Get your keys from the Flutterwave Dashboard under Settings → API Keys.
Get your Anthropic key from the Anthropic Console.
Build and start
Then open http://localhost:3000.
Available scripts
Port
Set the PORT environment variable to change from the default 3000.
MCP Server Setup
Via npm
Via GitHub
Environment variables
Usage with Claude Desktop
Add the following to your claude_desktop_config.json. See the MCP quickstart for details.
Pass --tools=all to enable every tool, or supply a comma-separated list to restrict which tools are registered.
Via npm
Via local build
Selective tools
Accepted tool names (use all to enable everything):
MCP-UI Components
Every tool returns a rich HTML card alongside its text response, powered by @mcp-ui/server. The cards use Flutterwave's design tokens — navy #0A0E27, deep orange #FF5804, brand orange #F5A623, and the system sans-serif typeface.
Card charge UI states
Virtual account UI
The virtual account card shows the bank account number in a large, prominent box alongside the bank name, account type (Static / Dynamic), currency, expiry date, and order reference.
Bill payment UI
Verification UI
Stablecoin UI
FX trade UI
Both request_fx_quote/get_fx_quote and initiate_fx_trade/get_fx_trade return dark navy-themed cards:
Cards are compatible with:
- Flutterwave Web App (this repo's
app/) — rendered inline in the chat - MCP Inspector — for testing during development
- Any MCP client that supports the
resourcecontent type with HTML
Contributing
We welcome contributions! Please read our Contributing Guide for details on how to get started, development guidelines, and how to submit pull requests.
Changelog
All notable changes are documented in GitHub Releases.
Security
If you discover a security vulnerability, please do not open a public issue. Instead, email [email protected] directly. We will respond as quickly as possible.
License
MIT © Abraham Olaobaju
See LICENSE for the full text.
來源:README.md,提交 c4a97be
工具
0版本歷史
1- v1.2.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分