🏆 Kapruka Agent Challenge · Build an AI shopping agent on this MCP and win an Apple M4 Mac Mini Apply →

Plug any LLM into Sri Lanka's
largest local e-commerce enterprise.

A free public MCP server for Kapruka.com. Search products, browse categories, quote delivery, create guest-checkout orders with click-to-pay links, and track existing orders — from Claude, ChatGPT, Cursor, or any MCP-aware client.

MCP endpoint
https://mcp.kapruka.com/mcp
Streamable HTTP transport No auth required 60 requests / min per IP 30 orders / hour per IP

Quick start

Drop one snippet into your client, restart, done.

{
  "mcpServers": {
    "kapruka": {
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}

Save to %APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, then restart Claude Desktop.

{
  "mcpServers": {
    "kapruka": {
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}

Settings → MCP → Add new server, or paste into ~/.cursor/mcp.json.

Server URL:  https://mcp.kapruka.com/mcp
Transport:   Streamable HTTP
Auth:        None

In ChatGPT, open Settings → Connectors → Add MCP server and paste the URL.

npx @modelcontextprotocol/inspector

In the Inspector UI: choose Streamable HTTP, paste https://mcp.kapruka.com/mcp, click Connect.

Available tools

Seven tools for product discovery, delivery quoting, guest checkout, and order tracking — all return structured results in markdown or JSON.

🔍

kapruka_search_products

Search the catalog by keyword with category, price range, stock, and sort filters. Prices are what checkout charges, with website discounts applied and the pre-discount price alongside. Price bounds are in the currency you ask for, and every response lists the category facets you can narrow by. Pagination capped at 3 pages.

qcategorymin_pricemax_pricein_stock_onlysortlimitcursorcurrency
📦

kapruka_get_product

Full details for any product by ID — name, price (discounted, with the was-price when on sale), stock, variants, images, shipping, delivery scope (island-wide, or the selected cities a food / hotel cake / liquor item can reach), and a direct URL.

product_idcurrency
🗂️

kapruka_list_categories

The site's navigation categories with browse URLs. For narrowing a search, use the facet names every search returns instead — the two vocabularies differ.

depth
📍

kapruka_list_delivery_cities

Search Kapruka's delivery network by canonical name or vernacular alias. Returns up to 50 matches per query.

querylimit
🚚

kapruka_check_delivery

Check whether an order can be delivered to a city on a given date, and the delivery fee checkout will charge. The fee depends on the cart and the currency: pass currency and the cart you are about to order for the exact fee. Pass product_id to also check that item's city limit — food, hotel cakes and liquor reach selected cities only — and get the deliverable cities back when it doesn't. With the cart it also shows the cheaper economy delivery option (a courier, a few days) when it saves the customer real money.

citydelivery_dateproduct_idcurrencycartother_items_totalgift_message
🛒

kapruka_create_order

Create a guest-checkout order and return a click-to-pay URL — no Kapruka account required. Prices are locked for 60 minutes, multi-currency, capped at 30 orders/hr per IP. Refused (nothing created) with city_not_deliverable_for_item when any cart item can't reach the delivery city. delivery.type picks standard (default), economy, or international_gift for a recipient abroad.

cartrecipientdeliverysendergift_messagecurrency
🌍

kapruka_gift_countries

International gifts: the countries Kapruka delivers gifts in through local partners (USA, Canada, Australia, UK, UAE, ...), with gifts in stock, the delivery fee per order, delivery zones and the earliest date.

currency
🎁

kapruka_gift_country_products

Every gift in stock in one country's store, grouped by type. Order with kapruka_create_order and delivery.type international_gift.

countrytypecurrency
📦

kapruka_track_order

Look up status, recipient, items, and timestamped delivery progress for any Kapruka order. Customer reads the order number off their confirmation email or order complete page.

order_number

Universal Commerce Protocol (UCP)

Kapruka also speaks UCP (version 2026-08-25): catalog search and lookup, and checkout with delivery options. Agents discover it from kapruka.com/.well-known/ucp; the endpoints are https://mcp.kapruka.com/ucp/v1 (REST) and https://mcp.kapruka.com/ucp/mcp (MCP). A complete checkout hands the buyer to Kapruka's secure pay page through continue_url.

Free tier limits

  • 60 requests per minute per client IP across all tools. Standard RateLimit-* headers on every response.
  • 30 kapruka_create_order calls per hour per client IP, on top of the per-minute cap.
  • Guest checkout — orders create a 60-minute click-to-pay link with locked prices. Customer pays in the browser without logging in.
  • Server-side cache of up to 30 minutes for product / category reads — write endpoints are never cached.
  • Need higher limits, agent partnerships, or commercial integrations? Reach out at hello@kapruka.com.