Posokanei MCP logo

Posokanei MCP

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

Install Posokanei MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "posokanei-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "posokanei-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 10 tools correctly (8d ago).

Overview

Tools10

What Posokanei MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 47d

What it can do

From the 10 tools this server returned when we ran it.

Read-only tools · 10
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age125 days
Maintainers1

Observed 2026-10-21 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · posokanei-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads175Package downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed10Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

From the project README

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:

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

For local development:

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

Build first:

Terminal
npm install
npm run build

Tools

ToolPurpose
search_productsSearch products by text.
get_productGet details and retailer prices for a product id.
lookup_barcodeFind product prices by EAN/GTIN barcode.
list_products_by_categoryList category products, sorted by unit price by default.
list_categoriesReturn a simplified category tree.
list_retailersList known retailers.
get_price_historyFetch product detail with history when available.
compare_competitorsFetch comparable/competitor product data when available.
compare_basketCompare a small basket across retailers.
get_statsReturn high-level dataset stats.

Configuration

Optional environment variables:

VariableDefaultPurpose
POSOKANEI_API_BASEhttps://api.posokanei.gov.grAPI base URL.
POSOKANEI_CACHE_TTL_MS300000In-memory cache TTL.
POSOKANEI_MIN_INTERVAL_MS250Minimum delay between outbound API requests.
POSOKANEI_TIMEOUT_MS15000Request timeout.

Development

Terminal
npm install
npm run typecheck
npm test

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

License

MIT

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Posokanei MCP

posokanei-mcp is an MCP server that provides read-only access to Greek supermarket product and price data from PosoKanei. It supports product searches, barcode lookups, retailer price comparisons, basket comparisons, category and retailer browsing, price history when available, competitor data when available, and high-level dataset statistics. It is unofficial.

Install it by adding a server entry that runs npx with the package name: command "npx" and args ["-y", "posokanei-mcp"]. For local development, build the project and run its dist/index.js file with Node.

Yes, use search_products to search by product name or text, and lookup_barcode to find product prices by an EAN or GTIN barcode. The get_product tool retrieves details and retailer prices for a product ID.

Yes, compare_competitors can fetch comparable product data when available, while compare_basket compares a small shopping basket across retailers. Product-level retailer prices are also available through get_product.

The server supports optional environment variables for the API base URL, cache TTL, minimum delay between outbound requests, and request timeout: POSOKANEI_API_BASE, POSOKANEI_CACHE_TTL_MS, POSOKANEI_MIN_INTERVAL_MS, and POSOKANEI_TIMEOUT_MS.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPosokanei MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/posokanei-mcp?style=directory)](https://allmcps.com/mcp/posokanei-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/posokanei-mcp"><img src="https://allmcps.com/api/badge/posokanei-mcp?style=directory" alt="Posokanei MCP on AllMCPs" /></a>