Kapruka MCP — Claude Code MCP server for the Kapruka.com store
Gives your coding agent the Kapruka.com REST API as MCP tools, so it can look up products and place orders from the chat.
claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcpWhat Kapruka MCP does
Kapruka MCP is a Python server that turns the Kapruka.com REST API into tools for LLMs and MCP clients. It is built on FastMCP, talks to the store through an async httpx client with error handling, and splits its tools into modules by area such as products and orders. Settings come from environment variables. A small developer CLI, cli.py, starts the server, pings the API and lists the registered tools.
Most people will just point a client at https://mcp.kapruka.com/mcp. Self-hosting takes more: a Python virtual environment, the dev dependencies, and a .env holding the Kapruka API URL and key. Without that key the local copy has nothing to talk to. The server runs on streamable HTTP at port 8000; --stdio is there for MCP Inspector sessions.
Partner access is a separate path. Callers who can't be IP-allowlisted identify themselves with an X-Partner-Key header and can carry per-customer limits in X-Partner-Customer-Id; both are set through PARTNER_KEYS, PARTNER_SCOPES and PARTNER_LIMITS. That is server-side configuration, not something you touch when wiring the MCP server into an editor.
What it helps with
- browse the Kapruka.com catalogue from an agent
- place a store order through MCP tools
- verify the Kapruka REST API is reachable
- list which MCP tools the server registered
- let a trusted partner in without an IP allowlist
Example prompts for the agent
- Find a gift on Kapruka under 5000 rupees and show me the options
- Order this item with delivery to Colombo
- Which Kapruka tools are currently connected?
How to install Kapruka MCP
Platform CLI: remote server
claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcpPlatform CLI: remote server
codex mcp add kapruka-mcp --url https://mcp.kapruka.com/mcpConfig file
{
"mcpServers": {
"kapruka-mcp": {
"url": "https://mcp.kapruka.com/mcp"
}
}
}Config file
{
"servers": {
"kapruka-mcp": {
"type": "http",
"url": "https://mcp.kapruka.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http kapruka-mcp https://mcp.kapruka.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Kapruka MCP
How do I install Kapruka MCP in Claude Code?
Run claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcp.
What does Kapruka MCP do?
It exposes Kapruka.com store functions to an agent through the REST API, grouped into tool modules for products, orders and related areas.
What is needed to run the server locally?
Python with a virtual environment, dependencies from pip install -e ".[dev]", and a .env with the Kapruka API URL and key. Start it with python cli.py server.
