Can I use Flutterwave as a CLI?

Yes. KosmoKrator exposes a Flutterwave CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Flutterwave through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Flutterwave tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Flutterwave credentials stored?

Flutterwave credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Flutterwave MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

other

Flutterwave CLI for AI Agents

Use the Flutterwave CLI from KosmoKrator to call Flutterwave tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 5 read 2 write API key auth

Submit Flutterwave feedback View package source

Flutterwave CLI Setup

Flutterwave can be configured headlessly with `kosmokrator integrations:configure flutterwave`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure flutterwave --set secret_key="$FLUTTERWAVE_SECRET_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor flutterwave --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`secret_key`	`FLUTTERWAVE_SECRET_KEY`	Secret `secret`	yes	Secret Key

Call Flutterwave Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call flutterwave.flutterwave_list_transactions '{
  "page": 1,
  "status": "example_status",
  "from": "example_from",
  "to": "example_to"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:flutterwave flutterwave_list_transactions '{
  "page": 1,
  "status": "example_status",
  "from": "example_from",
  "to": "example_to"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs flutterwave --json
kosmo integrations:docs flutterwave.flutterwave_list_transactions --json
kosmo integrations:schema flutterwave.flutterwave_list_transactions --json
kosmo integrations:search "Flutterwave" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Flutterwave.

`flutterwave.flutterwave_list_transactions`

Read read

List transactions from your Flutterwave account. Supports filtering by status and date range, with pagination.

Parameters: page, status, from, to

Generic CLI call

kosmo integrations:call flutterwave.flutterwave_list_transactions '{"page":1,"status":"example_status","from":"example_from","to":"example_to"}' --json

Provider shortcut

kosmo integrations:flutterwave flutterwave_list_transactions '{"page":1,"status":"example_status","from":"example_from","to":"example_to"}' --json

`flutterwave.flutterwave_get_transaction`

Read read

Retrieve full details of a specific Flutterwave transaction by its ID.

Parameters: id

Generic CLI call

kosmo integrations:call flutterwave.flutterwave_get_transaction '{"id":1}' --json

Provider shortcut

kosmo integrations:flutterwave flutterwave_get_transaction '{"id":1}' --json

`flutterwave.flutterwave_initiate_payment`

Write write

Initiate a new payment on Flutterwave. Requires a transaction reference, amount, currency, and customer details.

Parameters: tx_ref, amount, currency, customer, redirect_url

Generic CLI call

kosmo integrations:call flutterwave.flutterwave_initiate_payment '{"tx_ref":"example_tx_ref","amount":1,"currency":"example_currency","customer":"example_customer","redirect_url":"example_redirect_url"}' --json

Provider shortcut

kosmo integrations:flutterwave flutterwave_initiate_payment '{"tx_ref":"example_tx_ref","amount":1,"currency":"example_currency","customer":"example_customer","redirect_url":"example_redirect_url"}' --json

`flutterwave.flutterwave_verify_transaction`

Read read

Verify a Flutterwave transaction by its ID to confirm payment status and retrieve full details.

Parameters: id

Generic CLI call

kosmo integrations:call flutterwave.flutterwave_verify_transaction '{"id":1}' --json

Provider shortcut

kosmo integrations:flutterwave flutterwave_verify_transaction '{"id":1}' --json

`flutterwave.flutterwave_list_customers`

Read read

List customers registered on your Flutterwave account, with pagination support.

Parameters: page

Generic CLI call

kosmo integrations:call flutterwave.flutterwave_list_customers '{"page":1}' --json

Provider shortcut

kosmo integrations:flutterwave flutterwave_list_customers '{"page":1}' --json

`flutterwave.flutterwave_create_customer`

Write write

Create a new customer record on Flutterwave. Requires an email address.

Parameters: email, first_name, last_name, phone

Generic CLI call

kosmo integrations:call flutterwave.flutterwave_create_customer '{"email":"example_email","first_name":"example_first_name","last_name":"example_last_name","phone":"example_phone"}' --json

Provider shortcut

kosmo integrations:flutterwave flutterwave_create_customer '{"email":"example_email","first_name":"example_first_name","last_name":"example_last_name","phone":"example_phone"}' --json

`flutterwave.flutterwave_get_banks`

Read read

Get a list of supported banks for a given country from Flutterwave. Provide a country code like "NG" for Nigeria, "KE" for Kenya, "GH" for Ghana.

Parameters: country

Generic CLI call

kosmo integrations:call flutterwave.flutterwave_get_banks '{"country":"example_country"}' --json

Provider shortcut

kosmo integrations:flutterwave flutterwave_get_banks '{"country":"example_country"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`flutterwave.flutterwave_list_transactions`

List transactions from your Flutterwave account. Supports filtering by status and date range, with pagination.

Operation: Read read
Schema command: kosmo integrations:schema flutterwave.flutterwave_list_transactions --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`status`	string	no	Filter by transaction status (e.g. "successful", "failed", "pending").
`from`	string	no	Start date for filtering transactions (YYYY-MM-DD).
`to`	string	no	End date for filtering transactions (YYYY-MM-DD).

`flutterwave.flutterwave_get_transaction`

Retrieve full details of a specific Flutterwave transaction by its ID.

Operation: Read read
Schema command: kosmo integrations:schema flutterwave.flutterwave_get_transaction --json

Parameter	Type	Required	Description
`id`	integer	yes	The Flutterwave transaction ID.

`flutterwave.flutterwave_initiate_payment`

Initiate a new payment on Flutterwave. Requires a transaction reference, amount, currency, and customer details.

Operation: Write write
Schema command: kosmo integrations:schema flutterwave.flutterwave_initiate_payment --json

Parameter	Type	Required	Description
`tx_ref`	string	yes	Your unique transaction reference (e.g. "txn-001").
`amount`	number	yes	Payment amount (e.g. 5000).
`currency`	string	yes	Three-letter currency code (e.g. "NGN", "USD", "KES").
`customer`	object	yes	Customer object with at least an "email" field. May also include "name" and "phonenumber".
`redirect_url`	string	no	URL to redirect the customer after payment completion.

`flutterwave.flutterwave_verify_transaction`

Verify a Flutterwave transaction by its ID to confirm payment status and retrieve full details.

Operation: Read read
Schema command: kosmo integrations:schema flutterwave.flutterwave_verify_transaction --json

Parameter	Type	Required	Description
`id`	integer	yes	The Flutterwave transaction ID to verify.

`flutterwave.flutterwave_list_customers`

List customers registered on your Flutterwave account, with pagination support.

Operation: Read read
Schema command: kosmo integrations:schema flutterwave.flutterwave_list_customers --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).

`flutterwave.flutterwave_create_customer`

Create a new customer record on Flutterwave. Requires an email address.

Operation: Write write
Schema command: kosmo integrations:schema flutterwave.flutterwave_create_customer --json

Parameter	Type	Required	Description
`email`	string	yes	Customer email address.
`first_name`	string	no	Customer first name.
`last_name`	string	no	Customer last name.
`phone`	string	no	Customer phone number.

`flutterwave.flutterwave_get_banks`

Get a list of supported banks for a given country from Flutterwave. Provide a country code like "NG" for Nigeria, "KE" for Kenya, "GH" for Ghana.

Operation: Read read
Schema command: kosmo integrations:schema flutterwave.flutterwave_get_banks --json

Parameter	Type	Required	Description
`country`	string	yes	ISO country code (e.g. "NG", "KE", "GH", "ZA").

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.