About Kapruka MCP
Kapruka MCP is a free public MCP server that wraps the REST API of Kapruka.com, a Sri Lankan e-commerce platform. It exposes that API as tools for LLMs and third-party MCP clients.
Key features
- 01Wraps Kapruka.com REST API as tools
- 02Streamable HTTP and stdio transports
- 03Health-check command for the REST API
- 04Partner key authentication for trusted callers
Use cases
- 01Letting an LLM look up products or orders on Kapruka.com
- 02Testing Kapruka endpoints with MCP Inspector
MCP support
A Python MCP server built on FastMCP that exposes Kapruka-related tools to MCP clients over HTTP or stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.kapruka.com/mcpclaude mcp add --transport http com-kapruka-kapruka https://mcp.kapruka.com/mcp{"mcpServers":{"com-kapruka-kapruka":{"type":"http","url":"https://mcp.kapruka.com/mcp"}}}Open in Cursor{"servers":{"com-kapruka-kapruka":{"type":"http","url":"https://mcp.kapruka.com/mcp"}}}Open in VS Code{"mcpServers":{"com-kapruka-kapruka":{"type":"http","url":"https://mcp.kapruka.com/mcp"}}}{"mcpServers":{"com-kapruka-kapruka":{"serverUrl":"https://mcp.kapruka.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
8| Parameter | Type | Required | Description |
|---|---|---|---|
| params | any | Yes |
Details
From the project READMEKapruka 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.