list_transactions
List Transactions
Retrieve payment transactions with explicit date bounds and optional status, currency, customer email or transaction-reference filters. Returns paginated details including the payment method.
Ask your agent in plain language. Each of these maps to a real tool on the server.
list_transactions
Retrieve payment transactions with explicit date bounds and optional status, currency, customer email or transaction-reference filters. Returns paginated details including the payment method.
manage_payment_plans
Create, list, retrieve, update, or cancel payment plans for recurring billing. Payment plans define subscription parameters (amount, interval, duration). When you charge a customer with a plan, they are automatically subscribed for future billing cycles.
pay_bill
Pay bills including Airtime, Data bundles, Cable TV (DSTV, GOtv), Power/Electricity, Tolls, and more. Requires the biller code, item code, and customer identifier. Use the "List Bill Categories" tool first to find valid biller and item codes.
manage_subscriptions
List, cancel, or reactivate customer subscriptions. Subscriptions are created automatically when a customer is charged with a payment plan. Filter subscriptions by customer email, plan ID, or status.
create_refund
Initiate a full or partial refund for a completed transaction. Provide the transaction ID and optionally an amount for partial refunds. If no amount is specified, a full refund is processed.
list_settlements
Retrieve settlement records showing how collected funds were settled to your bank account. Filter by date range or get details for a specific settlement. Includes gross amount, fees, refunds, chargebacks, and net amount.
create_virtual_account
Generate a virtual bank account number for receiving payments via bank transfer. Supports dynamic (temporary, single-use) and static (permanent) accounts. Currently available for NGN and GHS.
list_transfers
Retrieve payout transfers with date, status or exact-reference filters and pagination. Fetch a specific transfer by ID to inspect its provider processing status.
create_transfer
Initiate a payout/transfer to a bank account or mobile money wallet. Supports multiple currencies (NGN, USD, EUR, GHS, KES, etc.) and cross-currency transfers. You can optionally check transfer fees and exchange rates before sending.
resolve_bank_account
Look up and verify bank account details by account number and bank code. Returns the account holder's name for identity verification. Can also list banks for a given country to find the correct bank code.
get_transfer_rate
Get a cross-currency transfer rate quote with source and destination amounts. This read does not initiate a transfer or lock a rate.
list_refunds
Retrieve a list of refunds or get details for a specific refund. Filter by date range and page through results.
verify_transaction
Verify the status and details of a payment transaction. You can verify by either the Flutterwave transaction ID or your unique transaction reference (tx_ref). Use this to confirm that a payment was successful, check the charged amount and currency, and inspect the payment method.
list_bill_categories
Retrieve available bill payment categories and billers. Returns biller codes and item codes needed for making bill payments. Optionally filter by category or country, or get items for a specific biller.
get_transaction_fee
Calculate the fees that will be charged for a transaction of a given amount and currency. Also supports checking transfer/payout fees. Useful for displaying fee breakdowns to customers before payment.
manage_beneficiaries
Create, list, retrieve, or delete saved transfer beneficiaries. Beneficiaries are saved recipient details for recurring payouts, so you don't have to enter bank details each time.
get_virtual_account
Read a virtual account by its exact order reference. Returns account details and expiry when supplied; it does not prove a payment was collected.
get_bill_payment
Query a bill payment using its transaction reference with provider status requested. The API response envelope indicates retrieval success, not delivery of the purchased service.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Use the supported Flutterwave API v3 to inspect transactions, fees, payouts, refunds and settlements; manage payment plans, subscriptions and beneficiaries; issue and retrieve virtual accounts; discover banks and bill products, and submit and inspect bill payments. API v3 Secret Keys determine test or live mode. Financial requests may be asynchronous and require status readback.
Common questions about connecting Flutterwave to AI agents with Metorial.