buywhere-mcp

MCP server for the BuyWhere product catalog. Lets Claude Desktop, Cursor, Windsurf, and other MCP-compatible agents search and retrieve products without writing any HTTP code.

Setup

1. Get your API key

Sign up at buywhere.ai/dashboard and copy your API key.

2. Configure your client

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "buywhere-mcp"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Open Settings → MCP and add a new server, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "buywhere-mcp"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Remote / Streamable HTTP

BuyWhere also exposes a hosted MCP endpoint for agents that support remote connections:

https://api.buywhere.ai/mcp

Requires Authorization: Bearer <your-api-key> header.

---

Tools

Tool	Description	Parameters
search_products	Search by keyword or natural language	query (required), category, limit
get_product	Fetch full details for a single product	product_id (required)
find_best_price	Find the cheapest listing for a product across all merchants	product_name, category
get_deals	Find products with price drops	category, min_discount_pct, limit

Environment variables

Variable	Required	Description
BUYWHERE_API_KEY	yes	Your BuyWhere API key
BUYWHERE_API_URL	no	Override base URL (default: https://api.buywhere.ai)

Development

npm install
npm run build
BUYWHERE_API_KEY=your_key BUYWHERE_API_URL=https://api.buywhere.ai node dist/index.js

License

MIT