buywhere-catalog
Registry code: e301f31ef5f29bed
Retired. Use io.github.BuyWhere/buywhere-mcp instead.
from a public catalogue that lists it, not from the operator
- endpoint
- https://mcp.buywhere.ai/mcp
- door code
- 32b8ef3ccebaeabf
- protocol
- streamable-http ·2024-11-05
- authentication
- none observed
- public key
- none — nobody has proven they own this listing
- karma
- 0 · newcomer
last good check
of 13 tools
- used for
- compare products
- find best price
- find similar products
- get product deals
- search product catalog
- takes → gives
- text, data → data
- tools
- 12 reads1 changes data
The one measurement on this page that an operator cannot produce by editing a file on its own server: somebody else chose it, and paid to. Read the accounts before the calls — volume from one account is one relationship, and calling yourself is the cheap half. Both are what the ranking is built from, printed so the order can be checked rather than taken on trust.
distinct, expensive to fake
successful, last 30 days
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
find_best_price reads auth-required 49m ago
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.
{ "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\")" } } }arguments 50 linessearch_products reads auth-required never probed
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.
{ "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)." } } }arguments 81 linescompare_products reads auth-required never probed
Compare multiple products side-by-side. Returns price, brand, rating, and category for each.
{ "type": "object", "required": [ "ids" ], "properties": { "ids": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "minItems": 2, "description": "Array of product IDs to compare (2-10)" } } }arguments 17 linesingest_products changes data auth-required never probed
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.
{ "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)" } } }arguments 90 linessearch_products_v2 reads auth-required never probed
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.
{ "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)." } } }arguments 80 linesget_product_v2 reads auth-required never probed
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.
{ "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\")." } } }arguments 17 linescompare_products_v2 reads auth-required never probed
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.
{ "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\")." } } }arguments 22 linesget_deals_v2 reads auth-required never probed
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.
{ "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)" } } }arguments 55 linesfind_best_price_v2 reads auth-required never probed
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.
{ "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\")" } } }arguments 49 linesget_deals reads auth-required 49m ago
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"`.
{ "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)" } } }arguments 56 lineslist_categories reads auth-required 49m ago
List top-level product categories available in the BuyWhere catalog.
{ "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." } } }arguments 39 linesget_product reads auth-required never probed
Get a specific product by its ID, including full details and current price.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "Product UUID" } } }arguments 12 linesfind_similar reads auth-required never probed
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.
{ "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" } } }arguments 17 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
[](https://brick.blue/agent/e301f31ef5f29bed)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Own the domain? Prove it and the listing carries a verified badge here too: passport.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.
Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.
- buywhere.ai
- api.buywhere.ai
- docs.buywhere.ai BuyWhere