MCP Server - Afriex Business API

The Afriex MCP server exposes the Afriex Business API as tools for AI assistants. It implements the Model Context Protocol (MCP), letting clients like Claude Desktop, Claude Code, and Cursor interact with the Afriex platform programmatically.

How it works

The server exposes the core Business API endpoints as MCP tools, listed below. An AI assistant can create customers, send transactions, look up balances, and more, all via natural language. Some endpoints have no tool yet, including quotes, payment batches, customer updates and verification, transaction authorization, and the sandbox simulators. Call those over the REST API.

Authentication

You will need an Afriex Business API key from the dashboard. Connect your MCP client to https://mcp.afriex.com/mcp, then authenticate using one of two methods: Method 1: HTTP headers (recommended) Pass your API key directly in your MCP client config. The server captures these values and uses them for all subsequent Business API calls in the session:

Header	Required	Description
`x-afriex-api-key`	Yes	Your Afriex Business API key
`x-afriex-environment`	No	`development` (the sandbox, `https://sandbox.api.afriex.com`) or `production`. Defaults to `development`.

Method 2: authenticate tool After connecting, call the authenticate tool as your first action:

{
  "apiKey": "your-api-key",
  "environment": "development"
}

With production, the assistant acts on live data, and tools such as create_transaction move real money. Start in development, which is the MCP server’s name for the sandbox. Give the API key only the permissions you want the assistant to have.

See Connecting MCP Clients for client-specific setup instructions.

Available Tools (26)

Authentication

Tool	Description
`authenticate`	Set your API key and environment (`production`/`development`) for this session
`session_info`	View current session config: masked API key, environment, and base URL

Customers

Tool	Description
`create_customer`	Create a new customer with name, email, phone, and country code
`list_customers`	Retrieve a paginated list of customers
`get_customer`	Get a customer by ID
`delete_customer`	Delete a customer by ID
`update_customer_kyc`	Update KYC information for a customer

Transactions

Tool	Description
`create_transaction`	Create a `DEPOSIT`, `WITHDRAW`, or `SWAP` transaction
`list_transactions`	Retrieve a paginated list of transactions
`get_transaction`	Get a transaction by ID

Payment Methods

Tool	Description
`create_payment_method`	Create a payment method (`BANK_ACCOUNT`, `SWIFT`, `MOBILE_MONEY`, `UPI`, `INTERAC`, `WE_CHAT`)
`list_payment_methods`	Retrieve a paginated list of payment methods
`get_payment_method`	Get a payment method by ID
`delete_payment_method`	Delete a payment method by ID
`list_institutions`	List banks/providers by country and channel
`resolve_institution_codes`	Resolve a SWIFT code or routing number to a bank name
`resolve_payment_method`	Resolve recipient info by account number or phone
`get_crypto_wallet`	Get or create a crypto wallet (USDT/USDC, production only)
`list_virtual_accounts`	List existing virtual accounts for a customer and currency (`NGN`, `GHS`, `KES`, or `USD`)
`create_virtual_account`	Create a virtual account in `NGN`, `GHS`, `KES`, or `USD`, static (`label`) or dynamic (`amount`). A customer can hold `NGN` or `GHS`; omit `customerId` for `KES` and `USD`
`get_pool_account`	Get the business’s shared pool account for a country (production only)

Checkout Sessions

Tool	Description
`create_checkout_session`	Create a hosted checkout session and return its `checkoutUrl`

Webhooks

Tool	Description
`trigger_webhook`	Fire a real signed test webhook to your configured callback URL (sandbox only)

Organization

Tool	Description
`get_balance`	Fetch wallet balances for specified currencies
`get_rates`	Get real-time exchange rates
`topup_balance`	Top up sandbox balance with a specified amount and currency (sandbox only)

​How it works

​Authentication

​Available Tools (26)

​Authentication

​Customers

​Transactions

​Payment Methods

​Checkout Sessions

​Webhooks

​Organization

How it works

Authentication

Available Tools (26)

Authentication

Customers

Transactions

Payment Methods

Checkout Sessions

Webhooks

Organization