English Français العربية

Kapruka MCP

Official registry E-commerce

Free public MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http kapruka-mcp 'https://mcp.kapruka.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kapruka-mcp": {
            "type": "http",
            "url": "https://mcp.kapruka.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Kapruka MCP Server
  2. Setup
  3. Running
  4. Testing with MCP Inspector
  5. Project Structure
  6. Trusted partners
  7. Running Tests

Kapruka MCP Server

Python MCP server that wraps the Kapruka.com REST API and exposes it as tools for LLMs and third-party MCP clients.

Setup

# 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

Running

# 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

Testing with MCP Inspector

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

Project Structure

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

Trusted partners

First-party callers that can't be IP-allowlisted (e.g. Kapruka's web assistant on Cloudflare Workers) authenticate with an X-Partner-Key header instead, with optional per-customer limits via X-Partner-Customer-Id. Configured with PARTNER_KEYS / PARTNER_SCOPES / PARTNER_LIMITS. See docs/PARTNER_ACCESS.md and the deploy steps in deploy/README.md.

Running Tests

pytest

Frequently asked questions

What is Kapruka MCP?

Free public MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform.

How do I install Kapruka MCP?

It runs as a remote server. In Claude Code: claude mcp add --transport http kapruka-mcp 'https://mcp.kapruka.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Kapruka MCP need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Kapruka MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Kapruka MCP?

It is published by kapruka. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.