Agentic Commerce Mcp Server

The only MCP server with M-Pesa, MTN Mobile Money, and Flutterwave support for emerging markets.

Enable AI agents (Claude, GPT, Gemini) to complete purchases across Shopify, WooCommerce, and BigCommerce - including mobile money payments for 500M+ users in Africa.

Why This Actor?

Feature	ACP/UCP Only	This Actor
Shopify, WooCommerce, BigCommerce	Yes	Yes
Card payments (SPT)	Yes	Yes
M-Pesa (Kenya, 50M users)	No	Yes
MTN Mobile Money (Ghana, Uganda)	No	Yes
Airtel Money	No	Yes
USSD (Nigeria, no internet needed)	No	Yes
30+ African countries	No	Yes

Supported Mobile Money (Unique!)

Method	Country	Currency	Users
M-Pesa	Kenya	KES	50M+
M-Pesa	Tanzania	TZS	15M+
MTN Mobile Money	Ghana	GHS	20M+
MTN Mobile Money	Uganda	UGX	10M+
MTN Mobile Money	Rwanda	RWF	5M+
Airtel Money	Uganda	UGX	8M+
Airtel Money	Ghana	GHS	5M+
Vodafone Cash	Ghana	GHS	8M+
USSD	Nigeria	NGN	100M+

Powered by Flutterwave - processing $16B+ annually across Africa.

10 MCP Tools

Discovery (2 tools)

Tool	Description
discover_products	Search products across platforms
get_merchant_info	Get store capabilities

Checkout (4 tools)

Tool	Description
create_checkout_session	Start checkout with items
update_checkout	Add buyer info, shipping
get_checkout_status	Check session state
complete_checkout	Pay with card (SPT)

Mobile Money (3 tools) - NEW!

Tool	Description
initiate_mobile_payment	Start M-Pesa/MTN/Airtel payment
get_supported_payment_methods	List methods by country
check_mobile_payment_status	Poll async payment status

Orders (1 tool)

Tool	Description
get_order_status	Track fulfillment

Two Payment Flows

Flow 1: Card Payment (Global)

create_checkout_session → update_checkout → complete_checkout(payment_token)

Flow 2: Mobile Money (Africa)

create_checkout_session → update_checkout → initiate_mobile_payment(phone) → check_mobile_payment_status

Quick Start

Mobile Money Example (Kenya M-Pesa)

# 1. Create checkout
session = create_checkout_session(
    merchant_url="store.example.com",
    items=[{"variant_id": "123", "quantity": 1}]
)

# 2. Add buyer info
update_checkout(
    session_id=session["session_id"],
    buyer_email="customer@example.com",
    shipping_address1="Kimathi Street",
    shipping_city="Nairobi",
    shipping_country="KE",
    shipping_zip="00100"
)

# 3. Check available payment methods for Kenya
methods = get_supported_payment_methods(country_code="KE")
# Returns: [{"method_id": "mpesa", "display_name": "M-Pesa Kenya", ...}]

# 4. Initiate M-Pesa payment
payment = initiate_mobile_payment(
    session_id=session["session_id"],
    payment_method="mpesa",
    phone_number="+254712345678"
)
# Customer receives M-Pesa prompt on their phone

# 5. Poll for completion
status = check_mobile_payment_status(
    transaction_id=payment["transaction_id"],
    session_id=session["session_id"]
)
# Returns: {"status": "successful", "order_id": "..."}

Card Payment Example (Global)

# 1-2. Same as above...

# 3. Complete with Shared Payment Token
result = complete_checkout(
    session_id=session["session_id"],
    payment_token="spt_xxx..."  # From AI agent platform
)

Supported Platforms

Platform	Market Share	Protocol	Status
Shopify	28%	UCP native	Ready
WooCommerce	43%	ACP plugin	Ready
BigCommerce	3%	ACP native	Ready

Configuration

Input Schema

Field	Description	Required
flutterwaveSecretKey	Flutterwave API key for mobile money	For mobile payments
flutterwaveWebhookSecret	Webhook verification	Optional
stripeTestKey	Stripe test key	For testing

Get Flutterwave Keys

1. Sign up at flutterwave.com
2. Get test keys: FLWSECK_TEST-xxxxx
3. Test mode auto-approves all payments (no real phone needed)

Tool Reference

initiate_mobile_payment

Start a mobile money payment. Customer receives a push notification to authorize.

{
  "session_id": "cs_abc123",
  "payment_method": "mpesa",
  "phone_number": "+254712345678"
}

Supported payment_method values:

• mpesa - M-Pesa Kenya (KES)
• mpesa_tanzania - M-Pesa Tanzania (TZS)
• mtn_ghana - MTN Ghana (GHS)
• mtn_uganda - MTN Uganda (UGX)
• mtn_rwanda - MTN Rwanda (RWF)
• airtel_uganda - Airtel Uganda (UGX)
• airtel_ghana - Airtel Ghana (GHS)
• airtel_rwanda - Airtel Rwanda (RWF)
• vodafone_ghana - Vodafone Ghana (GHS) - requires voucher
• ussd_nigeria - USSD Nigeria (NGN)

get_supported_payment_methods

Get available mobile payment methods for a country.

{
  "country_code": "KE"
}

Returns:

{
  "methods": [
    {
      "method_id": "mpesa",
      "display_name": "M-Pesa Kenya",
      "currency": "KES",
      "requires_phone": true
    }
  ]
}

check_mobile_payment_status

Poll for mobile payment completion (async flow).

{
  "transaction_id": "flw_123456",
  "session_id": "cs_abc123"
}

Returns:

{
  "status": "successful",
  "order_id": "flw_123456",
  "amount": 1000,
  "currency": "KES"
}

Security

• No Raw Card Data: Uses Shared Payment Tokens (SPT)
• No Merchant Credentials: Public Storefront APIs only
• PCI Compliant: Payment processing by merchant gateway
• Mobile Money: Flutterwave handles all sensitive data

Pricing

Free to try! Pay only for what you use.

Event	Price
Product Search	$0.01
Checkout Session	$0.02
Mobile Payment	$0.03
Order Status	$0.01

Testing

# Run tests
pytest tests/ -v

# 120 tests passing

Links

• Flutterwave Docs
• MCP Protocol
• Apify MCP

License

MIT License