mcpField
K
KuantoKusta

KuantoKusta

Local
thiagolannes.comSearch0Updated 5d ago
RepositoryVisit website

About KuantoKusta

KuantoKusta is an MCP server for comparing product prices across Portuguese stores. It lets shoppers search with category, price, brand, and sort filters, then inspect product specifications and offers including shipping.

Key features

  1. 01Product search with filters
  2. 02Sort by price, popularity, and date
  3. 03Product descriptions and 45+ specs
  4. 04Store offers sorted by total price

Use cases

  1. 01Compare prices for a product in Portugal
  2. 02Narrow searches by brand or budget
  3. 03Review specifications and shipping-inclusive offers

MCP support

Exposes product search and product-detail tools to MCP clients, including search results and store offers.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "thiagojacoblannes-kuantokusta": {
      "command": "uvx",
      "args": [
        "kuantokusta-mcp"
      ]
    }
  }
}
Run commanduvx kuantokusta-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypikuantokusta-mcp0.1.0

Tools

2

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
areaanyNo
pageintegerNo
sortstringNo
querystringYes
brandsanyNo
familyanyNo
featuresanyNo
price_maxanyNo
price_minanyNo

Details

From the project README

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

Quickest (needs uv): no clone needed, it runs straight from PyPI.

claude mcp add kuantokusta -- uvx kuantokusta-mcp

For Claude Desktop, use "command": "uvx", "args": ["kuantokusta-mcp"].

From source:

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"]
    }
  }
}

Comments

Markdown supported

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.