posokanei-mcp
Unofficial read-only MCP server for querying PosoKanei supermarket product and price data.
Search products by Greek or English text with pagination, sorting, and page-size limits.
Get product details and current retailer prices by product ID.
Look up products by 8-, 12-, or 13-digit EAN/GTIN barcode.
List products in a category, sorted by name, price, or unit price, with optional international filtering.
Browse a simplified category tree and list known retailers.
Fetch product details with price history when available.
Compare competitor or comparable product data for a product ID when available.
Compare a small shopping basket of up to 25 items across retailers using product IDs, barcodes, or search queries.
Retrieve high-level PosoKanei dataset statistics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@posokanei-mcp search for olive oil"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
posokanei-mcp
Unmaintained / deprecated — 14 November 2026 This was a personal experiment and is no longer maintained. No further updates, security fixes, or support are planned. The npm package and MCP Registry listing are being deprecated; the source remains available for reference under its existing license. Do not rely on this project for a maintained integration.
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.
Related MCP server: mcp-plu-upc
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 buildTools
Tool | Purpose |
| Search products by text. |
| Get details and retailer prices for a product id. |
| Find product prices by EAN/GTIN barcode. |
| List category products, sorted by unit price by default. |
| Return a simplified category tree. |
| List known retailers. |
| Fetch product detail with history when available. |
| Fetch comparable/competitor product data when available. |
| Compare a small basket across retailers. |
| Return high-level dataset stats. |
Configuration
Optional environment variables:
Variable | Default | Purpose |
|
| API base URL. |
|
| In-memory cache TTL. |
|
| Minimum delay between outbound API requests. |
|
| Request timeout. |
Development
npm install
npm run typecheck
npm testThe test suite mocks the PosoKanei API. It should not require live network access.
License
MIT
Available Tools
10 toolscompare_basketA
Compare a small shopping basket across retailers. Items can be product ids, barcodes, or search queries. Query matching uses the first search result.
Inputs: items (required).
compare_competitorsC
Get competitor or comparable product data for one product id when available.
Inputs: productId (required), retailer, includeTax.
get_price_historyC
Get product details including price history when available from PosoKanei.
Inputs: productId (required), countries, priceType, includeTax.
get_productB
Get details and retailer prices for one PosoKanei product id.
Inputs: productId (required), countries, includeTax, sortRetailers.
get_statsB
Get high-level PosoKanei dataset stats.
Inputs: no named parameters.
list_categoriesB
List PosoKanei product categories. The default response is simplified because the full tree is very large.
Inputs: maxDepth, maxItems, includeCounts, includeHidden.
list_products_by_categoryC
List products in a PosoKanei category id, sorted by unit price by default.
Inputs: category (required), page, sortBy, pageSize, +2 more.
list_retailersB
List retailers known to PosoKanei.
Inputs: countries.
lookup_barcodeB
Find a product by EAN/GTIN barcode and return current supermarket prices.
Inputs: barcode (required), countries, includeTax.
search_productsA
Search PosoKanei supermarket products by Greek or English product text. Returns current price summaries and retailer prices.
Inputs: query (required), page, sortBy, pageSize, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
All tools have clearly distinct purposes: search by text, ID, barcode, category, list categories, retailers, stats, price history, competitor comparison, and basket comparison. No overlapping functionality.
All tool names follow a consistent verb_noun pattern in snake_case (search_products, get_product, lookup_barcode, list_categories, compare_basket, etc.).
10 tools is well-scoped for a supermarket product and pricing database, covering the essential operations without excess or deficiency.
The tool set covers the main use cases (search, browse categories, barcode lookup, price history, competitor comparison, basket comparison). Minor gaps like retailer-specific filtering or trending data exist but do not hinder core functionality.
Maintenance
Related MCP Connectors
Read-only shopping decisions, product search, offers, and price history for Greece.
MCP server for real-time product search by barcode (EAN, UPC, GTIN) or keyword on ean-search.org
Federated commerce search across independent WooCommerce merchants. Keyless, read-only MCP server.
Unlock the power of food transparency with our Open Food Facts MCP server. Easily look up any food
Related MCP Servers
- FlicenseAqualityBmaintenanceA Model Context Protocol server for real-time Swiss grocery shopping that searches and compares products across 8 major Swiss retailers (Migros, Coop, Aldi, Denner, Lidl, Farmy, Volgshop, Otto’s), normalizes per-unit prices, surfaces promotions, computes optimal multi-store shopping plans, and works with any MCP-compatible client without API keys or accounts.7255 npm44-
- FlicenseNot gradedqualityBmaintenanceMCP server for looking up product information by UPC, EAN, GTIN barcodes and PLU produce codes.-
- AlicenseAqualityBmaintenanceA local MCP server for grocery shopping, enabling product search, specials, and browsing across NZ supermarkets, with cart and order history for Countdown/Woolworths via browser-assisted login.141MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that provides a queryable, agent-native layer over Israeli supermarket price transparency feeds, enabling Hebrew product search, online delivery optimization, and cross-chain price comparison.1Apache 2.0