Zambia Payments MCP is an MCP server that enables AI agents to accept payments in Zambia via mobile money using Flutterwave. The server is described as never holding funds. It provides HTTP access for MCP-capable clients, with credentials sent as HTTP headers on each request rather than stored.

🛠️ Key Features

MCP server endpoint at https://mcp-zm.wishpool.app/mcp (HTTP)
Mobile money payments in Zambia via Flutterwave
No fund custody: “Never holds funds”
Credentials (when needed) travel as HTTP headers per request, not stored
Tool count: 6

🚀 Use Cases

Let AI agents accept payments specifically in Zambia
Integrate Flutterwave mobile money into an MCP-enabled agent flow

⚡ Developer Benefits

No installation required; configure an MCP client using the HTTP URL
Avoids stored credentials by sending them as HTTP headers per request
Includes trust guidance via a referenced “threat model” page

⚠️ Limitations

Run instructions are only partially shown in the provided excerpt (“Or run it yourself” without details)
Further tool capabilities are not described beyond the tool count and payment purpose

🔎 Topics

ai-agent, claude, flutterwave, mcp, mcp-server, payments, wishpool, zambia

Zambia Payments MCP — let AI agents accept payments in Zambia

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "zambia-payments": {
      "type": "http",
      "url": "https://mcp-zm.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/zambia-payments-mcp && cd zambia-payments-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Live · MCP endpoint: https://mcp-zm.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/zambia-payments-mcp · Part of a 71-country family — hub: mcp.wishpool.app

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Zambia: MTN Mobile Money, Airtel Money, cards — via Flutterwave — via Flutterwave's hosted checkout.

⚖️ Stateless translation layer: funds always flow buyer → Flutterwave → merchant directly. Never holds funds or stores credentials — no database at all.

Quick start

MCP endpoint: https://mcp-zm.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)

Header	Value
`x-flutterwave-secret-key`	your Flutterwave secret key (FLWSECK_TEST- = test mode from dashboard.flutterwave.com, FLWSECK- = production)

Tools

Tool	What it does
`create_payment_link`	Create a ZMW hosted-checkout link.
`query_payment_status`	Pull-based status check; `paid=true` when PAID.

Develop

bash

node test/serve.js      # local server (http://localhost:3279/mcp)
node test/e2e.js        # protocol + validation suite (probes real Flutterwave auth errors)

Zero runtime dependencies; Node ≥ 18. MIT license.

amount_zmw	number	required	Amount in ZMW (decimals allowed), e.g. 50. Minimum 5.
description	string	required	What this payment is for (shown to the buyer, ≤200 chars)
customer_email	string	required	Buyer email (required by Flutterwave; the receipt goes there).
reference_id	string	optional	Your unique order reference (≤40 chars). Auto-generated if omitted.
success_url	string	optional	Optional https URL to send the buyer to after payment.

tx_ref	string	required	The tx_ref of the paid payment (same id used by query_payment_status)
amount	number	optional	Optional partial-refund amount in the local currency major unit. Omit for a full refund.

amount_zmw	number	required	Amount charged per billing period (ZMW major unit)
interval	string	optional	Billing period. Default "month".
description	string	required	What the subscription is for (also used as the Flutterwave plan name, <=80 chars)
customer_email	string	required	Buyer email (required by Flutterwave; receipts and renewal notices go there).
success_url	string	optional	Optional https URL to send the buyer to after subscribing.

customer_email	string	required	The buyer email used in create_subscription_link
plan_id	string	optional	Optional plan_id returned by create_subscription_link (disambiguates multiple subscriptions on the same email).

Zambia Payments (Flutterwave — mobile money)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

🔎 Topics

Topics

create_payment_link

query_payment_status

refund_payment

create_subscription_link

query_subscription

cancel_subscription

Zambia Payments MCP — let AI agents accept payments in Zambia

Use it in 60 seconds

Or run it yourself

Quick start

Tools

Develop

Install

Remote endpoint

Related servers