How to integrate Flutterwave MCP with Atomic Agent

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Flutterwave.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Flutterwave account. See the Atomic Agent documentation for installation instructions.

How Atomic Agent connects to Flutterwave

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Flutterwave to Atomic Agent

1. Sign up or sign in to the Composio dashboard. Copy your API key.
2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
3. Ask Atomic Agent to do something in Flutterwave. It searches Composio for the right tool.
4. On first use, open the sign-in link returned in the chat. Connect your Flutterwave account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

The Flutterwave MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Flutterwave account. It provides structured and secure access to your payment infrastructure, so your agent can perform actions like creating payment links, managing beneficiaries, setting up virtual accounts, and handling subaccounts on your behalf.

• Instant payment link creation: Let your agent generate hosted payment URLs for one-time or recurring transactions, making it easy to collect payments from customers.
• Beneficiary management: Add, fetch, or remove transfer beneficiaries directly through your agent, streamlining the process of managing who receives your payouts.
• Virtual account generation: Automatically create single or bulk virtual bank accounts for customers, enabling seamless and trackable bank transfers.
• Subaccount setup and retrieval: Have your agent create, configure, or fetch subaccounts to manage split payments and disbursements for complex business needs.
• Payment link control: Disable active payment links when necessary to prevent further transactions, ensuring you stay in control of your payment flows.

Use Flutterwave from Atomic Agent

With your account connected, ask Atomic Agent to work with Flutterwave in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.