Give Your AI Agent Shopping Superpowers: BuyWhere MCP Server Tutorial

#tutorial #mcp #python #ai

What You Will Build

Give any AI agent the ability to search, compare, and discover real product inventory across 180+ categories and 6 markets.

Get Your API Key

Go to buywhere.ai/api-keys — free, takes 30 seconds.

Integration Options

Claude Desktop / Any MCP Client

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

Python

from mcp import ClientSession
session = await ClientSession.connect("https://api.buywhere.ai/mcp")
results = await session.call_tool("search_products", {"query": "wireless headphones", "market": "US"})

Direct curl

curl https://api.buywhere.ai/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"iPhone 16","market":"SG"}}}'

Tools Available

search_products - Search by keyword, category, price, region
get_product - Full product details (prices, specs, images)
find_best_price - Lowest price across markets
compare_products - Side-by-side comparison
get_deals - Current price drops
list_categories - Product taxonomy

Live Markets

SG, US, JP, KR, CN, AU covering Lazada, Shopee, Amazon, Rakuten and more.

Build With Us

Running a Build With BuyWhere AI Agent Challenge - build an agent with 2+ BuyWhere tools, win API credits, and featured placement.

Open source (MIT). GitHub | API docs

DEV Community