io.github.BuyWhere/buywhere-mcp
REMOTE · API.BUYWHERE.AI · 2 COMPONENTS · SCANNED SEP 21
Agent-native product catalog: 300M+ products, 150,000+ stores, deliver_to ranking.
Available components
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
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token. See how to fix → View diagnostics → Fail
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability65
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 3143 tokens (~241/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 Management60
- Stability observed for 18 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
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
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
claude mcp add --transport http buywhere-buywhere-mcp 'https://api.buywhere.ai/mcp'
{
"mcpServers": {
"buywhere-buywhere-mcp": {
"url": "https://api.buywhere.ai/mcp"
}
}
} {
"servers": {
"buywhere-buywhere-mcp": {
"type": "http",
"url": "https://api.buywhere.ai/mcp"
}
}
} [mcp_servers.buywhere-buywhere-mcp] url = "https://api.buywhere.ai/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"buywhere-buywhere-mcp": {
"type": "remote",
"url": "https://api.buywhere.ai/mcp",
"enabled": true
}
}
} openclaw mcp add buywhere-buywhere-mcp --url 'https://api.buywhere.ai/mcp' --transport streamable-http
mcp_servers:
buywhere-buywhere-mcp:
url: "https://api.buywhere.ai/mcp" {
"McpServers": {
"buywhere-buywhere-mcp": {
"Transport": "http",
"Url": "https://api.buywhere.ai/mcp"
}
}
} assistant mcp add buywhere-buywhere-mcp -t streamable-http -u 'https://api.buywhere.ai/mcp'
{
"mcpServers": {
"buywhere-buywhere-mcp": {
"type": "http",
"url": "https://api.buywhere.ai/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
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.
- 21 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 57 to 60. That category is still filling its 30-day observation window: 17 days of observed history at the previous scan, 18 at this one. The score rises as the window fills, whether or not the server changes.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 50 to 53. That category is still filling its 30-day observation window: 15 days of observed history at the previous scan, 16 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 0
- “get_deals_v2” dropped the optional parameter “category” cosmetic
- “get_deals” dropped the optional parameter “category” cosmetic
2 cosmetic changes on this day. Switch on “Show cosmetic changes” to see them.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.
- 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.
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
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 21 Sept 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 | 4 Sept 2026 | 3 Dec 2026 | ECDSA 256 | ECDSA-SHA384 | 58440e22c6a4fe5bff964979bc29e08c2bc |
| 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. | present | 3799 | 8 | Verified |
| buywhere.ai. | absent | 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 |
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 →
compare_products ~44
Compare multiple products side-by-side. Returns price, brand, rating, and category for each.
| Name | Type | Req | Description |
|---|---|---|---|
| ids | array | yes | Array 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.
| Name | Type | Req | Description |
|---|---|---|---|
| deliver_to | string | yes | REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US"). |
| ids | array | yes | Array 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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Category to filter by (e.g., "electronics", "fashion") |
| country | string | – | Alias for country_code (deprecated, use country_code) |
| country_code | string | – | Country to search in (defaults to SG). Alias: country. |
| deliver_to | string | – | 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. |
| market | string | – | Alias for country_code (deprecated, use country_code). |
| product_name | string | – | Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24") |
| q | string | – | Keyword search query — alias for product_name |
| region | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Category to filter by (e.g., "electronics", "fashion") |
| country | string | – | Alias for country_code (deprecated, use country_code) |
| country_code | string | – | Country to search in (defaults to SG). Alias: country. |
| deliver_to | string | yes | REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US"). |
| product_name | string | – | Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24") |
| q | string | – | Keyword search query — alias for product_name |
| region | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Number of similar products to return (1-10, default 10) |
| product_id | string | yes | UUID of the source product |
No output schema declared.
No examples provided.
get_deals ~419
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) 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"`.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | Alias for country_code (deprecated, use country_code) |
| country_code | string | – | Filter by ISO country code. Alias: country. |
| currency | string | – | Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD. |
| deliver_to | string | – | 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. |
| limit | integer | – | Number of results (max 100, default 20) |
| market | string | – | Alias for country_code (deprecated, use country_code). |
| min_discount | number | – | Minimum discount percentage (default 10) |
| offset | integer | – | Pagination offset |
| region | string | – | Filter by region (sea, us, eu, au) |
No output schema declared.
No examples provided.
get_deals_v2 ~257
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) and country (SG, US, VN, MY, ...) filters.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | Alias for country_code (deprecated, use country_code) |
| country_code | string | – | Filter by ISO country code. Alias: country. |
| currency | string | – | Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD. |
| deliver_to | string | yes | REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US"). |
| limit | integer | – | Number of results (max 100, default 20) |
| min_discount | number | – | Minimum discount percentage (default 10) |
| offset | integer | – | Pagination offset |
| region | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Product 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.
| Name | Type | Req | Description |
|---|---|---|---|
| deliver_to | string | yes | REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US"). |
| id | string | yes | Product 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.
| Name | Type | Req | Description |
|---|---|---|---|
| products | array | yes | Array of product objects to ingest (max 1000) |
| source | string | yes | Data 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.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | Alias for country_code (deprecated, use country_code) |
| country_code | string | – | Filter by ISO country code. Defaults to SG. |
| market | string | – | Alias for country_code (deprecated, use country_code). |
| region | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products. |
| compact | boolean | – | Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use. |
| country | string | – | Alias for country_code (deprecated, use country_code) |
| country_code | string | – | Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR). |
| deliver_to | string | – | 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. |
| domain | string | – | Filter by merchant platform (e.g. lazada, shopee, amazon) |
| limit | integer | – | Number of results (max 100, default 20) |
| market | string | – | Alias for country_code (deprecated, use country_code). |
| max_price | number | – | Maximum price (in currency inferred from country_code, or SGD by default) |
| min_price | number | – | Minimum price (in currency inferred from country_code, or SGD by default) |
| mode | string | – | 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. |
| offset | integer | – | Pagination offset |
| q | string | – | Keyword search query |
| query | string | – | 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. |
| region | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products. |
| compact | boolean | – | Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use. |
| country | string | – | Alias for country_code (deprecated, use country_code) |
| country_code | string | – | Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR). |
| deliver_to | string | yes | REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US"). |
| domain | string | – | Filter by merchant platform (e.g. lazada, shopee, amazon) |
| limit | integer | – | Number of results (max 100, default 20) |
| max_price | number | – | Maximum price (in currency inferred from country_code, or SGD by default) |
| min_price | number | – | Minimum price (in currency inferred from country_code, or SGD by default) |
| mode | string | – | 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. |
| offset | integer | – | Pagination offset |
| q | string | – | Keyword search query |
| query | string | – | 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. |
| region | string | – | Filter by region (sea, us, eu, au) |
No output schema declared.
No examples provided.
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 81 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,143 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 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.