TheBestCo/bestprice-mcp

The official Model Context Protocol server for
BestPrice.gr, Greece's price-comparison service. It gives AI
assistants read-only access to shopping decisions, live product search, offer comparison,
and price history. No account or API key is needed.
Start shopping
- Open BestPrice in ChatGPT and add the published plugin.
- Connect BestPrice to Claude using the prefilled connector form.
- See the shopping guide for examples and other assistants.
For developer integrations, the public endpoint is:
- Transport: Streamable HTTP over HTTPS; anonymous shopping, optional OAuth for Events
- Official Registry ID: gr.bestprice/mcp
- Server version: 1.8.4
- Public guide:
- Support:
This repository holds everything that lives outside the hosted service: the install
manifests for each AI client, a local stdio bridge for hosts that cannot speak HTTP, and
the browser-native WebMCP layer. The server itself is not in this repository.
The current release matrix records the
live gateway, UI, OAuth/Events, plugin review and separate ACP qualification.
Tools
| Tool | What it does | Key arguments |
| --- | --- | --- |
| get_shopping_decision | Runs the BestPrice Shopping Brain: an evidence-backed recommendation, need-based comparison, or read-only basket plan with reasons, tradeoffs, and unknowns. | message (the need in Greek or English, including any budget), optional postal_code (required for a completed basket plan), optional evidence_detail (summary, the default: only the evidence the answer cites; full: every claim and source) |
| search_products | Finds canonical products in the catalog. Returns product IDs and the catalog minimum price before shipping. | query (2–200 characters: a name, model, category, or a bare GTIN/EAN barcode), optional price_min, price_max, required_features, sort (relevance, price_asc, price_desc), limit (1–8) |
| compare_offers | Compares current merchant offers for one exact product, separating item price, shipping, and delivered total. | product_id from a previous result, optional postal_code (a Greek postcode, 10000–85999, for delivered totals), objective, in_stock_only, minimum_merchant_rating, limit (1–10) |
| get_price_history | Summarises how a product's price moved over time, against its 180-day median. | product_id, optional period_days (30, 90 or 180) |
All four tools are read-only. They never place orders, create alerts, or read account
data. Results link to a BestPrice product page, never directly to a merchant. Unknown
shipping is reported as unknown, not as free. Search covers safe physical products;
digital goods, services, and age-restricted categories are excluded.
Protocol details
Measured against the live endpoint on 24 September 2026.
- **Versions.** initialize negotiates 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
and 2024-10-07; a client that asks for any other version is answered with 2025-11-25.
The 2026-07-28 per-request revision is also served: send the MCP-Protocol-Version,
Mcp-Method (and, for tools/call, Mcp-Name) headers, and put
io.modelcontextprotocol/protocolVersion and io.modelcontextprotocol/clientCapabilities in
every request's _meta. A request that names the revision without that envelope is refused
with -32602.
- **Stateless.** No MCP-Session-Id is issued and none is required; DELETE answers 405.
A GET with Accept: text/event-stream opens a keep-alive stream, but the server never sends
requests or notifications on it, so a client loses nothing by not opening it.
- **Capabilities.** tools and resources are available to compatible clients. The
resource surface contains the optional MCP Apps UI at ui://bestprice/shopping-results-v1.html,
the server card at mcp://server-card.json, and the canonical
skill://bestprice-shopping/SKILL.md. On MCP 2026-07-28 the server also declares the
final io.modelcontextprotocol/skills extension: skills/list and skills/get return the