MCP Server

Active

Kapruka MCP MCP Server

com.kapruka/kapruka-mcp

Access Sri Lanka's largest e-commerce platform Kapruka.com via MCP tools for product search, orders, and more.

What is the Kapruka MCP MCP server?

The Kapruka MCP server is a Python MCP server that wraps the Kapruka.com REST API and exposes it as tools for LLMs and MCP clients. It enables AI agents to interact with Sri Lanka's largest e-commerce platform for product queries, order management, and related operations.

This server bridges Kapruka.com, Sri Lanka's leading e-commerce platform, with AI agents through the Model Context Protocol. It provides structured access to product data, orders, and other e-commerce operations, allowing Claude and other LLM-based tools to query and interact with Kapruka's catalog and services.

How to install Kapruka MCP

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

~/.cursor/mcp.json

{
  "mcpServers": {
    "kapruka-mcp": {
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

Product tools — Tools for searching and retrieving product information from Kapruka.com
Order tools — Tools for managing and querying orders on the Kapruka platform

Use cases

Search for products on Kapruka.com and retrieve detailed information
Look up order status and history
Integrate Kapruka e-commerce data into AI-powered applications
Build chatbots that can query Kapruka's product catalog
Automate product discovery and comparison tasks

Kapruka MCP MCP server FAQ

What is the Kapruka MCP server?

It's a free MCP server that wraps Kapruka.com's REST API, allowing AI agents like Claude to search products, manage orders, and interact with Sri Lanka's largest e-commerce platform.

Is this server free to use?

Yes, it is a free public MCP server provided by Kapruka.

How do I connect it in Cursor or Claude?

Use the remote streamable-HTTP connection at https://mcp.kapruka.com/mcp, or run it locally by cloning the repository and starting the server with `python cli.py server`.

Do I need authentication?

Yes, you need to configure a Kapruka API URL and key in the .env file to authenticate with the Kapruka REST API.

What tools does it expose?

The server exposes product search and retrieval tools, as well as order management and query tools for interacting with Kapruka.com.

Can I run it locally?

Yes, you can clone the repository, set up a Python virtual environment, install dependencies, configure your .env file, and run `python cli.py server` to start it locally.

README (reference)

Source of truth, from the repository.

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

Running Tests

pytest

Related MCP servers

Python

MIT

View repository →

Kawaa email verification

Check whether an email address can receive mail — one address or a list — without sending to it.

com.kazejev/profile

Maintained

Profile server for kazejev.com: biography, skills, projects and education.

TypeScript