posokanei-mcp

Unofficial read-only MCP server for supermarket product and price data from PosoKanei.

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:

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

For local development:

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

Build first:

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

npm install
npm run typecheck
npm test

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

License

MIT