{
  "markdown": "# posokanei-mcp\n\nUnofficial read-only MCP server for supermarket product and price data from [PosoKanei](https://posokanei.gov.gr/).\n\nThis server lets MCP-compatible clients ask questions such as:\n\n- Search for supermarket products by name.\n- Look up a product by barcode.\n- Compare current retailer prices for a product.\n- Compare a small shopping basket across retailers.\n- Browse product categories and retailers.\n\n## Status\n\nEarly open-source version. The implementation uses public, undocumented endpoints used by the PosoKanei web app. Keep requests modest and cache-friendly.\n\nThis project is not affiliated with, endorsed by, or operated by PosoKanei, gov.gr, or any Greek public authority.\n\n## Installation\n\nAdd it to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"posokanei\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"posokanei-mcp\"]\n    }\n  }\n}\n```\n\nFor local development:\n\n```json\n{\n  \"mcpServers\": {\n    \"posokanei\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/posokanei-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\nBuild first:\n\n```sh\nnpm install\nnpm run build\n```\n\n## Tools\n\n| Tool | Purpose |\n| --- | --- |\n| `search_products` | Search products by text. |\n| `get_product` | Get details and retailer prices for a product id. |\n| `lookup_barcode` | Find product prices by EAN/GTIN barcode. |\n| `list_products_by_category` | List category products, sorted by unit price by default. |\n| `list_categories` | Return a simplified category tree. |\n| `list_retailers` | List known retailers. |\n| `get_price_history` | Fetch product detail with history when available. |\n| `compare_competitors` | Fetch comparable/competitor product data when available. |\n| `compare_basket` | Compare a small basket across retailers. |\n| `get_stats` | Return high-level dataset stats. |\n\n## Configuration\n\nOptional environment variables:\n\n| Variable | Default | Purpose |\n| --- | --- | --- |\n| `POSOKANEI_API_BASE` | `https://api.posokanei.gov.gr` | API base URL. |\n| `POSOKANEI_CACHE_TTL_MS` | `300000` | In-memory cache TTL. |\n| `POSOKANEI_MIN_INTERVAL_MS` | `250` | Minimum delay between outbound API requests. |\n| `POSOKANEI_TIMEOUT_MS` | `15000` | Request timeout. |\n\n## Development\n\n```sh\nnpm install\nnpm run typecheck\nnpm test\n```\n\nThe test suite mocks the PosoKanei API. It should not require live network access.\n\n## License\n\nMIT\n",
  "bytes": 2362,
  "sha": "13b2af94dc19be7452f934413d684cae9fcfaaf7ac2c237063a652d99b2ad845",
  "repo_slug": "charistas/posokanei-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_charistas_posokanei_mcp_fd1740a1/readme"
}