Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.BuyWhere/buywhere-mcp

REMOTE · API.BUYWHERE.AI · 2 COMPONENTS

Agent-native product catalog: 300M+ products, 150,000+ stores, deliver_to ranking.

0 this week 86 Trust /100

Last scanned (9 hours ago)

Scores higher than 92% of remote servers

Reachable. Last reached 6 Nov 2026.

Category E-commerce

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security89
Transport & Reachability100
Schema Quality & AI Usability64
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 3255 tokens (~250/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 13 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities20
  • Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28. See how to fix → Fail
What we tested

Checks we ran (13)

  • TLS certificate
  • Authorization
  • HTTPS
  • HSTS header
  • DNSSEC
  • Transport
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this hosted endpoint (2)

  • Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
  • Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 6 Nov 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 4 Nov 26 0
    • Endpoint reachability: reachable → unreachable ▼ security
    • Tool safety: pass → unverified ▼ security
    • Authorization: fail → unverified ▼ security
    • Stability: pass → unverified ▼ security
    • HSTS header: pass → unverified ▼ security
    • TLS certificate: pass → unverified ▼ security
    • Transport: pass → fail ▼ security
    • Capabilities: fail → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
  • 3 Oct 26 86
    • Stability: 0.97 → pass security
  • 28 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Sept 26 0
    • Tool “get_deals” rewrote its description, which is the text the model reads security
    • Tool “get_deals_v2” rewrote its description, which is the text the model reads security
    • “get_deals_v2” added an optional parameter “category” cosmetic
    • “get_deals” added an optional parameter “category” cosmetic
  • 25 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 18 Sept 26 0
    • “get_deals” dropped the optional parameter “category” cosmetic
    • “get_deals_v2” dropped the optional parameter “category” cosmetic

    2 cosmetic changes on this day. Switch on “Show cosmetic changes” to see them.

  • 14 Sept 26 0
    • “get_deals_v2” added an optional parameter “category” cosmetic
    • “get_deals” added an optional parameter “category” cosmetic

    2 cosmetic changes on this day. Switch on “Show cosmetic changes” to see them.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 6 Nov 2026 · Probed https://api.buywhere.ai/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=api.buywhere.ai CN=YE1,O=Let's Encrypt,C=US 3 Nov 2026 1 Feb 2027 ECDSA 256 ECDSA-SHA384 6dfbe767d1c98b1b1cdf0c4732e72ae9784
SANs: api.buywhere.ai
CN=YE1,O=Let's Encrypt,C=US (CA) CN=Root YE,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 ECDSA 384 ECDSA-SHA384 5ddd70dd31f801c85c186a7a04b80afe
CN=Root YE,O=ISRG,C=US (CA) CN=ISRG Root X2,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 ECDSA-SHA384 872165fc34b6e5fba8add5b3705fb53a
CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 SHA256-RSA 6c8f1dc727c7117f7baf853ac980f9cd

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of api.buywhere.ai. — Not signed

Zone DS Keys Algorithms Outcome
. Trust anchor 20326, 38696 8, 8 Verified
ai. DS published 1814, 3799 8, 8 Verified
buywhere.ai. No DS Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication Challenged, unverified

The endpoint asked for a token, but we could not retrieve and validate the RFC 9728 metadata that tells a client how to obtain one.

Result Challenged, unverified
Enforced On tool calls
HTTP status 200

WWW-Authenticate challenge Bearer realm="buywhere"

Bearer realm="buywhere"
Header Value
strict-transport-security max-age=31536000; includeSubDomains
content-security-policy default-src 'self'; img-src 'self' data: https:; style-src 'self' 'unsafe-inline'; script-src 'self'; frame-ancestors 'none'
x-content-type-options nosniff
x-frame-options DENY
referrer-policy strict-origin-when-cross-origin
permissions-policy camera=(), microphone=(), geolocation=()

Protected resource metadata

Retrieved No
Problem No resource metadata

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://api.buywhere.ai/mcp Verified 200
http (plaintext) http://api.buywhere.ai/mcp HTTPS enforced 301 https://api.buywhere.ai/mcp
MCP tools · 13 exposed · ~3,255 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
compare_products ~44

Compare multiple products side-by-side. Returns price, brand, rating, and category for each.

NameTypeReqDescription
idsarrayyesArray of product IDs to compare (2-10)

No output schema declared.

No examples provided.

compare_products_v2 ~101

REQUIRED 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.

NameTypeReqDescription
deliver_tostringyesREQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
idsarrayyesArray of product IDs to compare (2-10)

No output schema declared.

No examples provided.

find_best_price ~409

Use 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.

NameTypeReqDescription
categorystring–Category to filter by (e.g., "electronics", "fashion")
countrystring–Alias for country_code (deprecated, use country_code)
country_codestring–Country to search in (defaults to SG). Alias: country.
deliver_tostring–Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. "SG", "US"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country.
marketstring–Alias for country_code (deprecated, use country_code).
product_namestring–Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")
qstring–Keyword search query — alias for product_name
regionstring–Region filter - use "us" for United States or "sea" for Southeast Asia

No output schema declared.

No examples provided.

find_best_price_v2 ~278

REQUIRED deliver_to. Use 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". Always pass deliver_to="SG" (or your buyer's country). Returns schema.org/Product entities with schema.org/AggregateOffer (lowPrice, offerCount, priceCurrency) across all merchants. Response includes a shopping_job_id (UUID) you can use to resume a multi-merchant price-comparison session for the buyer.

NameTypeReqDescription
categorystring–Category to filter by (e.g., "electronics", "fashion")
countrystring–Alias for country_code (deprecated, use country_code)
country_codestring–Country to search in (defaults to SG). Alias: country.
deliver_tostringyesREQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
product_namestring–Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")
qstring–Keyword search query — alias for product_name
regionstring–Region filter - use "us" for United States or "sea" for Southeast Asia

No output schema declared.

No examples provided.

find_similar ~79

Find 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.

NameTypeReqDescription
limitinteger–Number of similar products to return (1-10, default 10)
product_idstringyesUUID of the source product

No output schema declared.

No examples provided.

get_deals ~475

Get 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), country (SG, US, VN, MY, ...) and category 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"`.

NameTypeReqDescription
categorystring–Filter deals by product category (e.g. "Electronics", "Beauty", "home_and_kitchen"). Handler matches against category text and category_path[1]; slug-style input is accepted. BUY-76853/BUY-83657.
countrystring–Alias for country_code (deprecated, use country_code)
country_codestring–Filter by ISO country code. Alias: country.
currencystring–Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.
deliver_tostring–Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. "SG", "US"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country.
limitinteger–Number of results (max 100, default 20)
marketstring–Alias for country_code (deprecated, use country_code).
min_discountnumber–Minimum discount percentage (default 10)
offsetinteger–Pagination offset
regionstring–Filter by region (sea, us, eu, au)

No output schema declared.

No examples provided.

get_deals_v2 ~313

REQUIRED 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), country (SG, US, VN, MY, ...) and category filters.

NameTypeReqDescription
categorystring–Filter deals by product category (e.g. "Electronics", "Beauty", "home_and_kitchen"). Handler matches against category text and category_path[1]; slug-style input is accepted. BUY-76853/BUY-83657.
countrystring–Alias for country_code (deprecated, use country_code)
country_codestring–Filter by ISO country code. Alias: country.
currencystring–Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.
deliver_tostringyesREQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
limitinteger–Number of results (max 100, default 20)
min_discountnumber–Minimum discount percentage (default 10)
offsetinteger–Pagination offset
regionstring–Filter by region (sea, us, eu, au)

No output schema declared.

No examples provided.

get_product ~32

Get a specific product by its ID, including full details and current price.

NameTypeReqDescription
idstringyesProduct UUID

No output schema declared.

No examples provided.

get_product_v2 ~107

REQUIRED 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.

NameTypeReqDescription
deliver_tostringyesREQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
idstringyesProduct UUID

No output schema declared.

No examples provided.

ingest_products ~120

Ingest (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.

NameTypeReqDescription
productsarrayyesArray of product objects to ingest (max 1000)
sourcestringyesData source identifier (e.g. "shopee_sg", "amazon_sg", "lazada_sg")

No output schema declared.

No examples provided.

list_categories ~85

List top-level product categories available in the BuyWhere catalog.

NameTypeReqDescription
countrystring–Alias for country_code (deprecated, use country_code)
country_codestring–Filter by ISO country code. Defaults to SG.
marketstring–Alias for country_code (deprecated, use country_code).
regionstring–Region alias mapped to ISO country code.

No output schema declared.

No examples provided.

search_products ~697

Search 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.

NameTypeReqDescription
categorystring–Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.
compactboolean–Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.
countrystring–Alias for country_code (deprecated, use country_code)
country_codestring–Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).
deliver_tostring–Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. "SG", "US"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country.
domainstring–Filter by merchant platform (e.g. lazada, shopee, amazon)
limitinteger–Number of results (max 100, default 20)
marketstring–Alias for country_code (deprecated, use country_code).
max_pricenumber–Maximum price (in currency inferred from country_code, or SGD by default)
min_pricenumber–Minimum price (in currency inferred from country_code, or SGD by default)
modestring–Search mode: keyword=FTS only (default, matches REST /v1/products/search), semantic=vector only, hybrid=RRF blend of FTS+vector. Falls back to keyword if vector DB or FLOWAI_EMBED_API_KEY unavailable.
offsetinteger–Pagination offset
qstring–Keyword search query
querystring–Alias for q (accepted for agent convenience; use q). Without this, callers passing `query` get 0 rows and the reltuples-derived total — see BUY-75287.
regionstring–Filter by region (sea, us, eu, au)

No output schema declared.

No examples provided.

search_products_v2 ~515

REQUIRED 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.

NameTypeReqDescription
categorystring–Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.
compactboolean–Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.
countrystring–Alias for country_code (deprecated, use country_code)
country_codestring–Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).
deliver_tostringyesREQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
domainstring–Filter by merchant platform (e.g. lazada, shopee, amazon)
limitinteger–Number of results (max 100, default 20)
max_pricenumber–Maximum price (in currency inferred from country_code, or SGD by default)
min_pricenumber–Minimum price (in currency inferred from country_code, or SGD by default)
modestring–Search mode: keyword=FTS only (default, matches REST /v1/products/search), semantic=vector only, hybrid=RRF blend of FTS+vector. Falls back to keyword if vector DB or FLOWAI_EMBED_API_KEY unavailable.
offsetinteger–Pagination offset
qstring–Keyword search query
querystring–Alias for q (accepted for agent convenience; use q). Without this, callers passing `query` get 0 rows and the reltuples-derived total — see BUY-75287.
regionstring–Filter by region (sea, us, eu, au)

No output schema declared.

No examples provided.

Install

How do I install the io.github.BuyWhere/buywhere-mcp server?

io.github.BuyWhere/buywhere-mcp is a hosted endpoint at https://api.buywhere.ai/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · api.buywhere.ai

# add to Claude Code
claude mcp add --transport http buywhere-buywhere-mcp 'https://api.buywhere.ai/mcp'
Common questions

What is the io.github.BuyWhere/buywhere-mcp server?

io.github.BuyWhere/buywhere-mcp is listed in the public MCP registry as io.github.BuyWhere/buywhere-mcp. Agent-native product catalog: 300M+ products, 150,000+ stores, deliver_to ranking. This page covers its hosted endpoint (https://api.buywhere.ai/mcp).

Is the io.github.BuyWhere/buywhere-mcp server safe to use?

io.github.BuyWhere/buywhere-mcp scores 86 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.BuyWhere/buywhere-mcp server expose?

io.github.BuyWhere/buywhere-mcp exposes 13 tools: search_products, get_product, compare_products, get_deals, list_categories, and 8 more. Their descriptions and schemas cost roughly 3,255 tokens of context every time the server is loaded.

Does the io.github.BuyWhere/buywhere-mcp server require authentication?

Yes. io.github.BuyWhere/buywhere-mcp asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

Is the io.github.BuyWhere/buywhere-mcp server still maintained?

io.github.BuyWhere/buywhere-mcp is still listed as active in the MCP registry. We last reached this channel on 6 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What did VerifyMCP test on the io.github.BuyWhere/buywhere-mcp server?

VerifyMCP ran 13 checks on io.github.BuyWhere/buywhere-mcp, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.