BestPrice Shopping

What BestPrice Shopping does

The BestPrice Shopping MCP server gives AI assistants access to shopping data from BestPrice.gr, a Greek price-comparison service. Its scope is research and decision support: all operations are read-only, and none of the tools place orders, create price alerts, or access account data.

The catalog covers safe physical products. Digital goods, services, and age-restricted categories are outside the supported search scope. Results point to BestPrice product pages rather than directly to individual merchants.

The get_shopping_decision tool can turn a shopping need, written in Greek or English, into an evidence-backed recommendation, a comparison based on stated needs, or a read-only basket plan. It includes reasons, tradeoffs, and unknowns. A Greek postal code is needed for a completed basket plan.

How it works

The public endpoint is https://mcp.bestprice.gr/mcp and uses Streamable HTTP over HTTPS. The service is stateless and does not require an MCP session identifier. Anonymous access is available for all four shopping tools, with no account or API key required.

A typical workflow starts with search_products, which returns canonical product records, product IDs, and catalog minimum prices before shipping. Pass a selected product ID to compare_offers to inspect merchant prices, shipping, and delivered totals. A postal code can make the delivered-total comparison specific to a Greek destination. Shipping that cannot be established is reported as unknown rather than assumed to be free.

get_price_history compares a product’s movement over a selected 30-, 90-, or 180-day period with its 180-day median. The decision tool can also be used directly when the user provides a natural-language need and, where relevant, a budget.

Setup and configuration

For a hosted integration, configure an MCP client to use the HTTPS endpoint. Claude, Cursor, and VS Code have connection paths documented by the project. Claude Code can add the server with its HTTP transport and the same endpoint. Gemini CLI and Qwen Code can install the repository extension; the Gemini setup is supported by the project’s published installation command.

The repository contains client manifests, a local stdio bridge for hosts that cannot speak HTTP, and a browser-oriented WebMCP layer. The hosted server itself is not implemented in the repository. No environment variables or credentials are required for the four shopping tools.

Tools and capabilities

• get_shopping_decision: Produces a recommendation, need-based comparison, or read-only basket plan. It accepts a message, an optional Greek postal code, and an evidence-detail setting.
• search_products: Searches by product name, model, category, or bare GTIN/EAN. It supports price bounds, required features, sorting, and result limits of one to eight.
• compare_offers: Reviews current offers for one exact product. It can filter for stock status or merchant rating, apply an objective, use a postal code, and return up to ten offers.
• get_price_history: Summarises price movement for a product over 30, 90, or 180 days.

The BestPrice Shopping MCP server returns structured tool output as well as text for clients that do not pass structured content to the model. Compatible clients can also see the server’s shopping skill and optional results UI resources.

Limitations and notes

The BestPrice Shopping MCP server is intended for product research, not transaction execution. It does not place orders, monitor prices, create alerts, or expose account data. Search and offer results are limited to the Greek market and supported physical-product categories.

Requests have a 12-second deadline, JSON bodies are limited to 256 KiB, and clients can receive rate-limit responses. Invalid arguments and unknown products are returned as tool errors that an agent can inspect and correct. Browser callers must use an allowed AI-host origin, bestprice.gr, or localhost; desktop, command-line, and server-side clients are not affected by the browser-origin rule.