MCP Radar
MCP Server

buywhere-mcp

io.github.BuyWhere/buywhere-mcp
Commerce & Retail Public & reachable MCP 2026-07-28

What this MCP does

Searches a large multi-merchant product catalog, compares products and prices, finds deals and similar items, and returns market-specific shopping links.

Capabilities

Tools

13 tools
compare_products
Compare multiple products side-by-side. Returns price, brand, rating, and category for each.
Input schema 
{'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 2, 'description': 'Array of product IDs to compare (2-10)'}}}
compare_products_v2
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.
Input schema 
{'type': 'object', 'required': ['ids', 'deliver_to'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 2, 'description': 'Array of product IDs to compare (2-10)'}, 'deliver_to': {'type': 'string', 'description': 'REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").'}}}
find_best_price
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.
Input schema 
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Keyword search query — alias for product_name'}, 'market': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code).'}, 'region': {'enum': ['us', 'sea'], 'type': 'string', 'description': 'Region filter - use "us" for United States or "sea" for Southeast Asia'}, 'country': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code)'}, 'category': {'type': 'string', 'description': 'Category to filter by (e.g., "electronics", "fashion")'}, 'deliver_to': {'type': 'string', 'description': '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.'}, 'country_code': {'enum': ['SG', 'MY', 'TH', 'PH', 'VN', 'ID', 'US'], 'type': 'string', 'description': 'Country to search in (defaults to SG). Alias: country.'}, 'product_name': {'type': 'string', 'description': 'Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")'}}}
find_best_price_v2
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.
Input schema 
{'type': 'object', 'required': ['deliver_to'], 'properties': {'q': {'type': 'string', 'description': 'Keyword search query — alias for product_name'}, 'region': {'enum': ['us', 'sea'], 'type': 'string', 'description': 'Region filter - use "us" for United States or "sea" for Southeast Asia'}, 'country': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code)'}, 'category': {'type': 'string', 'description': 'Category to filter by (e.g., "electronics", "fashion")'}, 'deliver_to': {'type': 'string', 'description': 'REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").'}, 'country_code': {'enum': ['SG', 'MY', 'TH', 'PH', 'VN', 'ID', 'US'], 'type': 'string', 'description': 'Country to search in (defaults to SG). Alias: country.'}, 'product_name': {'type': 'string', 'description': 'Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")'}}}
find_similar
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.
Input schema 
{'type': 'object', 'required': ['product_id'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'description': 'Number of similar products to return (1-10, default 10)'}, 'product_id': {'type': 'string', 'description': 'UUID of the source product'}}}
get_deals
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"`.
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'description': 'Number of results (max 100, default 20)'}, 'market': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code).'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'region': {'type': 'string', 'description': 'Filter by region (sea, us, eu, au)'}, 'country': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code)'}, 'category': {'type': 'string', 'description': '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.'}, 'currency': {'type': 'string', 'default': 'SGD', 'description': 'Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.'}, 'deliver_to': {'type': 'string', 'description': '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.'}, 'country_code': {'enum': ['SG', 'US', 'VN', 'TH', 'MY'], 'type': 'string', 'description': 'Filter by ISO country code. Alias: country.'}, 'min_discount': {'type': 'number', 'default': 10, 'description': 'Minimum discount percentage (default 10)'}}}
get_deals_v2
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.
Input schema 
{'type': 'object', 'required': ['deliver_to'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'description': 'Number of results (max 100, default 20)'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'region': {'type': 'string', 'description': 'Filter by region (sea, us, eu, au)'}, 'country': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code)'}, 'category': {'type': 'string', 'description': '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.'}, 'currency': {'type': 'string', 'default': 'SGD', 'description': 'Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.'}, 'deliver_to': {'type': 'string', 'description': 'REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").'}, 'country_code': {'enum': ['SG', 'US', 'VN', 'TH', 'MY'], 'type': 'string', 'description': 'Filter by ISO country code. Alias: country.'}, 'min_discount': {'type': 'number', 'default': 10, 'description': 'Minimum discount percentage (default 10)'}}}
get_product
Get a specific product by its ID, including full details and current price.
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Product UUID'}}}
get_product_v2
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.
Input schema 
{'type': 'object', 'required': ['id', 'deliver_to'], 'properties': {'id': {'type': 'string', 'description': 'Product UUID'}, 'deliver_to': {'type': 'string', 'description': 'REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").'}}}
ingest_products
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.
Input schema 
{'type': 'object', 'required': ['source', 'products'], 'properties': {'source': {'type': 'string', 'description': 'Data source identifier (e.g. "shopee_sg", "amazon_sg", "lazada_sg")'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['sku', 'merchant_id', 'title', 'price', 'url'], 'properties': {'sku': {'type': 'string', 'description': 'Unique stock keeping unit identifier'}, 'url': {'type': 'string', 'description': 'Product URL on the merchant site'}, 'brand': {'type': 'string', 'description': 'Brand name'}, 'price': {'type': 'number', 'description': 'Current price (must be >= 0)'}, 'title': {'type': 'string', 'description': 'Product title'}, 'region': {'type': 'string', 'description': 'Region identifier (e.g. "sea", "us")'}, 'category': {'type': 'string', 'description': 'Product category'}, 'currency': {'type': 'string', 'default': 'SGD', 'description': 'Currency code (default: SGD)'}, 'metadata': {'type': 'object', 'description': 'Additional product metadata'}, 'image_url': {'type': 'string', 'description': 'Main product image URL'}, 'is_active': {'type': 'boolean', 'description': 'Whether the product is active (default: true)'}, 'description': {'type': 'string', 'description': 'Product description'}, 'merchant_id': {'type': 'string', 'description': 'Merchant identifier'}, 'country_code': {'type': 'string', 'description': 'ISO country code (e.g. "SG", "US")'}, 'is_available': {'type': 'boolean', 'description': 'Whether the product is in stock'}}}, 'description': 'Array of product objects to ingest (max 1000)'}}}
list_categories
List top-level product categories available in the BuyWhere catalog.
Input schema 
{'type': 'object', 'properties': {'market': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code).'}, 'region': {'enum': ['us', 'sg', 'my', 'gb', 'in', 'au'], 'type': 'string', 'description': 'Region alias mapped to ISO country code.'}, 'country': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code)'}, 'country_code': {'enum': ['SG', 'US', 'VN', 'TH', 'MY', 'GB', 'IN', 'AU'], 'type': 'string', 'description': 'Filter by ISO country code. Defaults to SG.'}}}
search_products
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.
Input schema 
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Keyword search query'}, 'mode': {'enum': ['keyword', 'semantic', 'hybrid'], 'type': 'string', 'default': 'keyword', 'description': '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.'}, 'limit': {'type': 'integer', 'default': 20, 'description': 'Number of results (max 100, default 20)'}, 'query': {'type': 'string', 'description': '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.'}, 'domain': {'type': 'string', 'description': 'Filter by merchant platform (e.g. lazada, shopee, amazon)'}, 'market': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code).'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'region': {'type': 'string', 'description': 'Filter by region (sea, us, eu, au)'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.'}, 'country': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code)'}, 'category': {'type': 'string', 'description': 'Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.'}, 'max_price': {'type': 'number', 'description': 'Maximum price (in currency inferred from country_code, or SGD by default)'}, 'min_price': {'type': 'number', 'description': 'Minimum price (in currency inferred from country_code, or SGD by default)'}, 'deliver_to': {'type': 'string', 'description': '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.'}, 'country_code': {'enum': ['SG', 'US', 'VN', 'TH', 'MY'], 'type': 'string', 'description': 'Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).'}}}
search_products_v2
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.
Input schema 
{'type': 'object', 'required': ['deliver_to'], 'properties': {'q': {'type': 'string', 'description': 'Keyword search query'}, 'mode': {'enum': ['keyword', 'semantic', 'hybrid'], 'type': 'string', 'default': 'keyword', 'description': '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.'}, 'limit': {'type': 'integer', 'default': 20, 'description': 'Number of results (max 100, default 20)'}, 'query': {'type': 'string', 'description': '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.'}, 'domain': {'type': 'string', 'description': 'Filter by merchant platform (e.g. lazada, shopee, amazon)'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'region': {'type': 'string', 'description': 'Filter by region (sea, us, eu, au)'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.'}, 'country': {'type': 'string', 'description': 'Alias for country_code (deprecated, use country_code)'}, 'category': {'type': 'string', 'description': 'Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.'}, 'max_price': {'type': 'number', 'description': 'Maximum price (in currency inferred from country_code, or SGD by default)'}, 'min_price': {'type': 'number', 'description': 'Minimum price (in currency inferred from country_code, or SGD by default)'}, 'deliver_to': {'type': 'string', 'description': 'REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").'}, 'country_code': {'enum': ['SG', 'US', 'VN', 'TH', 'MY'], 'type': 'string', 'description': 'Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).'}}}
History

Recent tool changes

Changed
get_deals_v2
Sept. 27, 2026, 2:43 a.m.
Changed
get_deals
Sept. 27, 2026, 2:43 a.m.
Changed
get_deals_v2
Sept. 19, 2026, 2:41 a.m.
Changed
get_deals
Sept. 19, 2026, 2:41 a.m.
Added
find_best_price_v2
Sept. 17, 2026, 12:40 p.m.
Added
get_deals_v2
Sept. 17, 2026, 12:40 p.m.
Added
compare_products_v2
Sept. 17, 2026, 12:40 p.m.
Added
get_product_v2
Sept. 17, 2026, 12:40 p.m.
Added
search_products_v2
Sept. 17, 2026, 12:40 p.m.
Added
ingest_products
Sept. 17, 2026, 12:40 p.m.
Added
find_similar
Sept. 17, 2026, 12:40 p.m.
Added
find_best_price
Sept. 17, 2026, 12:40 p.m.
Added
list_categories
Sept. 17, 2026, 12:40 p.m.
Added
get_deals
Sept. 17, 2026, 12:40 p.m.
Added
compare_products
Sept. 17, 2026, 12:40 p.m.
Added
get_product
Sept. 17, 2026, 12:40 p.m.
Added
search_products
Sept. 17, 2026, 12:40 p.m.
Discover

Similar MCP servers

AgentLot Marketplace

io.agentlot/marketplace

Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.

apex-x1

xyz.apexfaucet/apex-x1

Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…

SpellBook Finance

com.spellbook-finance/mcp

Provides Magic: The Gathering and other trading-card market prices, buylist offers, arbitrage analysis, sealed-product EV, seller…

API Direct

io.apidirect/api-direct

Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…

Digital Manager Guru

io.github.mcp-dir/guru-mcp

Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…

Pagar.me

io.github.mcp-dir/pagarme-mcp

Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…

amazon-product-research-mcp

com.webotee/amazon-product-research-mcp

Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…

AgentLux

io.github.agentlux/agentlux

Operates an agent avatar marketplace with item generation, purchases, creator earnings, public profiles, social activity, and ERC…