# posokanei-mcp

This MCP server exposes Greek supermarket products and prices to AI clients. Use it to search items, check retailers, and compare a small basket.

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

## What it does

posokanei-mcp lets an MCP client query PosoKanei data for Greek supermarkets. An agent can search by product name or barcode, retrieve retailer prices, browse categories, and list retailers.

Its tools also cover price history when available, comparable products, small-basket comparisons, and high-level dataset statistics. Requests use public API endpoints that are not documented, so an API change can break the server. Cache duration, request spacing, API base, and timeout are configurable with `POSOKANEI_CACHE_TTL_MS`, `POSOKANEI_MIN_INTERVAL_MS`, `POSOKANEI_API_BASE`, and `POSOKANEI_TIMEOUT_MS`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `POSOKANEI_API_BASE`, `POSOKANEI_CACHE_TTL_MS`, `POSOKANEI_MIN_INTERVAL_MS`, `POSOKANEI_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env POSOKANEI_API_BASE=<POSOKANEI_API_BASE> --env POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS> --env POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS> --env POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS> --transport stdio posokanei-mcp -- npx -y posokanei-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add posokanei-mcp --env POSOKANEI_API_BASE=<POSOKANEI_API_BASE> --env POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS> --env POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS> --env POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS> -- npx -y posokanei-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "posokanei-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "posokanei-mcp"
            ],
            "env": {
                "POSOKANEI_API_BASE": "<POSOKANEI_API_BASE>",
                "POSOKANEI_CACHE_TTL_MS": "<POSOKANEI_CACHE_TTL_MS>",
                "POSOKANEI_MIN_INTERVAL_MS": "<POSOKANEI_MIN_INTERVAL_MS>",
                "POSOKANEI_TIMEOUT_MS": "<POSOKANEI_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "posokanei-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "posokanei-mcp"
            ],
            "env": {
                "POSOKANEI_API_BASE": "<POSOKANEI_API_BASE>",
                "POSOKANEI_CACHE_TTL_MS": "<POSOKANEI_CACHE_TTL_MS>",
                "POSOKANEI_MIN_INTERVAL_MS": "<POSOKANEI_MIN_INTERVAL_MS>",
                "POSOKANEI_TIMEOUT_MS": "<POSOKANEI_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e POSOKANEI_API_BASE=<POSOKANEI_API_BASE> -e POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS> -e POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS> -e POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS> posokanei-mcp npx -y posokanei-mcp
```
Replace <…> with your own values

## When to use it
- search for a product by name or barcode
- compare current prices across retailers
- check a small basket against different stores
- browse product categories and retailers
- retrieve available price history

## Example prompts
- Find this product by its barcode and compare the retailer prices.
- Compare this small shopping basket across retailers and show the cheapest option.
- Browse the available product categories and list the retailers.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
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