English Français العربية

io.github.charistas/posokanei-mcp

Official registry E-commerce

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package posokanei-mcp
Claude Code 
claude mcp add posokanei-mcp -e 'POSOKANEI_API_BASE=<POSOKANEI_API_BASE>' -e 'POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS>' -e 'POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS>' -e 'POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS>' -- npx -y posokanei-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "posokanei-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "posokanei-mcp@0.1.1"
            ],
            "env": {
                "POSOKANEI_API_BASE": "<POSOKANEI_API_BASE>",
                "POSOKANEI_CACHE_TTL_MS": "<POSOKANEI_CACHE_TTL_MS>",
                "POSOKANEI_MIN_INTERVAL_MS": "<POSOKANEI_MIN_INTERVAL_MS>",
                "POSOKANEI_TIMEOUT_MS": "<POSOKANEI_TIMEOUT_MS>"
            }
        }
    }
}

Environment variables

  • POSOKANEI_API_BASE Optional PosoKanei API base URL override.
  • POSOKANEI_CACHE_TTL_MS Optional cache TTL in milliseconds.
  • POSOKANEI_MIN_INTERVAL_MS Optional minimum delay between outbound PosoKanei API requests.
  • POSOKANEI_TIMEOUT_MS Optional outbound request timeout in milliseconds.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. posokanei-mcp
  2. Status
  3. Installation
  4. Tools
  5. Configuration
  6. Development
  7. License

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:

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

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

npm install
npm run typecheck
npm test

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

License

MIT

Frequently asked questions

What is io.github.charistas/posokanei-mcp?

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

How do I install io.github.charistas/posokanei-mcp?

It runs on your machine. In Claude Code: claude mcp add posokanei-mcp -e 'POSOKANEI_API_BASE=<POSOKANEI_API_BASE>' -e 'POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS>' -e 'POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS>' -e 'POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS>' -- npx -y posokanei-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.charistas/posokanei-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.charistas/posokanei-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.charistas/posokanei-mcp?

It is published by charistas. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.