AI-Native Nigerian Commerce via Model Context Protocol (MCP)
Kiki (kiki.com.ng) gives autonomous AI agents like Claude, ChatGPT, Cursor, and OpenClaw direct, structured access to 80,000+ Nigerian products, live courier landed costs across all 37 states + FCT, and zero-OTP Naira checkout — with no browser automation and no 3D/AR scraping.
Zero Browser Automation or 3D Friction
3D previews and Virtual Try-On are strictly for human shoppers. Agents call structured MCP tools and JSON endpoints directly — no Playwright, no DOM clicking, no CAPTCHAs.
Inline Naira Virtual Account & Pay on Delivery
kiki_create_order returns an inline dedicated Nigerian bank account (account number, bank name, exact NGN amount, narration token) that settles via webhook with zero card OTP hurdle — plus pay_on_delivery and hosted Paystack URLs.
Fulfilment Certainty & Live Courier Quotes
Every listing declares instant, merchant_confirms, or sourced fulfilment alongside real state-to-state courier landed costs across all 37 Nigerian states + FCT.
Connect Your AI Agent in Seconds
claude mcp add --transport http kiki https://kiki.com.ng/mcp{
"mcpServers": {
"kiki": {
"type": "streamable-http",
"url": "https://kiki.com.ng/mcp"
}
}
}# 1. Initialize MCP session
curl -sS -X POST https://kiki.com.ng/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'
# 2. Search products in Nigeria with landed cost to Lagos (LA)
curl -sS "https://api.xrnet.tech/api/agent/search?q=philips+iron&deliverTo=LA"
# 3. Create order (returns inline Virtual Account bankTransfer + payment.url)
curl -sS -X POST https://api.xrnet.tech/api/agent/orders \
-H "Content-Type: application/json" \
-d '{"items":[{"listingId":"<uuid>","quantity":1}],"buyer":{"firstname":"Ada","lastname":"Obi","email":"ada@example.com","phone":"+2348012345678","address":"12 Bode Thomas St","city":"Surulere","state":"LA"},"idempotencyKey":"order-001"}'ChatGPT Custom GPT Actions & OpenAPI Integrations
Import Kiki's scoped public OpenAPI 3.0 schema directly — no authentication headers needed:
https://api.xrnet.tech/api/agent/openapi.jsonMCP Tools & Capabilities
Exposed on both https://kiki.com.ng/mcp and https://api.xrnet.tech/api/mcp.
| MCP Tool | REST Equivalent | What It Does |
|---|---|---|
| kiki_search | GET /api/agent/search | Search 80,000+ Nigerian products across Kiki merchants and indexed marketplaces. Pass deliverTo (e.g. 'Lagos', 'LA', 'Abuja') for live courier landed costs and fulfilment classes ('instant', 'merchant_confirms', 'sourced'). |
| kiki_get_listing | GET /api/agent/listings/{idOrSlug} | Inspect a single product by listingId (UUID), slug, or full kiki.com.ng/products/{slug} URL. Returns plain-text description, condition, variants, stock/fulfilment class, and optional courier landed cost. |
| kiki_quote | POST /api/agent/quote | Get an authoritative basket total and live courier fee for a specific pickup-to-destination route without reserving stock. Automatically tells the agent how to split multi-seller baskets. |
| kiki_create_order | POST /api/agent/orders | Create an order and receive inline dedicated Nigerian Virtual Account bankTransfer details (accountNumber, bankName, exactAmount, narrationToken — settles automatically with zero browser/OTP step), plus payment.url or pay_on_delivery. |
| kiki_order_status | GET /api/agent/orders/{reference} | Poll an order by reference or buyer trackingId. Returns normalised status, paid boolean, items, bankTransfer details if unpaid, and an explicit nextAction. |
| kiki_destinations | GET /api/agent/destinations | List all 37 Nigerian states + FCT and every accepted spelling, two-letter code ('LA'), and ISO 3166-2 code ('NG-LA'). |
Public Discovery & Commerce Endpoints
/mcpStreamable HTTP MCP server (JSON-RPC 2.0)
/.well-known/mcp.jsonMCP discovery card
/.well-known/agent.jsonAgent commerce discovery card
/llms.txtLLM & shopping-agent plain-text guide
/api/agent/manifestFull machine-readable commerce manifest
/api/agent/openapi.jsonScoped public OpenAPI 3.0 spec (ChatGPT Actions)
/api/agent/destinationsAll valid Nigerian delivery states & codes
/api/agent/searchCatalogue search with landed NGN delivery pricing
/api/agent/listings/{idOrSlug}Single product JSON inspection & landed quote
/api/agent/quoteAuthoritative basket quote
/api/agent/ordersCreate order + Virtual Account / payment URL
/api/agent/orders/{reference}Order state & nextAction polling
AI Agent & MCP FAQ
Does Kiki have a public Model Context Protocol (MCP) server for AI agent shopping in Nigeria?
Yes. Kiki operates a public, unauthenticated Streamable HTTP MCP server at https://kiki.com.ng/mcp (and https://api.xrnet.tech/api/mcp) with discovery metadata at https://kiki.com.ng/.well-known/mcp.json. AI assistants including Claude, ChatGPT, Cursor, and OpenClaw can search 80,000+ Nigerian listings, compute courier landed costs across all 37 states + FCT, quote baskets, and create orders without scraping or API keys.
Do AI agents need browser automation or have to parse Kiki's 3D and AR features?
No. Kiki's interactive 3D previews, AR placement, and Virtual Try-On are strictly for human shoppers. Autonomous AI agents bypass the visual UI completely by calling the MCP server or structured /api/agent/* JSON endpoints, which expose clean titles, conditions, stock/fulfilment classes, variants, and landed courier fees.
How do AI agents pay in Naira (₦) on Kiki without hitting a Paystack card OTP hurdle?
Calling kiki_create_order (or POST /api/agent/orders) with the default bank_transfer channel returns payment.bankTransfer — a dedicated Nigerian Virtual Account (bank name, account number, collision-free exact NGN amount, and narration token) that settles automatically via webhook with zero browser popup or card OTP. Agents can also pass paymentChannel: 'pay_on_delivery' for eligible orders or share payment.url for hosted Paystack checkout.
How do Claude, Cursor, ChatGPT, and OpenClaw connect to Kiki?
Add https://kiki.com.ng/mcp as a Streamable HTTP MCP server (for Claude Code: 'claude mcp add --transport http kiki https://kiki.com.ng/mcp'), or import https://api.xrnet.tech/api/agent/openapi.json into ChatGPT Custom Actions and agent tool runners.