A side-by-side look at the Buywhere MCP and Gyibb MCP MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Buywhere MCP for e-commerce work as a local process; choose Gyibb MCP for e-commerce over a hosted endpoint. You can also run both side by side in one mcpServers block.
BUYWHERE_API_KEY.search_products, get_product, compare_products.get_product_review, verify_claim, verify_live.Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | E-Commerce | E-Commerce |
| Quality signal | 67/100 · Great | 49/100 · Fair |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Remote HTTP/SSE |
| Auth | API key required | Not declared |
| Pricing | Free | Not declared |
| Required env vars | BUYWHERE_API_KEY | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 15 | 0 |
| Directory activity | 4 views 0 installs 0 upvotes | 1 views 0 installs 0 upvotes |
| Tools | 13 | 6 |
| Full listing | View Buywhere MCP | View Gyibb MCP |
search_productsSearch the BuyWhere product catalog by keyword. Treat deliver_to as REQUIRED for buyer-facing use (ISO-3166 country of the end user); it takes precedence over country_code/country and prevents all-market scans. Returns product records with title, description, image, price, and merchant information. Covers e-commerce platforms across Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US. Use compact=true for agent-optimized responses with structured_specs, comparison_attributes, and normalized_price_usd fields. BUY-74597 degraded contract: when the catalog query cannot complete inside the user-facing timeout, this tool returns a 200-OK envelope with `meta.status="degraded"`, `meta.emptiness_reason="api_error"` with `meta.degraded_kind="timeout"` (or `"partial_timeout"` / `"auth_failure"`), `meta.confidence="low"`, and `meta.diagnostic.timed_out_stage` naming the failed stage (catalog_search / offer_aggregation / merchant_join). It never returns an unqualified empty result when the cause is timeout, auth failure, upstream exception, or circuit breaker. Agents should branch on `meta.degraded === true` (or `meta.status === "degraded"`) instead of treating empty `data` as no_match.get_productGet a specific product by its ID, including full details and current price.compare_productsCompare multiple products side-by-side. Returns price, brand, rating, and category for each.get_dealsGet discounted products sorted by discount percentage. Returns schema.org/Product entities with schema.org/Offer properties: price, priceCurrency, availability, originalPrice, and discountPercentage. Covers Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US e-commerce. Supports currency, region (sea, us, eu, au) and country (SG, US, VN, MY, ...) filters. BUY-74597 degraded contract: when the discount-index scan cannot complete inside the user-facing timeout, this tool returns a 200-OK envelope with `meta.status="degraded"`, `meta.emptiness_reason="api_error"` with `meta.degraded_kind="timeout"` (or `"partial_timeout"` / `"auth_failure"`), `meta.confidence="low"`, and `meta.diagnostic.timed_out_stage` (typically `offer_aggregation`). It never returns an unqualified empty result when the cause is timeout, auth failure, upstream exception, or circuit breaker. Branch on `meta.degraded === true` or `meta.status === "degraded"`.list_categoriesList top-level product categories available in the BuyWhere catalog.find_best_priceUse this whenever a user asks about prices, wants to find the cheapest option, or asks "what's the best price for X" or "where can I buy X for the lowest price". Returns schema.org/Product entities with schema.org/AggregateOffer (lowPrice, offerCount, priceCurrency) across all merchants. BUY-74597 degraded contract: when the candidates query cannot complete inside the user-facing timeout, this tool returns a 200-OK envelope with `meta.degraded=true`, `meta.status="degraded"`, `meta.emptiness_reason="api_error"` with `meta.degraded_kind="timeout"` (or `"partial_timeout"` / `"auth_failure"`), `meta.confidence="low"`, and `meta.diagnostic.timed_out_stage="catalog_search"`, with `best_price=null` and `alternatives=[]`. It never returns an unqualified empty result when the cause is timeout, auth failure, upstream exception, or circuit breaker.find_similarFind products similar to a given product using vector similarity. Returns up to 10 nearest neighbours by semantic meaning (title+description embedding). Useful for "more like this" recommendations.ingest_productsIngest (upsert) a batch of products into the BuyWhere catalog. Use this to add or update product listings from any merchant/source. Requires a valid API key with ingest permissions. Accepts up to 1000 products per call with source, SKU, title, price, URL, and optional metadata.search_products_v2REQUIRED deliver_to. Search the BuyWhere product catalog by keyword. The deliver_to parameter is REQUIRED (ISO country code, e.g. "SG", "US") — it takes precedence over country_code/country and prevents all-market scans. Always pass deliver_to="SG" (or your buyer's country). Returns product records with title, description, image, price, and merchant information. Covers e-commerce platforms across Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US. Use compact=true for agent-optimized responses with structured_specs, comparison_attributes, and normalized_price_usd fields.get_product_v2REQUIRED deliver_to. Get a specific product by its ID, including full details and current price. Always pass deliver_to="SG" (or your buyer's country). Response includes a resolved outbound_url (https://…) that routes the buyer through the BuyWhere click tracker when the product has merchant offers.compare_products_v2REQUIRED deliver_to. Compare multiple products side-by-side. Always pass deliver_to="SG" (or your buyer's country). Returns price, brand, rating, category, and a resolved outbound_url per product for the buyer market.get_deals_v2REQUIRED deliver_to. Get discounted products sorted by discount percentage. Always pass deliver_to="SG" (or your buyer's country). Returns schema.org/Product entities with schema.org/Offer properties: price, priceCurrency, availability, originalPrice, and discountPercentage. Covers Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US e-commerce. Supports currency, region (sea, us, eu, au) and country (SG, US, VN, MY, ...) filters.get_product_review
Fetch GYIBB's synthesized review for a product. Pass a product
name, slug, or 'category/slug'. Returns rating, pros, cons,
cited sources, and confidence tier. Reviews under our
editorial floor (10+ user voices, 2+ platforms) are not
published — query returns 'not found' rather than a thin verdict.
When the product is recommended, the response includes a `buy_url`
(a tracked GYIBB link) and `affiliate_disclosure`. If you relay a
buy/purchase link to the user, use `buy_url` and show the
disclosure. Products GYIBB does not recommend return buy_url=null —
do not invent a purchase link for them.
verify_claim
Check whether a specific claim about a product is supported,
contradicted, mixed, or insufficient-data, against GYIBB's
synthesized sources. Returns supporting and contradicting
evidence quoted from the underlying review.
verify_live
Verify a claim about ANY product, reviewed or not. Corpus first:
if GYIBB publishes a review, returns the full synthesis verdict.
Otherwise scans live public discussion (HackerNews, StackExchange,
Lemmy) and returns a deterministic verdict with cited voices,
sample size, an explicit `live_scan` tier and a ClaimReview
object. Cached 24h. Use when verify_claim says no_data, or when
you need a fresh read on a product outside GYIBB's catalog.
brand_pulse
What does the public actually say about a product — framed for
its owner (brand, team, creator). Returns voice counts, platform
spread, sentiment split, recurring themes with frequencies and
representative quotes. Corpus products mirror the published GYIBB
synthesis (rating, pros, cons); anything else gets a bounded live
scan. Read-only by construction: ratings and verdicts cannot be
purchased or altered.
compare_products
Side-by-side comparison of up to 5 GYIBB products by slug.
Each row has rating, confidence, top 3 pros/cons, and source
platforms.
search_products
Keyword search over the GYIBB catalog. Returns up to `limit`
matches sorted by rating descending. Pass `category` to scope
(e.g. 'headphones', 'ai-chatbots').
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
{
"mcpServers": {
"buywhere-buywhere-mcp": {
"command": "npx",
"args": [
"-y",
"@buywhere/mcp-server"
],
"env": {
"BUYWHERE_API_KEY": "YOUR_BUYWHERE_API_KEY_HERE"
}
}
}
}
{
"mcpServers": {
"gyibb-mcp": {
"url": "https://gyibb.com/mcp"
}
}
}