Skip to main content
Glama
posokanei-mcp
by charistas

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

Available Tools

10 tools
compare_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

    A3.5/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (search_products, get_product, lookup_barcode, list_categories, compare_basket, etc.).

    Tool Count5/5

    10 tools is well-scoped for a supermarket product and pricing database, covering the essential operations without excess or deficiency.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      A 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.
      7
      255 npm
      44
      -
    • A
      license
      A
      quality
      B
      maintenance
      A 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.
      14
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An 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.
      1
      Apache 2.0