@buywhere/mcp-tools

@buywhere/mcp-tools

BuyWhere MCP (Model Context Protocol) tools for AI agents. Enables product search, price comparison, deals discovery, price history tracking, and reviews aggregation through the MCP protocol. Includes 9 tools: search_products, compare_products, get_deals, get_product, list_categories, get_price_history, get_deals_feed, get_product_reviews, and autocomplete.

Installation

npm install @buywhere/mcp-tools

Requirements

• Node.js 18+
• A BuyWhere API key (get one at https://buywhere.ai)

Quick Start

import { createBuyWhereMCPServer } from '@buywhere/mcp-tools';

const server = createBuyWhereMCPServer({
  apiKey: process.env.BUYWHERE_API_KEY!,
});

server.start();

Available Tools

search_products

Search the BuyWhere product catalog.

{
  query: "mechanical keyboard",
  country?: "SG" | "MY" | "TH" | "PH" | "VN" | "ID" | "US",
  limit?: number,
  offset?: number,
  price_min?: number,
  price_max?: number
}

compare_products

Compare prices across merchants for a product.

{
  query: "iphone 15 case",
  category?: string,
  limit?: number
}

get_deals

Get current deals and price drops.

{
  country?: "SG" | "MY" | "TH" | "PH" | "VN" | "ID" | "US",
  category?: string,
  limit?: number,
  min_discount_pct?: number
}

get_product

Get detailed product information by ID.

{
  product_id: number
}

list_categories

Browse the category taxonomy.

{
  parent_id?: string  // omit for root categories
}

get_price_history

Get historical price data for a product to track price trends.

{
  product_id: number,
  country?: "SG" | "MY" | "TH" | "PH" | "VN" | "ID" | "US",
  period?: "7d" | "30d" | "90d" | "1y"
}

get_deals_feed

Get a streaming feed of deals and price drops.

{
  country?: "SG" | "MY" | "TH" | "PH" | "VN" | "ID" | "US",
  category?: string,
  limit?: number,
  offset?: number,
  min_discount_pct?: number
}

get_product_reviews

Get review summary for a product from multiple retailers.

{
  product_id: number,
  country?: "SG" | "MY" | "TH" | "PH" | "VN" | "ID" | "US"
}

autocomplete

Get search suggestions and completions as the user types.

{
  query: string,
  country?: "SG" | "MY" | "TH" | "PH" | "VN" | "ID" | "US",
  limit?: number
}

Usage with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-tools", "buywhere-mcp"],
      "env": {
        "BUYWHERE_API_KEY": "your-api-key"
      }
    }
  }
}

Usage with Cursor

In Cursor settings, add a new MCP server with the same configuration.

Environment Variables

Variable	Description
BUYWHERE_API_KEY	Your BuyWhere API key

SDK Reference

For the full BuyWhere SDK, see @buywhere/sdk.

License

MIT