# Kapruka MCP

> Kapruka MCP is a free MCP server for e-commerce. Search Kapruka's Sri Lankan catalogue, quote delivery and create pay-link orders. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://mcp.kapruka.com
- **Repository:** https://github.com/kapruka/mcp
- **MCP Registry name:** com.kapruka/kapruka-mcp
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

This is the public MCP server for Kapruka.com, a Sri Lankan e-commerce site. An assistant can look up products and categories, check whether an order can reach a given city on a given date, and place a guest-checkout order that returns a click-to-pay link, so no Kapruka account is needed. Order tracking uses the order number from the confirmation email.

Several details are built around gifting. Food, hotel cakes and liquor reach only selected cities, so delivery checks return the deliverable cities when an item cannot go to the chosen one. A separate pair of tools covers international gifts, listing the countries Kapruka serves through local partners and the gifts in stock in each. Prices are locked for 60 minutes when an order is created, and order creation is capped at 30 per hour per IP.

The server is free and needs no authentication. The Python source in the repository wraps the Kapruka REST API, and the site also describes support for the Universal Commerce Protocol with REST and MCP endpoints.

## Features

- **Product search:** Keyword search with category, price, stock and sort filters, up to 3 pages.
- **Delivery quotes:** Checks city, date and fee, and offers a cheaper economy option when available.
- **Guest checkout:** Creates an order and returns a click-to-pay link without an account.
- **International gifts:** Lists partner countries and gifts in stock for each.
- **Order tracking:** Shows status, items and timestamped delivery progress.
- **Multi-currency prices:** Prices shown are what checkout charges, with discounts applied.

## Good for

- Find a gift and check it can be delivered to a city by a date
- Send a gift to a recipient abroad
- Compare delivery fees for a cart
- Follow up on an existing order

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.kapruka.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kapruka-mcp": {
      "type": "http",
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kapruka-mcp": {
      "serverUrl": "https://mcp.kapruka.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kapruka-mcp": {
      "type": "http",
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}
```

## Tools

- `kapruka_search_products`: Searches the catalogue by keyword with category, price, stock and sort filters.
- `kapruka_get_product`: Returns full details for a product by ID.
- `kapruka_list_categories`: Lists the site's navigation categories with browse URLs.
- `kapruka_list_delivery_cities`: Searches the delivery network by city name or alias.
- `kapruka_check_delivery`: Checks whether an order can be delivered to a city on a date and the fee.
- `kapruka_create_order`: Creates a guest-checkout order and returns a click-to-pay URL.
- `kapruka_gift_countries`: Lists countries for international gifts with fees and zones.
- `kapruka_gift_country_products`: Lists gifts in stock in one country's store.
- `kapruka_track_order`: Looks up status and delivery progress for an order.

## FAQ

### Is it free to use?

Yes, a free public server with no authentication.

### Do I need a Kapruka account to order?

No. Guest checkout returns a pay link.

### Which limits apply?

Search pagination is capped at 3 pages and order creation at 30 per hour per IP.

### How long are prices locked?

60 minutes after an order is created.

### Which clients work?

Claude, ChatGPT, Cursor and other MCP clients.

### Is Kapruka MCP free?

Yes. Kapruka MCP is free to use.

### How do I add Kapruka MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcp

### What are the best alternatives to Kapruka MCP?

The closest alternatives to Kapruka MCP are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/kapruka-mcp
