Read-only shopping decisions, product search, offers, and price history for Greece.
gr.bestprice/mcp (BestPrice MCP)
The gr.bestprice/mcp server is a Model Context Protocol (MCP) endpoint that provides read-only shopping data for Greece, including shopping decisions, product search, offers, and price history. It is intended to connect compatible AI applications to the BestPrice Shopping Brain for live results.
🛠️ Key Features
Read-only access to shopping decisions
Product search
Offers retrieval
Price history for products
🚀 Use Cases
Finding products in a Greece-focused catalog
Comparing available offers
Reviewing historical pricing trends
⚡ Developer Benefits
Compatible with MCP-based AI applications
Structured access to shopping-brain data (decisions, search, offers, history)
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 starts with one bounded catalog page and returns at most four candidates per slot. A failed recommendation may check a small set of externally discovered models against BestPrice. Basket plans accept two to five product slots, or several units of one product, under one aggregate budget or a budget per item, or at least two exact grouped bp_<id> products, and require a five-digit Greek delivery postcode. Product prices exclude shipping; unknown delivery costs remain unknown. A basket item in a category the Shopping Brain does not cover is named and left out of the plan; unidentified items, or a basket that must include every item, require clarification. Does not place orders, create alerts, access account history, or predict future prices.
Parameters4
message
string
required
A concise current shopping request with only relevant budget, required specifications and user corrections. No chat transcripts or unrelated personal data. Greek and English are accepted.
postal_code
string
optional
Optional Greek delivery postcode (five digits, 10000 to 85999) supplied by the user. It is required for basket plans; without it, shipping and delivered totals remain unknown.
skip_clarification
boolean
optional
Set true only when the shopper chooses Skip on an opening clarification. Mandatory criteria are still enforced.
evidence_detail
string
optional
Optional evidence depth. 'summary' (default) returns only the claims this result cites by id (typed attributes, price history), the claims they are derived from and the sources they cite, and counts what it omits. 'full' returns every returned-product claim and source, including each offer's field receipts, complete spec sheets and ranking inputs; it is several times larger.
Raw schema
{
"type": "object",
"properties": {
"message": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "A concise current shopping request with only relevant budget, required specifications and user corrections. No chat transcripts or unrelated personal data. Greek and English are accepted."
},
"postal_code": {
"description": "Optional Greek delivery postcode (five digits, 10000 to 85999) supplied by the user. It is required for basket plans; without it, shipping and delivered totals remain unknown.",
"type": "string",
"pattern": "^(?:[1-7][0-9]{4}|8[0-5][0-9]{3})$"
},
"skip_clarification": {
"description": "Set true only when the shopper chooses Skip on an opening clarification. Mandatory criteria are still enforced.",
"type": "boolean"
},
"evidence_detail": {
"default": "summary",
"description": "Optional evidence depth. 'summary' (default) returns only the claims this result cites by id (typed attributes, price history), the claims they are derived from and the sources they cite, and counts what it omits. 'full' returns every returned-product claim and source, including each offer's field receipts, complete spec sheets and ranking inputs; it is several times larger.",
"type": "string",
"enum": [
"summary",
"full"
]
}
},
"required": [
"message"
],
"additionalProperties": false
}
search_products
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.
Parameters8
query
string
required
Product name, model, barcode (GTIN/EAN), or category in Greek or English. A pasted merchant listing title is accepted; the search reduces it to the model it names. Catalog search does not verify requirements based on needs, household size, or suitability.
locale
string
optional
Response locale. The current service supports el-GR.
country
string
optional
Shopping market. The current service supports Greece (GR).
price_min
number
optional
Optional minimum product price in EUR, before shipping.
price_max
number
optional
Optional maximum product price in EUR, before shipping.
required_features
array
optional
Optional relevance hints such as OLED, Wi-Fi, or noise cancellation. They are not independently verified for every result.
sort
string
optional
Result order: catalog relevance (default), lowest catalog price first, or highest catalog price first.
limit
integer
optional
Maximum number of grouped products to return, from 1 to 8.
Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 400,
"description": "Product name, model, barcode (GTIN/EAN), or category in Greek or English. A pasted merchant listing title is accepted; the search reduces it to the model it names. Catalog search does not verify requirements based on needs, household size, or suitability."
},
"locale": {
"default": "el-GR",
"description": "Response locale. The current service supports el-GR.",
"type": "string"
},
"country": {
"default": "GR",
"description": "Shopping market. The current service supports Greece (GR).",
"type": "string"
},
"price_min": {
"description": "Optional minimum product price in EUR, before shipping.",
"type": "number",
"minimum": 0,
"maximum": 1000000
},
"price_max": {
"description": "Optional maximum product price in EUR, before shipping.",
"type": "number",
"maximum": 1000000
},
"required_features": {
"default": [],
"description": "Optional relevance hints such as OLED, Wi-Fi, or noise cancellation. They are not independently verified for every result.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
}
},
"sort": {
"default": "relevance",
"description": "Result order: catalog relevance (default), lowest catalog price first, or highest catalog price first.",
"type": "string",
"enum": [
"relevance",
"price_asc",
"price_desc"
]
},
"limit": {
"default": 8,
"description": "Maximum number of grouped products to return, from 1 to 8.",
"type": "integer",
"minimum": 1,
"maximum": 8
}
},
"required": [
"query"
],
"additionalProperties": false
}
compare_offers
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.
Parameters6
product_id
string
required
Exact grouped BestPrice product id returned by search_products, in bp_<id> form.
postal_code
string
optional
Greek delivery postcode (five digits, 10000 to 85999) used to calculate shipping and total cost. Required for lowest_total_cost; optional for lowest_item_price and merchant_rating.
objective
string
optional
How to rank offers. When omitted: lowest_total_cost if postal_code is given, otherwise lowest_item_price. lowest_total_cost includes known shipping and requires postal_code.
in_stock_only
boolean
optional
false (default): every buyable offer, whatever its delivery estimate (availability unknown stays marked unknown). true: only offers available now or delivered in 1 to 3 days; slower ones are held back and named in a warning. Offers shipping in 4 to 10 days are still buyable; true excludes them and can exclude the cheapest price. Out-of-stock offers are never returned.
minimum_merchant_rating
number
optional
Optional minimum merchant rating on a 0 to 5 scale.
limit
integer
optional
Maximum number of current merchant offers to return, from 1 to 10.
Raw schema
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"pattern": "^bp_[0-9]{10}$",
"description": "Exact grouped BestPrice product id returned by search_products, in bp_<id> form."
},
"postal_code": {
"description": "Greek delivery postcode (five digits, 10000 to 85999) used to calculate shipping and total cost. Required for lowest_total_cost; optional for lowest_item_price and merchant_rating.",
"type": "string",
"pattern": "^(?:[1-7][0-9]{4}|8[0-5][0-9]{3})$"
},
"objective": {
"description": "How to rank offers. When omitted: lowest_total_cost if postal_code is given, otherwise lowest_item_price. lowest_total_cost includes known shipping and requires postal_code.",
"type": "string",
"enum": [
"lowest_total_cost",
"lowest_item_price",
"merchant_rating"
]
},
"in_stock_only": {
"default": false,
"description": "false (default): every buyable offer, whatever its delivery estimate (availability unknown stays marked unknown). true: only offers available now or delivered in 1 to 3 days; slower ones are held back and named in a warning. Offers shipping in 4 to 10 days are still buyable; true excludes them and can exclude the cheapest price. Out-of-stock offers are never returned.",
"type": "boolean"
},
"minimum_merchant_rating": {
"default": 0,
"description": "Optional minimum merchant rating on a 0 to 5 scale.",
"type": "number",
"minimum": 0,
"maximum": 5
},
"limit": {
"default": 10,
"description": "Maximum number of current merchant offers to return, from 1 to 10.",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"product_id"
],
"additionalProperties": false
}
get_price_history
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.
Parameters2
product_id
string
required
Exact grouped BestPrice product id returned by search_products, in bp_<id> form.
period_days
integer
optional
Requested history window in days for series and data_gaps. deal_classification and price_delta_vs_180d_median_pct always compare with the 180-day median; window_stats always carries the 30-, 90- and 180-day statistics. Defaults to 180 days.
Raw schema
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"pattern": "^bp_[0-9]{10}$",
"description": "Exact grouped BestPrice product id returned by search_products, in bp_<id> form."
},
"period_days": {
"default": 180,
"description": "Requested history window in days for series and data_gaps. deal_classification and price_delta_vs_180d_median_pct always compare with the 180-day median; window_stats always carries the 30-, 90- and 180-day statistics. Defaults to 180 days.",
"type": "integer",
"minimum": 30,
"maximum": 180
}
},
"required": [
"product_id"
],
"additionalProperties": false
}
optimize_basket
Calculates read-only basket plans for exact grouped BestPrice product IDs delivered to a Greek postcode. Compares cheapest, fewer-merchant, and balanced reliability-and-cost plans within the requested merchant ceiling and rating floor. Returns public store names and cost breakdowns; unknown shipping leaves affected delivered totals null. Does not discover products, place orders, process payments, or expose merchant destination URLs.
Parameters5
items
array
required
One to twenty distinct grouped BestPrice products to plan together.
postal_code
string
required
Greek delivery postcode (five digits, 10000 to 85999) used to calculate shipping and total cost.
maximum_merchants
integer
optional
Maximum number of different merchants allowed in a basket plan.
minimum_merchant_rating
number
optional
Optional minimum merchant rating on a 0 to 5 scale.
objective
string
optional
How to choose the preferred plan: total cost, fewer merchants, or a balanced cost and reliability result.
Raw schema
{
"type": "object",
"properties": {
"items": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"pattern": "^bp_[0-9]{10}$",
"description": "Exact grouped BestPrice product id returned by search_products."
},
"quantity": {
"default": 1,
"description": "Requested quantity of this exact product.",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"product_id"
],
"additionalProperties": false
},
"description": "One to twenty distinct grouped BestPrice products to plan together."
},
"postal_code": {
"type": "string",
"pattern": "^(?:[1-7][0-9]{4}|8[0-5][0-9]{3})$",
"description": "Greek delivery postcode (five digits, 10000 to 85999) used to calculate shipping and total cost."
},
"maximum_merchants": {
"default": 3,
"description": "Maximum number of different merchants allowed in a basket plan.",
"type": "integer",
"minimum": 1,
"maximum": 8
},
"minimum_merchant_rating": {
"default": 0,
"description": "Optional minimum merchant rating on a 0 to 5 scale.",
"type": "number",
"minimum": 0,
"maximum": 5
},
"objective": {
"default": "lowest_total_cost",
"description": "How to choose the preferred plan: total cost, fewer merchants, or a balanced cost and reliability result.",
"type": "string",
"enum": [
"lowest_total_cost",
"fewer_merchants",
"balanced_reliability_cost"
]
}
},
"required": [
"items",
"postal_code"
],
"additionalProperties": false
}
check_deal
Checks an offer using a BestPrice product URL, a reviewed merchant URL, a barcode, or visible product text from a screenshot. Screenshot inputs consist of visible identity text and an optional observed price. Unique barcodes and reviewed variant-identifying URLs can establish an exact identity. Text queries return candidates for explicit user selection; similarity does not establish an exact retailer match. Compares current eligible offers and known delivered totals separately from market item-price history. Observed prices remain user-supplied, missing variants and former prices remain unverified, and unknown shipping remains unknown. Read-only; no checkout or alerts.
Parameters5
url
string
optional
HTTPS product URL from BestPrice or a merchant. Credentials and alternate ports are unsupported.
query
string
optional
Visible brand/model/variant text or a barcode. Text retrieval returns candidates, not a proven retailer identity.
product_id
string
optional
An exact returned candidate the user explicitly selected; does not prove it matches a retailer listing.
observed_price
object
optional
Price visibly supplied by the shopper. Never infer a price or an advertised former price.
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.
BestPrice MCP: products, offers and price history for AI assistants
Start shopping
The BestPrice app for ChatGPT is available. Developer integrations can still call the public endpoint below.
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.
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
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–400 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)
check_deal
Checks exact identity, current offers and price context for an offer.
Exactly one url, visible model/barcode query, or selected product_id; optional supplied observed_price and postal_code
optimize_basket
Calculates read-only plans for exact selected products and quantities.
items with product_id and quantity, Greek postal_code; optional objective and maximum_merchants
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.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 answers immediately with the SSE comment : connected
and retry: 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.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
one BestPrice Shopping Skill with its SHA-256 digest and byte size, and resources/read
returns 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/json and text/event-stream gets a
one-event SSE response. Accept: application/json, */* or no Accept header gets a single
JSON body. Every tool returns structuredContent that validates against its outputSchema,
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 with isError: true, so the model can
read and correct them.
Limits. JSON request bodies up to 256 KiB (413 above that), a 12-second request
deadline, and per-client rate limits answered with HTTP 429, JSON-RPC error -32029 and a
Retry-After header. JSON-RPC batch arrays are refused with 400.
Browsers. Desktop, CLI and server-side clients send no Origin header and are not
affected. A browser page may call the endpoint from an allowlisted AI-host origin, from
bestprice.gr, or from localhost (so MCP Inspector works in direct mode); any other origin
gets 403.
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-resource and /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 mcp add --transport http bestprice-shopping https://mcp.bestprice.gr/mcp
The 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.
Both 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:
sh
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@bestprice
Copilot 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:
text
https://mcp.bestprice.gr/mcp
Hosts that read an mcpServers JSON configuration accept:
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_id to compare_offers with postal code 10558.
Pass the same product_id to get_price_history for 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/.
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.json describes 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.
npm ci
npm run check # Biome lint and format
npm test# node --test: bridge, WebMCP, manifests, dataset
Tests 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.json and every plugin or extension manifest. It changes
when this repository's manifests, bridge, or WebMCP layer change, and is tagged vX.Y.Z.
Server version in server.json and 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.