AI agents use BuyWhere to search, compare prices, and discover deals across 11M+ products in Singapore, Southeast Asia, and US markets — in real time.
- Search products across Singapore, SEA, and US markets by keyword, category, or price range
- Compare prices across Lazada, Shopee, Amazon, and local retailers in a single query
- Find deals and track real-time pricing with multi-currency support
- Build shopping agents that recommend, compare, and link to products programmatically
- Discover product catalogs with structured taxonomy for any region
Join the "Build With BuyWhere" AI Agent Developer Challenge! Use the BuyWhere MCP server to create AI agents that search, compare, and recommend products across Singapore, SEA, and US markets.
- Prize pool: $5,000 USD
- Deadline: June 30, 2026
- Challenge page: buywhere.ai/challenge
Product search API for AI agents via Model Context Protocol. Search & compare 11M+ products — built for AI agent commerce, not store management.
Works with Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev, and any MCP-compatible client. Also supports Agent-to-Agent (A2A) protocol.
44-second demo: product search, deal discovery, price comparison, and multi-region support.
User: "Find me wireless earbuds under $50 available in Singapore"
Agent: [calls search_products → returns 5 matching products]
User: "Compare the top 3"
Agent: [calls compare_prices → side-by-side with best-value pick]
export BUYWHERE_API_KEY=bw_live_xxxx
npx -y @buywhere/mcp-serverGet your free API key → buywhere.ai/api-keys
- Part 1: MCP for Ecommerce — The Missing Infrastructure Layer for AI Agent Shopping — Architecture and why agents need a product catalog API
- Part 2: Build a Real Shopping Agent in 15 Minutes — Hands-on: set up MCP server, search products, compare prices, build a working agent
Read the BuyWhere Engineering Blog for deep dives on MCP architecture, agent commerce, and the ecosystem.
- MCP for Ecommerce 2026 — How AI agents search real products, compare prices across markets, and why MCP is the standard
- Building Production MCP Servers — Architecture, tool design patterns, and distribution from 0 to 1,700+ daily npm downloads
- MCP Server Ecosystem 2026 — Every MCP category mapped (4,800+ servers across 40+ domains)
- AI Agent Commerce: Missing Infrastructure — Why shopping is the last unbuilt layer of the agent-native economy
- Cross-Border Price Comparison Tutorial — Build a shopping agent in 10 minutes with BuyWhere MCP
| Tool | Description |
|---|---|
search_products |
Search catalog by keyword, category, price, region |
get_product |
Full product details by ID (prices, specs, images) |
compare_prices |
Side-by-side comparison of 2–5 products |
get_price |
Current prices across all merchants for one product |
get_affiliate_link |
Click-tracked affiliate URL for a product |
get_catalog |
Available product category taxonomy |
Add to claude_desktop_config.json:
{
"mcpServers": {
"buywhere": {
"command": "npx",
"args": ["-y", "@buywhere/mcp-server"],
"env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
}
}
}Add to your MCP settings file:
{
"mcpServers": {
"buywhere": {
"command": "npx",
"args": ["-y", "@buywhere/mcp-server"],
"env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
}
}
}Add to ~/.windsurf/mcp.json:
{
"mcpServers": {
"buywhere": {
"command": "npx",
"args": ["-y", "@buywhere/mcp-server"],
"env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
}
}
}Add to opencode.json:
{
"mcpServers": {
"buywhere": {
"command": "npx",
"args": ["-y", "@buywhere/mcp-server"],
"env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
}
}
}Add to ~/.continue/config.json:
{
"experimental": {
"mcpServers": {
"buywhere": {
"command": "npx",
"args": ["-y", "@buywhere/mcp-server"],
"env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
}
}
}
}| Variable | Default | Description |
|---|---|---|
BUYWHERE_API_KEY |
(required) | API key from buywhere.ai/api-keys |
BUYWHERE_API_URL |
https://api.buywhere.ai/mcp |
Custom API base URL |
# Run directly (no install)
npx -y @buywhere/mcp-server
# Install globally
npm install -g @buywhere/mcp-server
buywhere-mcp- Shopping agents — build AI agents that search, compare, recommend products across markets
- Price comparison — multi-market pricing in a single query across Lazada, Shopee, Amazon, local retailers
- Deal discovery — find best-value products with real-time pricing and inventory
- Ecommerce automation — integrate product search into any MCP-compatible app
- Cross-border commerce — compare prices between Singapore, SEA, and US markets
- Agent-to-Agent commerce — delegate shopping tasks between agents via A2A protocol
Developer's AI Agent (Claude, Cursor, etc.)
│
├── MCP Protocol (stdio)
│
├── @buywhere/mcp-server
│ ├── search_products(q, category, min_price, max_price, country_code)
│ ├── get_product(product_id)
│ ├── compare_prices(product_ids[])
│ ├── get_price(product_id)
│ ├── get_affiliate_link(product_id, platform)
│ └── get_catalog()
│
└── BuyWhere API (api.buywhere.ai)
└── 11M+ products across SG, SEA, US
git clone https://github.com/BuyWhere/buywhere-mcp.git
cd buywhere-mcp
npm install
npm run build
npm startBuyWhere is a product search API for AI agents. We aggregate 11M+ products from Singapore, Southeast Asia, and US markets into a single, agent-friendly interface — no store management, no Shopify integration. Just search and compare products in real time.
- One API — all markets, all retailers
- Agent-native — built for MCP from day one
- Real-time — live pricing and availability
- Developer-first — no SDK needed, just add the server
| Protocol | Support |
|---|---|
| MCP (Model Context Protocol) | Full support — 6 tools, stdio transport |
| A2A (Agent-to-Agent) | Multi-agent task delegation — Agent Card |
See CONTRIBUTING.md for how to report issues, submit PRs, and suggest features.
If you find this project useful:
- ⭐ Star the repo — it helps others discover BuyWhere
- 🐛 Open an issue for bugs or feature requests
- 💬 Start a discussion for questions or ideas
- 📣 Share it with other developers who build AI agent tools
MIT