# alza-mcp

Community MCP server to search products on Alza.cz, inspect AlzaBox availability, and manage carts with token-protected checkout.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 88
- Author: lukabudik
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lukabudik/alza-mcp-community
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/alza-mcp

## What it does

This server connects MCP-compatible coding assistants directly to Alza.cz. It gathers live catalog data, product specs, and showroom stock via headless browser scraping and store APIs.

Tools are split into selective toolsets. That design keeps the model context light by avoiding dozens of inactive endpoints. Catalog queries and account authentication run by default, while cart management or price drop watchdogs stay off until needed.

Browser-backed calls rely on a headless Chromium download of roughly 92 MB. Submitting an actual order requires an explicit one-time confirmation token, preventing unwanted purchases.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add alza-mcp -- npx -y alza-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add alza-mcp -- npx -y alza-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alza-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "alza-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alza-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "alza-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add alza-mcp npx -y alza-mcp
```

## When to use it
- search live Alza.cz listings by price and rating filters
- verify item availability at specific pickup points or AlzaBox lockers
- compare specifications across competing catalog products
- prepare shopping carts and review delivery options

## Example prompts
- Find top-rated wheel cleaners on Alza under 600 CZK and check Prague pickup spots
- Pull detailed specifications and customer feedback for this Alza item
- Check AlzaBox delivery options for the current basket

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 12927

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md