BestPrice
BestPrice MCP is a read-only Greek shopping research server for AI assistants, exposing product search, offer comparison, price history and evidence-backed shopping decisions.
get_shopping_decision— returns Shopping Brain recommendations, comparisons or read-only basket plans with reasons, tradeoffs, constraints, evidence and optional clarification.search_products— searches physical products in Greece by name, model, category or barcode, with price bounds, feature hints, sorting and up to 8 results with canonical product IDs.compare_offers— compares current merchant offers for one exact product, including item price, shipping, delivered total, availability, ratings and postcode-based ranking.get_price_history— summarises 30/90/180-day price statistics and daily series, and classifies the current price against the 180-day median.Read-only by design: no checkout, orders, alerts, account access or direct merchant links; results link to BestPrice product pages.
Enables GitHub Copilot to query BestPrice.gr for product search, offer comparison, and price history.
Enables OpenAI assistants to access BestPrice.gr product search, offer comparison, and price history tools.
Enables Perplexity to use BestPrice.gr for live product search, offer comparison, and price history lookups.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BestPrice find Sony WH-1000XM5 under 300 euros"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
The BestPrice app for ChatGPT is available. Developer integrations can still call the public endpoint below.
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:
https://mcp.bestprice.gr/mcpTransport: Streamable HTTP over HTTPS; anonymous shopping, optional OAuth for Events
Official Registry ID:
gr.bestprice/mcpServer version:
1.9.0Public guide: https://www.bestprice.gr/mcp
Support: https://www.bestprice.gr/contact
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, the ChatGPT directory listing and separate ACP qualification.
Related MCP server: Pricewatcha MCP Server
Tools
The hosted 1.9.0 service now also advertises check_deal and optimize_basket.
Both passed a live check on 3 November 2026. check_deal accepts exactly one
product URL, visible model/barcode text or selected product ID; image bytes are
not ingested. optimize_basket calculates read-only plans for exact products,
quantities and a supplied postcode. Neither places an order. The client manifests
now advertise the six research tools. The published ChatGPT app (1.2.0) still
shows the four legacy research tools the hosted 1.9.0 server had before this
change; the six-tool 1.3.0 package in submission/openai-next/ is an uploaded
but unsubmitted draft. OpenAI's acceptance of the new server definitions is
tracked in the release matrix.
Tool | What it does | Key arguments |
| Runs the BestPrice Shopping Brain: an evidence-backed recommendation, need-based comparison, or read-only basket plan with reasons, tradeoffs, and unknowns. |
|
| Finds canonical products in the catalog. Returns product IDs and the catalog minimum price before shipping. |
|
| Compares current merchant offers for one exact product, separating item price, shipping, and delivered total. |
|
| Summarises how a product's price moved over time, against its 180-day median. |
|
| Checks exact identity, current offers and price context for an offer. | Exactly one |
| Calculates read-only plans for exact selected products and quantities. |
|
Public research 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.
One optional clarification
A broad request can return outcome: "clarification" with clarifications[].choices. Each choice contains a display label and a self-contained message. Ask the shopper to choose, then call get_shopping_decision with that message. When they choose Skip, also send skip_clarification: true as returned by that choice. Never choose on the shopper’s behalf. Exact models and requests that already state the missing type bypass this step. Mandatory budget, age-group, product-type and accessory checks still apply after Skip.
For example, “ANC headphones up to €150 for commuting” can ask whether the shopper wants over-ear or in-ear headphones. The recommendation excludes children’s models and replacement accessories unless the shopper asks for them. This is the same Shopping Brain used by BestPrice Ask.
Ask’s product cards can open BestPrice’s existing alert and saved-list flows. Public research remains read-only. On an MCP Events-capable host, optional account linking can separately create and cancel the exact price alerts the shopper requests. No alert is active until subscription succeeds. Saved comparisons in the 1.3.0 candidate remain separately gated; account conversations and image bytes are not accessed.
Protocol details
Measured against the live endpoint on 24 September 2026.
Versions.
initializenegotiates2025-11-25,2025-06-18,2025-03-26,2024-11-05and2024-10-07; a client that asks for any other version is answered with2025-11-25. The2026-07-28per-request revision is also served: send theMCP-Protocol-Version,Mcp-Method(and, fortools/call,Mcp-Name) headers, and putio.modelcontextprotocol/protocolVersionandio.modelcontextprotocol/clientCapabilitiesin every request's_meta. A request that names the revision without that envelope is refused with-32602.Stateless. No
MCP-Session-Idis issued and none is required;DELETEanswers405. AGETwithAccept: text/event-streamanswers immediately with the SSE comment: connectedandretry: 300000, then holds the connection open. It does not send JSON-RPC requests or notifications on that stream. Rechecked 29 October 2026. A client loses nothing by not opening it, and must not wait for the stream to end.Capabilities.
toolsandresourcesare available to compatible clients. The resource surface contains the optional MCP Apps UI atui://bestprice/shopping-results-v1.html, the server card atmcp://server-card.json, and the canonicalskill://bestprice-shopping/SKILL.md. On MCP2026-07-28the server also declares the finalio.modelcontextprotocol/skillsextension:skills/listandskills/getreturn the one BestPrice Shopping Skill with its SHA-256 digest and byte size, andresources/readreturns the exact markdown bytes. Older clients simply see the Skill as an ordinary resource. There are no prompts, completions or logging; those methods answer-32601.Responses. A client that accepts both
application/jsonandtext/event-streamgets a one-event SSE response.Accept: application/json,*/*or noAcceptheader gets a single JSON body. Every tool returnsstructuredContentthat validates against itsoutputSchema, plus the same result as text for clients that do not pass structured content to the model.Errors. An unknown tool is a JSON-RPC error (
-32602). Invalid arguments and service failures such as an unknown product are tool results withisError: true, so the model can read and correct them.Limits. JSON request bodies up to 256 KiB (
413above that), a 12-second request deadline, and per-client rate limits answered with HTTP429, JSON-RPC error-32029and aRetry-Afterheader. JSON-RPC batch arrays are refused with400.Browsers. Desktop, CLI and server-side clients send no
Originheader and are not affected. A browser page may call the endpoint from an allowlisted AI-host origin, from bestprice.gr, or fromlocalhost(so MCP Inspector works in direct mode); any other origin gets403.Authentication. The six research tools work without an account. Optional account linking is scoped to
events:subscribe; protected-resource metadata is available at/.well-known/oauth-protected-resourceand/mcp/oauth-protected-resource. Actual host subscription and delivery qualification is recorded separately in the release matrix.
Developer quick start
Every client below connects to the same endpoint. Copy-paste connector setup for Perplexity,
Claude, ChatGPT developer mode, Gemini CLI, Copilot, Grok Bot, and Cursor is in
docs/connect.md. Longer provider notes, including OpenAI and Microsoft
Copilot Studio, are in docs/provider-setup.md.
Claude
Connect BestPrice to Claude opens the custom-connector flow with the endpoint prefilled. For Claude Code:
claude mcp add --transport http bestprice-shopping https://mcp.bestprice.gr/mcpThe bundled .mcp.json is the equivalent project-scoped configuration.
Cursor
Add BestPrice to Cursor
shows the decoded configuration before adding it. The .cursor-plugin/
directory holds the marketplace plugin and an agent skill.
VS Code and VS Code Insiders
Add BestPrice to VS Code Insiders
Kiro
Add BestPrice to Kiro opens Kiro's confirmation dialog with the remote URL. Kiro shows the configuration before writing it.
Gemini CLI and Qwen Code
gemini extensions install https://github.com/TheBestCo/bestprice-mcp
qwen extensions install https://github.com/TheBestCo/bestprice-mcp --consentBoth extensions restrict the imported tools to the six listed above.
Codex, Claude plugins, and Agent Skill hosts
The root plugin.json, mcp.json, and
skills/bestprice-shopping/SKILL.md form a portable
Agent Plugins package: the MCP supplies live shopping data and the Skill teaches the host when and
how to route unbranded Greek shopping intent.
Agent-compatible hosts that discover repository-local skills under .agents/skills/ get the
same canonical workflow at .agents/skills/bestprice-shopping/SKILL.md. .codex-plugin/ remains the
Codex compatibility manifest. .claude-plugin/plugin.json plus the
same root Skill and .mcp.json also make this repository a Claude plugin package.
claude-plugin/ is a slim copy of that Claude plugin, with no build files, for the Claude plugin directory.
Self-hosted plugin marketplaces
The same repository can be added directly as a plugin marketplace, with no copied tool or Skill logic:
copilot plugin marketplace add TheBestCo/bestprice-mcp
copilot plugin install bestprice-shopping@bestprice
claude plugin marketplace add TheBestCo/bestprice-mcp
claude plugin install bestprice-shopping@bestpriceCopilot reads .github/plugin/marketplace.json and, under
Agent Plugins 1.0, loads the canonical root plugin.json, mcp.json, and
skills/bestprice-shopping/SKILL.md. Claude reads
.claude-plugin/marketplace.json and uses
.claude-plugin/plugin.json, .mcp.json, and the same root Skill.
Gemini API, DeepSeek, Z.ai
Runnable examples live in examples/: the Gemini Interactions API and Genkit,
a DeepSeek Harness plugin entry, and a Z.ai GLM call. Each needs the provider's own API key.
BestPrice needs none.
Any other MCP client
Add the hosted Streamable HTTP endpoint. That is the install path:
https://mcp.bestprice.gr/mcpHosts that read an mcpServers JSON configuration accept:
{
"mcpServers": {
"bestprice-shopping": {
"url": "https://mcp.bestprice.gr/mcp"
}
}
}A checkout of this repository includes stdio.mjs, a local forwarder to that same
endpoint for a host that cannot speak HTTP. From a checkout you already have for
development, run node stdio.mjs. It accepts two environment variables:
BESTPRICE_MCP_URL (default: the public endpoint) and BESTPRICE_MCP_TIMEOUT_MS
(default: 60000). A Dockerfile builds the same forwarder for
Glama and similar hosts. It is
not an install command and it does not download or execute a remote package.
This package is private. It is not published to npm under bestprice-mcp or any scoped name.
There is no registry package to install or to run with npx. A directory that shows an npm
install for version 1.2.7 is repeating a stale crawler inference; that version is not in the
npm registry.
A safe first conversation
Ask for a decision:
Θέλω κινητό έως 500 ευρώ με NFC και 5G υποχρεωτικά.(I want a phone up to 500 euros, NFC and 5G required.)Or search:
Find Sony WH-1000XM5 under 300 euros.Pass a returned
product_idtocompare_offerswith postal code10558.Pass the same
product_idtoget_price_historyfor 180 days.
Queries work in Greek or English. Result summaries, catalog data and merchant names come back in Greek.
Search | Compare offers | Price history |
|
|
|
Browser-native WebMCP
BestPrice pages register 22 contextual WebMCP tools (contract 2.8) in compatible browsers — each one
reads or acts, never both — covering search with structured results (narrowed by price, stock, deals and
order) and opening the results page a search returned in the tab, the shopper's shopping list and
comparisons (read everywhere, added to and removed from on a product page), a price-drop alert dialog, the visible products and loading more, filters and sorting,
opening any product by id (read before the tab moves), product facts, offers, specifications and price
history (with its chart), one visible-offer action, and the BestPrice Shopping Brain — on every public
page, articles and stores included — while leaving the merchant choice to the shopper. Every tool publishes an input and an output
schema. The contracts, fail-closed runtime, deterministic evaluator, and the 47-case natural-language
dataset are in webmcp/.
Discovery
Open agent discovery:
ard.json,ai-catalog.json, server card, and the provider-neutral BestPrice Shopping skill. The ARD examples are deliberately unbranded shopper intents so discovery can match “what should I buy?”, delivered-price, and price-timing requests before a user knows BestPrice.webmcp.jsondescribes the contextual browser tools exposed by BestPrice pages.The repository is listed in the Gemini CLI extension gallery as
BestPrice(Google crawls tagged public extension repositories), while GitHub Agent Finder can ingest the public MCP catalog and ARD resources.Copy-ready, CI-pinned external catalog contributions live under
distribution/: a GitHub Agent Finder Skill entry and a Docker MCP Registry remote-server entry. Those catalogs require review in their own repositories; the checked-in files are submission payloads, not claims that the external listings are already live.Community indexes: Glama, WebMCP Registry, webmcp.com, cursor.directory
Development
npm ci
npm run check # Biome lint and format
npm test # node --test: bridge, WebMCP, manifests, datasetTests need no network: the bridge is exercised against an in-process fake remote. Node 20
or newer is required; .nvmrc pins 22.
Versioning
Two versions appear in this repository on purpose:
Package version in
package.jsonand every plugin or extension manifest. It changes when this repository's manifests, bridge, or WebMCP layer change, and is taggedvX.Y.Z.Server version in
server.jsonand the line near the top of this README. It is the version the hosted service reports and is published to the official MCP Registry.
CHANGELOG.md tracks the package version.
Timestamped hosted-service checks are recorded separately. The 7 September Shopping Brain v12 verification includes its exact gateway revision, sanitized canary results, and scope limits.
Security
Report vulnerabilities privately as described in SECURITY.md.
Contributing
See CONTRIBUTING.md. Issues and pull requests are welcome.
License
Apache License 2.0. Copyright The Best Company S.A. See LICENSE.
Privacy: https://www.bestprice.gr/policies/privacy · Terms: https://www.bestprice.gr/policies/terms
Available Tools
4 toolscompare_offersCompare BestPrice offersARead-onlyIdempotentInspect
Compares current Greek merchant offers for one exact grouped BestPrice product ID. Returns public store names, item prices, shipping information, calculable delivered totals, ranking reasons, and BestPrice links. Without objective it ranks by lowest_total_cost when postal_code is given and by lowest_item_price otherwise, keeping shipping and total cost unknown; an explicit lowest_total_cost requires a Greek postcode (five digits, 10000 to 85999). Other ranking options include merchant rating. Catalog minimum prices and the lowest returned quoted prices have separate fields, with a reason when the catalog minimum is absent from the returned offers. Results exclude sponsored offers and merchant destination URLs. The operation is read-only and creates no CPC click.
Inputs: product_id (required), limit, objective, postal_code, +2 more. Returns: object
get_price_historyInspect BestPrice price historyARead-onlyIdempotentInspect
Returns historical prices and a deterministic deal classification for one exact grouped BestPrice product ID. Includes minimum and median statistics, a compact daily price series, coverage gaps, and methodology. period_days selects the daily series and coverage gaps only: deal_classification and price_delta_vs_180d_median_pct always compare the current price with the 180-day median, and window_stats always carries the 30-, 90- and 180-day statistics. Historical observations do not guarantee future prices.
Inputs: product_id (required), period_days. Returns: object
get_shopping_decisionGet a BestPrice shopping decisionARead-onlyIdempotentInspect
Provides read-only shopping recommendations, product comparisons, purchase-timing context, and basket plans for physical products sold in Greece. Accepts only a concise current shopping request with a budget, required specifications, and relevant corrections, excluding chat transcripts and unrelated personal data. Uses the same Shopping Brain as BestPrice Ask and returns selected products, reasons, tradeoffs, typed catalog attributes, checked offer and historical-price context, evidence references, and unknowns. Each product-family decision evaluates one bounded catalog page and returns at most four candidates per slot. Basket plans accept two to five supported product-family slots under one aggregate budget, or at least two exact grouped bp_ products, and require a five-digit Greek delivery postcode. Product prices exclude shipping; unknown delivery costs remain unknown. Unsupported or unidentified basket categories require clarification. Does not place orders, create alerts, access account history, or predict future prices.
Inputs: message (required), postal_code, evidence_detail, skip_clarification. Returns: object
search_productsSearch BestPrice productsARead-onlyIdempotentInspect
Searches physical products sold in Greece by product name, model, category, or barcode and returns up to eight grouped products with canonical product IDs, catalog prices, relevance warnings, and BestPrice links. Price bounds apply before shipping; feature hints are not independently verified. A valid GTIN with one unambiguous catalog match is supported. Broadened-category results are related products rather than exact matches. Categories containing only ungrouped listings return an empty product list and a category handoff. Catalog minimum prices are indicative, may include filtered offers, and are not buyable quotes. Prohibited, age-restricted, digital, service, and unverified catalog branches are excluded. No checkout or direct merchant links are provided.
Inputs: query (required), sort, limit, locale, +4 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The four tools have mostly distinct roles: recommendation/basket planning, catalog search, merchant-offer comparison, and price history. There is some conceptual overlap because get_shopping_decision also returns comparisons and product selections, so an agent must choose between the composite decision tool and the lower-level search/compare tools.
All tool names follow a consistent snake_case verb_noun pattern: get_shopping_decision, search_products, compare_offers, and get_price_history. The naming is predictable and clearly conveys each tool's action.
Four tools cleanly map to the server's core capabilities: discovery, comparison, historical pricing, and shopping decisions. The set is well-scoped and does not appear padded with redundant operations.
The surface covers search, offer comparison, price history, and bounded shopping recommendations, which is strong for a read-only shopping decision assistant. A minor gap is the lack of a dedicated product-detail lookup by exact product ID or explicit category browsing, though search and decision tools provide partial workarounds.
Maintenance
Related MCP Connectors
Live data for AI agents. Search the catalog, read the price, call the tool; keys stay server-side.
Product search for AI shopping agents: prices and buy links from big retailers. No key needed.
Free, read-only price comparison for products sold in Australia. Search products, browse categories, open a product with every seller's current price (eBay Australia, Amazon, JB Hi-Fi and more), and compare two products head to head. No login or API key. Answers come from Lianex's cached catalogue, so they are fast and never place an order or change anything. Docs: https://lianex.ai/developers
Public read-only offers, prices, product details, links and safe AI integration guidance.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides AI assistants with access to ShopSavvy's comprehensive product data, pricing information, and historical price tracking, enabling product lookup by barcode or ASIN, current offers, price history, and scheduling for automatic monitoring.9102 npm10MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search, track, and monitor product prices, retrieve price history, and set up price alerts via the Pricewatcha API.1Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and compare Norwegian grocery prices across multiple chains, retrieve price history, and access product details through the kassal.app API.MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search Digikala's catalogue, compare every seller's offers and prices, review ~30 days of price history, read customer reviews and Q&A, and surface current deals, all through read-only tools.23528 PyPI43MIT


