Package Exports

@buywhere/mcp-server
@buywhere/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@buywhere/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

BuyWhere MCP Server

Build With BuyWhere Challenge

$5,000 in prizes — Build AI agents that shop smarter

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

Build a shopping agent, price comparison tool, deal finder, or any creative AI agent use case. Winners get cash prizes and featured promotion on BuyWhere channels.

Product search API for AI agents via Model Context Protocol. Search & compare 11M+ products across Singapore, SEA, and US markets — built for AI agent commerce, not store management.

Works with Claude Desktop, Cursor, VS Code Copilot, Cline, OpenCode, Codex, and any MCP-compatible client.

Demo

BuyWhere MCP in Claude Desktop

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]

Quick Start

export BUYWHERE_API_KEY=bw_live_xxxx
npx -y @buywhere/mcp-server

Get your free API key → buywhere.ai/api-keys

Tutorials

Part 1: MCP for Ecommerce — The Missing Infrastructure Layer for AI Agent Shopping — Understanding the architecture and why agents need a product catalog API
Part 2: Build a Real Shopping Agent in 15 Minutes — Hands-on tutorial: set up the MCP server, search products, compare prices, build a working agent

Tools

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

Use Cases

AI agents — search, compare, and recommend products across Singapore, SEA, and US markets in real time
Developers — add cross-border shopping capability to any MCP-compatible app with zero API integration
Price comparison — get multi-market pricing in a single query across Lazada, Shopee, Amazon, and local retailers

Quick Setup

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor / VS Code / Cline

Same config — add to your MCP settings file:

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

Configuration

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

Install

# Run directly (no install)
npx -y @buywhere/mcp-server

# Install globally
npm install -g @buywhere/mcp-server
buywhere-mcp

Development

git clone https://github.com/BuyWhere/buywhere-mcp.git
cd buywhere-mcp
npm install
npm run build
npm start

Why BuyWhere?

BuyWhere 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

A2A Protocol

BuyWhere also supports the Agent-to-Agent (A2A) protocol for multi-agent task delegation. View our Agent Card at /.well-known/agent.json.

Contributing

See CONTRIBUTING.md for how to report issues, submit PRs, and suggest features.

Support

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

License

MIT