This MCP server provides South Africa payment capabilities for AI agents, specifically supporting cards and EFT via Paystack. It is positioned as not holding funds, with credentials passed as HTTP headers per request rather than being stored.

🛠️ Key Features

South Africa payments for AI agents
Paystack integration for card payments and EFT
“Never holds funds” design
Credentials travel as HTTP headers on each request (not stored)

🚀 Use Cases

Enabling AI agents to accept payments in South Africa
Supporting payment collection flows that use cards or EFT via Paystack

⚡ Developer Benefits

Simple HTTP MCP client configuration (single endpoint shown)
No separate installation step
Per-request credential handling aligned with the linked threat model

⚠️ Limitations

Configuration details shown as an HTTP transport URL
No additional tools beyond the listed capabilities are described (toolCount: 6)

Topics

ai-agent, claude, mcp, mcp-server, payments, paystack, south-africa, wishpool

South Africa Payments MCP — let AI agents accept payments in South Africa

Use it in 60 seconds

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

json

{
  "mcpServers": {
    "south-africa-payments": {
      "type": "http",
      "url": "https://mcp-za.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/south-africa-payments-mcp && cd south-africa-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-za.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/south-africa-payments-mcp · Part of a 30-country family — hub: mcp.wishpool.app

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in South Africa: cards, instant EFT, and other methods via Paystack — via Paystack's hosted checkout.

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

Quick start

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

Header	Value
`x-paystack-secret-key`	your Paystack secret key (sk_test_ = test mode from dashboard.paystack.com, sk_live_ = production)

Tools

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

Develop

bash

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

Zero runtime dependencies; Node ≥ 18. MIT license.

amount_zar	number	required	Amount in ZAR (decimals allowed), e.g. 10. Minimum 1.
description	string	required	What this payment is for (shown to the buyer, ≤200 chars)
customer_email	string	required	Buyer email (required by Paystack; 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.

reference	string	required	The reference 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_zar	number	required	Amount charged per billing period (ZAR major unit)
interval	string	optional	Billing period. Default "month".
description	string	required	What the subscription is for (also used as the Paystack plan name, <=80 chars)
customer_email	string	required	Buyer email (required by Paystack; receipts and renewal notices go there).
success_url	string	optional	Optional https URL to send the buyer to after subscribing.

subscription_code	string	required	The subscription_code (SUB_...) returned by query_subscription
email_token	string	optional	Optional email_token from query_subscription; auto-resolved when omitted.

South Africa Payments (Paystack — cards / EFT)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

Topics

create_payment_link

query_payment_status

refund_payment

create_subscription_link

query_subscription

cancel_subscription

South Africa Payments MCP — let AI agents accept payments in South Africa

Use it in 60 seconds

Or run it yourself

Quick start

Tools

Develop

Install

Remote endpoint

Related servers