# Kapruka MCP

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/kapruka/mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kapruka-mcp

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "kapruka-mcp": {
    "command": "npx",
    "args": ["-y","kapruka-mcp"]
  }
}
```

## Documentation & README

# 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

```bash
# 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

```bash
# 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

```bash
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
```

## Running Tests

```bash
pytest
```