Kapruka MCP Server

What your AI can do with it

• Connect your AI to Kapruka.com, Sri Lanka's largest e-commerce platform
• Browse products available on Kapruka.com
• Look up prices on Kapruka.com
• Use the connection at no cost

Install Kapruka MCP Server

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

• Claude Code

  claude mcp add --transport http --scope user kapruka-mcp-server 'https://mcp.kapruka.com/mcp'Copy

  Run it once in your project, then open /mcp to approve any sign-in the server asks for.

• Claude Desktop

  https://mcp.kapruka.com/mcpCopy

  Add a custom connector in Settings, paste this address, and approve the sign-in.

• Cursor

  cursor://anysphere.cursor-deeplink/mcp/install?name=kapruka-mcp-server&config=eyJ1cmwiOiJodHRwczovL21jcC5rYXBydWthLmNvbS9tY3AifQ==Copy

  Open the link and Cursor adds the server at that address.

• ChatGPT

  https://mcp.kapruka.com/mcpCopy

  In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

• Codex

  codex mcp add kapruka-mcp-server --url 'https://mcp.kapruka.com/mcp'Copy

  Run it once, then sign in with codex mcp login kapruka-mcp-server if the server asks for an account.

From the project's README

As published by kapruka/mcp in README.md.

# 1. Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

# 2. Install dependencies
pip install -e ".[dev]"

# 3. Configure environment
cp .env.example .env
# Edit .env with your Kapruka API URL and key

# Start the MCP server (streamable HTTP, default port 8000)
python cli.py server

# Start with stdio transport (for use with MCP Inspector)
python cli.py server --stdio

# Health-check the Kapruka REST API
python cli.py ping

# List registered MCP tools
python cli.py tools

npx @modelcontextprotocol/inspector python cli.py server --stdio

src/
  server.py        # FastMCP server entry point
  tools/           # One module per tool group (products, orders, …)
  api/
    client.py      # Async httpx client + error handling
  config/
    settings.py    # Env-based configuration
tests/             # pytest test suite
cli.py             # Developer CLI

pytest

Tools it offers (8)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

• kapruka_list_categories
• kapruka_get_product
• kapruka_search_products
• kapruka_create_order
• kapruka_track_order
• kapruka_render_options_card
• kapruka_list_delivery_cities
• kapruka_check_delivery

Signals

GitHub stars

21

Forks

15

Last commit

Sep 2026