Buywhere MCP Server

by buywhere Your server? Claim it

answering

Buywhere MCP is answering right now. Last checked 6 min ago. 101 installs a week from npm. It exposes 13 tools. Last commit 22 Sep 2026.

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

Installs per day peak 319 · avg 42 · +40% w/w

a month agotoday

Uptime history 51 days of history · worst day 46%

51 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

490 ms

Response time

average over 24h

101

Installs / week

npm and PyPI

What changed 183

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 10 August 2026. No other catalogue keeps this.

17 Sep 2 tools changed the parameters they ask for get_deals, get_deals_v2

14 Sep 2 tools changed the parameters they ask for get_deals, get_deals_v2

3 Sep 3 tool descriptions were rewritten find_best_price, get_deals, search_products

2 Sep 3 tool descriptions were rewritten6 times that day find_best_price, get_deals, search_products

1 Sep 2 tools changed the parameters they ask for6 times that day search_products, search_products_v2

1 Sep 2 tool descriptions were rewritten search_products, search_products_v2

30 Aug 5 tools changed the parameters they ask for16 times that day find_best_price, get_deals, list_categories and 2 more

30 Aug 8 tools appeared compare_products_v2, find_best_price, find_best_price_v2 and 5 more

30 Aug 8 tools disappeared compare_products_v2, find_best_price, find_best_price_v2 and 5 more

30 Aug 3 tool descriptions were rewritten5 times that day find_best_price, get_deals, search_products

and 145 more, back to 10 August 2026

Nothing serious here today

Today is the operative word: we check Buywhere MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 6 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add buywhere-mcp --transport http https://api.buywhere.ai/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "buywhere-mcp": {
      "url": "https://api.buywhere.ai/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.buywhere-mcp]
url = "https://api.buywhere.ai/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "buywhere-mcp": {
      "url": "https://api.buywhere.ai/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "buywhere-mcp": {
      "url": "https://api.buywhere.ai/mcp"
    }
  }
}

This one needs environment variables set before it will start: BUYWHERE_API_KEY (API key from https://api.buywhere.ai/v1/auth/register). The author declared them in the registry entry; get the values from the project itself.

Available tools 13

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

best

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.

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.

compare

compare_products

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

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.

deals

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) 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"`.

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

product

get_product

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

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.

products

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.

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.

Endpoints

URL	Transport	State	Latency	Checked
https://api.buywhere.ai/mcp	streamable-http	answering	527 ms	6 min ago

Alternatives to Buywhere MCP

same job, measured the same way

Agent Commerce

by petraport

AI-agent product catalog: search, lookup & purchase routing over verified merchant data.

answering

Marea — Storefront Backend for Agents

by mareaalcalina

Manage a Marea Alcalina storefront from an AI agent: catalog, products, publishing.

answering

Shopify Catalog Monitor

by dizzyvinci

Track price drops, stock-outs, restocks, and new/removed products across Shopify stores.

answering

Sputnikx Market

by drivenbymyai-max

EU trade analytics, product catalog, orders, and heating fuel calculator for AI agents.

local only

Store

by bolotstudio

Custom metal-print storefront: catalog search, product details, shipping, reviews. Read-only.

11 tools answering

Ecommerce Intelligence MCP Server

by thenextgennexus

Analyze Shopify stores, get product catalogs, pricing strategies, and store performance data

23 installs/wk local only

CalmActiva

by langhoormarchal-beep

Realtime CBD product catalog, prices, stock and FAQ from CalmActiva.

5 tools answering

MCP Stripe Acp

by codespar

Stripe ACP — AI agent checkout, payment delegation, products, invoices

23 installs/wk local only

Buywhere MCP — questions

Answers built from our own checks of this server.

What can Buywhere MCP do?

It exposes 13 tools, read directly from the server on our last check. Among them: compare_products, compare_products_v2, find_best_price, find_best_price_v2, find_similar, get_deals and 7 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Buywhere MCP mostly used for?

Its tools cluster around product, products and compare. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Buywhere MCP working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 490 ms. The bar chart above shows every period we have measured.

How do I connect Buywhere MCP?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Buywhere MCP need an API key?

No. Buywhere MCP completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 13 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Buywhere MCP?

It answers our handshake in 490 ms on average, which is faster than 31% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use Buywhere MCP?

The npm package @buywhere/mcp-server was installed 101 times in the last week. Week over week that is +40%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Buywhere MCP open source?

Yes — it is published under the MIT licence, written in TypeScript, 14 stars on GitHub and 12 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.