About posokanei-mcp
posokanei-mcp is an unofficial, read-only MCP server for Greek supermarket product and price data from PosoKanei. It helps MCP clients search products, check retailer prices, and compare shopping baskets.
Key features
- 01Search products by name or barcode
- 02View product details and retailer prices
- 03Browse categories and retailers
- 04Check price history and comparable products
- 05Compare small baskets across retailers
Use cases
- 01Find a product using its name or barcode
- 02Compare current prices across retailers
- 03Review a product’s available price history
- 04Estimate basket costs at different retailers
MCP support
Exposes PosoKanei product, price, category, retailer, history, and comparison data through tools for MCP clients. It is read-only.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y posokanei-mcpPOSOKANEI_API_BASEOptional PosoKanei API base URL override.POSOKANEI_CACHE_TTL_MSOptional cache TTL in milliseconds.POSOKANEI_MIN_INTERVAL_MSOptional minimum delay between outbound PosoKanei API requests.POSOKANEI_TIMEOUT_MSOptional outbound request timeout in milliseconds.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
10Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Result page. |
| query | string | Yes | Product search text, for example 'γάλα' or 'feta'. |
| sortBy | enum | No | Sort field.name | price | unit_price |
| pageSize | integer | No | Results per page. Capped at 50. |
| sortOrder | enum | No | Sort order.asc | desc |
Details
From the project READMEposokanei-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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.