# posokanei-mcp [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/charistas/posokanei-mcp  
**GitHub Stars:** 6  
**npm Downloads (last month):** 175  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/posokanei-mcp

## Description
Unofficial read-only MCP server for Greek supermarket price data from PosoKanei.

## Tools
Capabilities this server exposes over MCP:

- **search_products** — Search PosoKanei supermarket products by Greek or English product text. Returns current price summaries and retailer prices.
- **get_product** — Get details and retailer prices for one PosoKanei product id.
- **lookup_barcode** — Find a product by EAN/GTIN barcode and return current supermarket prices.
- **list_products_by_category** — List products in a PosoKanei category id, sorted by unit price by default.
- **list_categories** — List PosoKanei product categories. The default response is simplified because the full tree is very large.
- **list_retailers** — List retailers known to PosoKanei.
- **get_price_history** — Get product details including price history when available from PosoKanei.
- **compare_competitors** — Get competitor or comparable product data for one product id when available.
- **compare_basket** — Compare a small shopping basket across retailers. Items can be product ids, barcodes, or search queries. Query matching uses the first search result.
- **get_stats** — Get high-level PosoKanei dataset stats.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "posokanei-mcp": {
    "command": "npx",
    "args": ["-y","posokanei-mcp"]
  }
}
```

## Documentation & README

# posokanei-mcp

Unofficial read-only MCP server for supermarket product and price data from [PosoKanei](https://posokanei.gov.gr/).

This server lets MCP-compatible clients ask questions such as:

- Search for supermarket products by name.
- Look up a product by barcode.
- Compare current retailer prices for a product.
- Compare a small shopping basket across retailers.
- Browse product categories and retailers.

## Status

Early open-source version. The implementation uses public, undocumented endpoints used by the PosoKanei web app. Keep requests modest and cache-friendly.

This project is not affiliated with, endorsed by, or operated by PosoKanei, gov.gr, or any Greek public authority.

## Installation

Add it to your MCP client configuration:

```json
{
  "mcpServers": {
    "posokanei": {
      "command": "npx",
      "args": ["-y", "posokanei-mcp"]
    }
  }
}
```

For local development:

```json
{
  "mcpServers": {
    "posokanei": {
      "command": "node",
      "args": ["/absolute/path/to/posokanei-mcp/dist/index.js"]
    }
  }
}
```

Build first:

```sh
npm install
npm run build
```

## Tools

| Tool | Purpose |
| --- | --- |
| `search_products` | Search products by text. |
| `get_product` | Get details and retailer prices for a product id. |
| `lookup_barcode` | Find product prices by EAN/GTIN barcode. |
| `list_products_by_category` | List category products, sorted by unit price by default. |
| `list_categories` | Return a simplified category tree. |
| `list_retailers` | List known retailers. |
| `get_price_history` | Fetch product detail with history when available. |
| `compare_competitors` | Fetch comparable/competitor product data when available. |
| `compare_basket` | Compare a small basket across retailers. |
| `get_stats` | Return high-level dataset stats. |

## Configuration

Optional environment variables:

| Variable | Default | Purpose |
| --- | --- | --- |
| `POSOKANEI_API_BASE` | `https://api.posokanei.gov.gr` | API base URL. |
| `POSOKANEI_CACHE_TTL_MS` | `300000` | In-memory cache TTL. |
| `POSOKANEI_MIN_INTERVAL_MS` | `250` | Minimum delay between outbound API requests. |
| `POSOKANEI_TIMEOUT_MS` | `15000` | Request timeout. |

## Development

```sh
npm install
npm run typecheck
npm test
```

The test suite mocks the PosoKanei API. It should not require live network access.

## License

MIT