Posokanei Mcp

io.github.charistasPublished by GitHub account charistasv0.1.1Updated Nov 3, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Unofficial read-only MCP server that lets an assistant search Greek supermarket products, look up barcodes and compare prices across retailers via PosoKanei.

What you can do
  • Search products by text and list products by category, sorted by unit price
  • Look up a product by id or EAN/GTIN barcode and see retailer prices
  • Compare current retailer prices and competitor product data for a product
  • Compare a small shopping basket across retailers
  • Browse the category tree, known retailers and high-level dataset stats
  • Fetch product detail with price history when available
When to use it
Useful when you want an assistant to answer questions about Greek supermarket prices: finding a product, checking what a barcode costs, or comparing a short shopping list across retailers.
Requirements
Runs locally as an npm package (npx posokanei-mcp) under Node.js, configured in the MCP client. No account or API key. Optional environment variables POSOKANEI_API_BASE, POSOKANEI_CACHE_TTL_MS, POSOKANEI_MIN_INTERVAL_MS and POSOKANEI_TIMEOUT_MS tune the endpoint, caching, request spacing and timeout. Needs network access to the PosoKanei API.
Before you install
Read-only, but it calls public, undocumented PosoKanei endpoints, so it may break without notice; keep request volume modest. It is not affiliated with PosoKanei, gov.gr or any Greek public authority. Product queries are sent to that third-party API.

Installation

In SourceWeft

  1. Open Posokanei Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

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

For local development:

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

Build first:

sh
npm installnpm 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

sh
npm installnpm run typechecknpm test

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

License

MIT

Source: README.md at commit 444be79

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts