kuantokusta-mcp

MCP server for KuantoKusta.pt — Portugal's main product price comparator.

Tools

search

Search for products with optional filters. Returns up to 48 products per page sorted by your chosen order (default: cheapest first).

Parameters:

• query — search keywords (e.g. "frigorifico", "iphone 15", "tv 55")

• area — category filter (e.g. "Electrodomésticos", "Informática", "Televisores")

• sort — "cheap" (default) | "expensive" | "popular" | "alphabetical" | "newest"

• price_min / price_max — price range in EUR (integers)

• brands — list of brand names (e.g. ["Samsung", "LG"])

• page — page number (default 1)

get_product

Get full details for a product URL from a search result: name, description, 45+ tech specs, and all store offers sorted by total price (product + shipping).

Install

cd tools/kuantokusta-mcp
python -m pip install -e .

Add to Claude Desktop

Merge claude_desktop_config.snippet.json into your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "kuantokusta": {
      "command": "python",
      "args": ["-m", "kuantokusta_mcp.server"]
    }
  }
}