BuyWhere MCP Integration

BuyWhere exposes its product catalog as an MCP (Model Context Protocol) server. AI agents can search, compare, and retrieve product data without writing HTTP glue code.

Transport: HTTP (POST https://api.buywhere.ai/mcp) for remote agents. STDIO (local process) coming soon via npm.

Install

The hosted MCP server is live. Point your MCP client directly at https://api.buywhere.ai/mcp — no local install required.

Note: The buywhere-mcp npm package (for STDIO / local process mode) is not yet published. Use the HTTP transport below until it is available.

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "buywhere": {
      "url": "https://api.buywhere.ai/mcp",
      "headers": { "Authorization": "Bearer bw_live_xxx" }
    }
  }
}

Restart Claude Desktop. The BuyWhere tools appear automatically.

Configure Cursor

In .cursor/mcp.json in your project root (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "buywhere": {
      "url": "https://api.buywhere.ai/mcp",
      "headers": { "Authorization": "Bearer bw_live_xxx" }
    }
  }
}

Remote HTTP Transport

For agents running in cloud environments:

POST https://api.buywhere.ai/mcp
Authorization: Bearer bw_live_xxx
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": { "query": "wireless headphones", "max_price": 150 }
  },
  "id": 1
}

Available Tools

Tool	Description
`search_products`	Search catalog by keyword, category, price range, platform, country
`get_product`	Full product details by ID
`compare_products`	Side-by-side comparison of 2–5 products
`get_deals`	Current deals and price drops
`list_categories`	Browse available product categories

Authentication

Pass your API key as a Bearer token. Get a free key at https://api.buywhere.ai/v1/developers/signup.

Key tier	Rate limit	Use case
`bw_free_*`	60 req/min	Demo, testing
`bw_live_*`	600 req/min	Production
`bw_partner_*`	Unlimited	Platform data partners

Error Handling

MCP error code	Meaning
`invalid_params`	Missing or invalid tool arguments
`not_found`	Product / category not found
`rate_limited`	Rate limit exceeded — exponential backoff (2s → 4s → 8s)
`unauthorized`	Invalid or missing API key
`internal_error`	BuyWhere API error

OpenAPI spec · Plugin manifest · api@buywhere.ai