Metadata-Version: 2.4
Name: kuantokusta-mcp
Version: 0.1.0
Summary: MCP server for searching products on KuantoKusta.pt price comparator.
License-Expression: MIT
Project-URL: Homepage, https://github.com/ThiagoJacobLannes/kuantokusta-mcp
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<2,>=1.2
Requires-Dist: httpx>=0.27.0
Requires-Dist: beautifulsoup4>=4.12.0
Dynamic: license-file

# kuantokusta-mcp

<!-- mcp-name: io.github.ThiagoJacobLannes/kuantokusta-mcp -->

MCP server for [KuantoKusta.pt](https://www.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](https://docs.astral.sh/uv/)): no clone needed, it runs straight from PyPI.

```bash
claude mcp add kuantokusta -- uvx kuantokusta-mcp
```

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

**From source:**

```bash
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`:

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