MCP READY · NO API KEY REQUIRED · NIGERIA (NGN)

    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.

    Quick Start

    Connect Your AI Agent in Seconds

    Claude Code (Streamable HTTP MCP)
    claude mcp add --transport http kiki https://kiki.com.ng/mcp
    Claude Desktop / Cursor / OpenClaw mcp.json
    {
      "mcpServers": {
        "kiki": {
          "type": "streamable-http",
          "url": "https://kiki.com.ng/mcp"
        }
      }
    }
    REST & MCP Quick Verification (curl)
    # 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.json
    Test SSR Search

    MCP Tools & Capabilities

    Exposed on both https://kiki.com.ng/mcp and https://api.xrnet.tech/api/mcp.

    MCP ToolREST EquivalentWhat It Does
    kiki_searchGET /api/agent/searchSearch 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_listingGET /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_quotePOST /api/agent/quoteGet 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_orderPOST /api/agent/ordersCreate 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_statusGET /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_destinationsGET /api/agent/destinationsList all 37 Nigerian states + FCT and every accepted spelling, two-letter code ('LA'), and ISO 3166-2 code ('NG-LA').

    Public Discovery & Commerce Endpoints

    POST
    /mcp

    Streamable HTTP MCP server (JSON-RPC 2.0)

    GET
    /.well-known/mcp.json

    MCP discovery card

    GET
    /.well-known/agent.json

    Agent commerce discovery card

    GET
    /llms.txt

    LLM & shopping-agent plain-text guide

    GET
    /api/agent/manifest

    Full machine-readable commerce manifest

    GET
    /api/agent/openapi.json

    Scoped public OpenAPI 3.0 spec (ChatGPT Actions)

    GET
    /api/agent/destinations

    All valid Nigerian delivery states & codes

    GET
    /api/agent/search

    Catalogue search with landed NGN delivery pricing

    GET
    /api/agent/listings/{idOrSlug}

    Single product JSON inspection & landed quote

    POST
    /api/agent/quote

    Authoritative basket quote

    POST
    /api/agent/orders

    Create order + Virtual Account / payment URL

    GET
    /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.