Back to Browse

Posokanei MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (3 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

10 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional PosoKanei API base URL override.Optional

Environment variable: POSOKANEI_API_BASE

Optional cache TTL in milliseconds.Optional

Environment variable: POSOKANEI_CACHE_TTL_MS

Optional minimum delay between outbound PosoKanei API requests.Optional

Environment variable: POSOKANEI_MIN_INTERVAL_MS

Optional outbound request timeout in milliseconds.Optional

Environment variable: POSOKANEI_TIMEOUT_MS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-charistas-posokanei-mcp": {
      "env": {
        "POSOKANEI_API_BASE": "your-posokanei-api-base-here",
        "POSOKANEI_TIMEOUT_MS": "your-posokanei-timeout-ms-here",
        "POSOKANEI_CACHE_TTL_MS": "your-posokanei-cache-ttl-ms-here",
        "POSOKANEI_MIN_INTERVAL_MS": "your-posokanei-min-interval-ms-here"
      },
      "args": [
        "-y",
        "posokanei-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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:

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

Reviews

No reviews yet

Be the first to review this server!