@buywhere/mcp-server

BuyWhere MCP Server

Agent-native product catalog API — 50M+ products, real-time pricing, cross-border search for AI agents via Model Context Protocol.

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

Install

npm install -g @buywhere/mcp-server

Or run directly:

npx @buywhere/mcp-server

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

Demo

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]

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

Development

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

Why BuyWhere?

The first agent-native cross-border product catalog API. 50M+ products indexed from 3,700+ retailers across Singapore, Southeast Asia, and US markets — all through a single MCP server.

• 50M+ products — across 6 markets, all categories
• Agent-native — built for Model Context Protocol from day one
• Real-time pricing — live prices and availability from Lazada, Shopee, Amazon, and local retailers
• Developer-first — npx @buywhere/mcp-server, no SDK needed
• Trusted — serving 100K+ queries/month to 100+ AI agent developers

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