# BuyWhere/buywhere-mcp [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/BuyWhere/buywhere-mcp  
**GitHub Stars:** 10  
**npm Downloads (last month):** 1261  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/buywhere-buywhere-mcp

## Description
Cross-border e-commerce product catalog for AI agents. Search 3M+ products across Singapore, SEA, and US markets with price comparison and deal discovery. Install via npx @buywhere/mcp-server.

## Tools
Capabilities this server exposes over MCP:

- **search_products** — Search catalog by keyword, category, price, country
- **get_product** — Full product details by ID (prices, specs, images)
- **compare_products** — Side-by-side comparison of 2–10 products
- **find_best_price** — Cheapest deliverable listing for a product across merchants
- **get_deals** — Products with significant price drops
- **list_categories** — Available product category taxonomy
- **find_similar** — Similar products by vector similarity
- **ingest_products** — Submit product URLs for catalog ingestion (agents/merchants)
- **search_products_v2** — v2 search; requires `deliver_to` (ISO country)
- **get_product_v2** — v2 product details by ID
- **compare_products_v2** — v2 comparison; optional `deliver_to
- **get_deals_v2** — v2 deals; requires `deliver_to
- **find_best_price_v2** — v2 best price; requires `deliver_to

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "buywhere-mcp": {
    "command": "npx",
    "args": ["-y","@buywhere/mcp-server"],
    "env": {
      "BUYWHERE_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `BUYWHERE_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What BuyWhere/buywhere-mcp does

BuyWhere/buywhere-mcp MCP server exposes product catalog and price-comparison operations to MCP-compatible AI clients. The catalog contains more than 3 million products and covers Singapore, the United States, Malaysia, Thailand, and Vietnam markets according to the project material. Agents can search by keyword, category, price range, and country, then retrieve structured information such as prices, specifications, and images.

The server is intended for agent commerce workflows, including product recommendations, cross-border research, comparison shopping, and deal discovery. It is described as a product search API rather than a system for managing an online store.

## How it works

The package runs as an MCP server and communicates with clients through the standard MCP interface. A local installation uses the npm package with an API key supplied through the environment. The project also documents a remote endpoint at `https://api.buywhere.ai/mcp`, using JSON-RPC 2.0 and protocol version `2024-11-05`.

BuyWhere/buywhere-mcp can be connected to Claude Desktop, Cursor, Cline, Windsurf, and other MCP-compatible clients listed by the project. The README also describes compatibility with VS Code Copilot, OpenCode, Codex, Continue.dev, and agent frameworks including CrewAI and Mastra.

## Setup and configuration

Install the local server with Node.js and npm:

```bash
export BUYWHERE_API_KEY=bw_live_xxxx
npx -y @buywhere/mcp-server
```

The README indicates Node.js 18 or newer. An API key can be obtained through the BuyWhere API-key page or by registering with the documented `POST https://api.buywhere.ai/v1/auth/register` request. Configure the same command and environment variable in the MCP settings for the client you use. The example configurations use `npx -y @buywhere/mcp-server`, which avoids an interactive npm confirmation prompt.

The BuyWhere/buywhere-mcp MCP server can also be used through the hosted MCP endpoint instead of running the npm package locally. The provided material does not specify separate environment variables for the remote configuration.

## Tools and capabilities

The server documents these operations:

- Search products by keyword, category, price, or country.
- Fetch product details by ID, including prices, specifications, and images.
- Compare between two and ten products side by side.
- Find the lowest-priced deliverable listing across merchants.
- Find products with significant price drops.
- List the available product-category taxonomy.
- Find similar products using vector similarity.
- Submit product URLs for catalog ingestion.

Version 2 tools add delivery-aware behavior. `search_products_v2`, `get_deals_v2`, and `find_best_price_v2` require a `deliver_to` ISO country value; `compare_products_v2` accepts it optionally, and `get_product_v2` retrieves product details by ID.

## Limitations and notes

The documented regional coverage is focused on Singapore, the US, Malaysia, Thailand, and Vietnam, so availability outside those markets is not established by the supplied material. Requests require a BuyWhere API key for the local package. Product prices, merchant listings, and delivery results may depend on the selected market and, for v2 operations, the destination country. The repository is licensed under MIT.

## Getting started with this BuyWhere/buywhere-mcp MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/buywhere-buywhere-mcp/readme_