README.md

BuyWhere MCP Plugin for Cursor

Agent-native product catalog API for AI shopping agents. Search 1.5M+ products, compare prices across Shopee, Lazada, Amazon, and 20+ platforms.

Features

• Product Search: Full-text search across 1.5M+ products
• Price Comparison: Compare prices across 20+ e-commerce platforms
• Deal Discovery: Find products with significant discounts
• Category Browsing: Explore product categories for discovery flows

Available Tools

Tool	Description
search_products	Search products by keyword with filters
get_product	Get full product details by ID
find_best_price	Find cheapest listing across platforms
get_deals	Discover discounted products
browse_categories	Explore category taxonomy
get_category_products	Get products within a category

Installation

1. Download and install this plugin from the Cursor Marketplace
2. Configure your BuyWhere API key:

   export BUYWHERE_API_KEY="bw_live_your_key_here"

Setup

Add to your mcp_config.json or use the Cursor MCP settings UI to configure:

{
  "mcpServers": {
    "buywhere": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "BUYWHERE_API_KEY": "bw_live_your_key_here",
        "BUYWHERE_API_URL": "https://api.buywhere.ai"
      }
    }
  }
}

Get Your API Key

Sign up at https://buywhere.ai/api-keys

Documentation

• Developer Docs: https://docs.buywhere.ai
• MCP Guide: https://api.buywhere.ai/docs/guides/mcp
• GitHub: https://github.com/buywhere/buywhere-api

Use Cases

• Build shopping agents that can search and compare products
• Create price tracking bots
• Develop deal discovery workflows
• Integrate product data into e-commerce agents

Requirements

• Python 3.10+
• BuyWhere API key (free at https://buywhere.ai/api-keys)