io.github.BuyWhere/buywhere-mcp — Model Context Protocol (MCP) Server
The BuyWhere MCP server provides an agent-native product catalog for searching products and comparing prices. It supports real-time discovery of deals across merchants in Singapore and the US, including ranking via delivery-to information. The catalog covers 300M+ products and 150,000+ stores, exposed through an MCP interface with 13 tools.
🛠️ Key Features
Agent-native product catalog
Product search and price comparison
Real-time deal discovery
300M+ products across 150,000+ stores
Ranking includes deliver_to
🚀 Use Cases
Product search for AI agents
Price comparison across Singapore and US merchants
Deal discovery scoped by deliver_to ranking
⚡ Developer Benefits
MCP-compatible server with 13 tools
Works with MCP clients such as Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, and Continue.dev
Simple install via npx -y @buywhere/mcp-server using BUYWHERE_API_KEY
⚠️ Limitations
Catalog scope is described as covering Singapore and the US merchants only
Search the BuyWhere product catalog by keyword. Treat deliver_to as REQUIRED for buyer-facing use (ISO-3166 country of the end user); it takes precedence over country_code/country and prevents all-market scans. Returns product records with title, description, image, price, and merchant information. Covers e-commerce platforms across Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US. Use compact=true for agent-optimized responses with structured_specs, comparison_attributes, and normalized_price_usd fields. BUY-74597 degraded contract: when the catalog query cannot complete inside the user-facing timeout, this tool returns a 200-OK envelope with `meta.status="degraded"`, `meta.emptiness_reason="api_error"` with `meta.degraded_kind="timeout"` (or `"partial_timeout"` / `"auth_failure"`), `meta.confidence="low"`, and `meta.diagnostic.timed_out_stage` naming the failed stage (catalog_search / offer_aggregation / merchant_join). It never returns an unqualified empty result when the cause is timeout, auth failure, upstream exception, or circuit breaker. Agents should branch on `meta.degraded === true` (or `meta.status === "degraded"`) instead of treating empty `data` as no_match.
Parameters15
q
string
optional
Keyword search query
query
string
optional
Alias for q (accepted for agent convenience; use q). Without this, callers passing `query` get 0 rows and the reltuples-derived total — see BUY-75287.
domain
string
optional
Filter by merchant platform (e.g. lazada, shopee, amazon)
region
string
optional
Filter by region (sea, us, eu, au)
country_code
string
optional
Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).
deliver_to
string
optional
Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. "SG", "US"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country.
country
string
optional
Alias for country_code (deprecated, use country_code)
market
string
optional
Alias for country_code (deprecated, use country_code).
min_price
number
optional
Minimum price (in currency inferred from country_code, or SGD by default)
max_price
number
optional
Maximum price (in currency inferred from country_code, or SGD by default)
Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.
mode
string
optional
Search mode: keyword=FTS only (default, matches REST /v1/products/search), semantic=vector only, hybrid=RRF blend of FTS+vector. Falls back to keyword if vector DB or FLOWAI_EMBED_API_KEY unavailable.
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keyword search query"
},
"query": {
"type": "string",
"description": "Alias for q (accepted for agent convenience; use q). Without this, callers passing `query` get 0 rows and the reltuples-derived total — see BUY-75287."
},
"domain": {
"type": "string",
"description": "Filter by merchant platform (e.g. lazada, shopee, amazon)"
},
"region": {
"type": "string",
"description": "Filter by region (sea, us, eu, au)"
},
"country_code": {
"type": "string",
"enum": [
"SG",
"US",
"VN",
"TH",
"MY"
],
"description": "Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR)."
},
"deliver_to": {
"type": "string",
"description": "Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. \"SG\", \"US\"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country."
},
"country": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)"
},
"market": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)."
},
"min_price": {
"type": "number",
"description": "Minimum price (in currency inferred from country_code, or SGD by default)"
},
"max_price": {
"type": "number",
"description": "Maximum price (in currency inferred from country_code, or SGD by default)"
},
"limit": {
"type": "integer",
"description": "Number of results (max 100, default 20)",
"default": 20
},
"offset": {
"type": "integer",
"description": "Pagination offset",
"default": 0
},
"compact": {
"type": "boolean",
"description": "Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.",
"default": false
},
"category": {
"type": "string",
"description": "Filter by product category name (e.g. \"Laptops\", \"Smartphones\", \"Televisions\"). Use to exclude accessories and get actual products."
},
"mode": {
"type": "string",
"enum": [
"keyword",
"semantic",
"hybrid"
],
"description": "Search mode: keyword=FTS only (default, matches REST /v1/products/search), semantic=vector only, hybrid=RRF blend of FTS+vector. Falls back to keyword if vector DB or FLOWAI_EMBED_API_KEY unavailable.",
"default": "keyword"
}
}
}
get_product
Get a specific product by its ID, including full details and current price.
Get discounted products sorted by discount percentage. Returns schema.org/Product entities with schema.org/Offer properties: price, priceCurrency, availability, originalPrice, and discountPercentage. Covers Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US e-commerce. Supports currency, region (sea, us, eu, au) and country (SG, US, VN, MY, ...) filters. BUY-74597 degraded contract: when the discount-index scan cannot complete inside the user-facing timeout, this tool returns a 200-OK envelope with `meta.status="degraded"`, `meta.emptiness_reason="api_error"` with `meta.degraded_kind="timeout"` (or `"partial_timeout"` / `"auth_failure"`), `meta.confidence="low"`, and `meta.diagnostic.timed_out_stage` (typically `offer_aggregation`). It never returns an unqualified empty result when the cause is timeout, auth failure, upstream exception, or circuit breaker. Branch on `meta.degraded === true` or `meta.status === "degraded"`.
Parameters9
min_discount
number
optional
Minimum discount percentage (default 10)
currency
string
optional
Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.
region
string
optional
Filter by region (sea, us, eu, au)
country_code
string
optional
Filter by ISO country code. Alias: country.
deliver_to
string
optional
Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. "SG", "US"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country.
country
string
optional
Alias for country_code (deprecated, use country_code)
market
string
optional
Alias for country_code (deprecated, use country_code).
limit
integer
optional
Number of results (max 100, default 20)
offset
integer
optional
Pagination offset
Raw schema
{
"type": "object",
"properties": {
"min_discount": {
"type": "number",
"description": "Minimum discount percentage (default 10)",
"default": 10
},
"currency": {
"type": "string",
"description": "Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.",
"default": "SGD"
},
"region": {
"type": "string",
"description": "Filter by region (sea, us, eu, au)"
},
"country_code": {
"type": "string",
"enum": [
"SG",
"US",
"VN",
"TH",
"MY"
],
"description": "Filter by ISO country code. Alias: country."
},
"deliver_to": {
"type": "string",
"description": "Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. \"SG\", \"US\"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country."
},
"country": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)"
},
"market": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)."
},
"limit": {
"type": "integer",
"description": "Number of results (max 100, default 20)",
"default": 20
},
"offset": {
"type": "integer",
"description": "Pagination offset",
"default": 0
}
}
}
list_categories
List top-level product categories available in the BuyWhere catalog.
Parameters4
region
string
optional
Region alias mapped to ISO country code.
country_code
string
optional
Filter by ISO country code. Defaults to SG.
country
string
optional
Alias for country_code (deprecated, use country_code)
market
string
optional
Alias for country_code (deprecated, use country_code).
Raw schema
{
"type": "object",
"properties": {
"region": {
"type": "string",
"enum": [
"us",
"sg",
"my",
"gb",
"in",
"au"
],
"description": "Region alias mapped to ISO country code."
},
"country_code": {
"type": "string",
"enum": [
"SG",
"US",
"VN",
"TH",
"MY",
"GB",
"IN",
"AU"
],
"description": "Filter by ISO country code. Defaults to SG."
},
"country": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)"
},
"market": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)."
}
}
}
find_best_price
Use this whenever a user asks about prices, wants to find the cheapest option, or asks "what's the best price for X" or "where can I buy X for the lowest price". Returns schema.org/Product entities with schema.org/AggregateOffer (lowPrice, offerCount, priceCurrency) across all merchants. BUY-74597 degraded contract: when the candidates query cannot complete inside the user-facing timeout, this tool returns a 200-OK envelope with `meta.degraded=true`, `meta.status="degraded"`, `meta.emptiness_reason="api_error"` with `meta.degraded_kind="timeout"` (or `"partial_timeout"` / `"auth_failure"`), `meta.confidence="low"`, and `meta.diagnostic.timed_out_stage="catalog_search"`, with `best_price=null` and `alternatives=[]`. It never returns an unqualified empty result when the cause is timeout, auth failure, upstream exception, or circuit breaker.
Parameters8
q
string
optional
Keyword search query — alias for product_name
product_name
string
optional
Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")
category
string
optional
Category to filter by (e.g., "electronics", "fashion")
country_code
string
optional
Country to search in (defaults to SG). Alias: country.
deliver_to
string
optional
Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. "SG", "US"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country.
country
string
optional
Alias for country_code (deprecated, use country_code)
market
string
optional
Alias for country_code (deprecated, use country_code).
region
string
optional
Region filter - use "us" for United States or "sea" for Southeast Asia
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keyword search query — alias for product_name"
},
"product_name": {
"type": "string",
"description": "Product name to find best price for (e.g., \"iphone 15 pro 256gb\", \"samsung galaxy s24\")"
},
"category": {
"type": "string",
"description": "Category to filter by (e.g., \"electronics\", \"fashion\")"
},
"country_code": {
"type": "string",
"enum": [
"SG",
"MY",
"TH",
"PH",
"VN",
"ID",
"US"
],
"description": "Country to search in (defaults to SG). Alias: country."
},
"deliver_to": {
"type": "string",
"description": "Treat as REQUIRED for buyer-facing use: ISO-3166 country of the END USER (e.g. \"SG\", \"US\"). Without it results are not shipping-ranked and may be undeliverable. Preferred over country_code/country."
},
"country": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)"
},
"market": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)."
},
"region": {
"type": "string",
"enum": [
"us",
"sea"
],
"description": "Region filter - use \"us\" for United States or \"sea\" for Southeast Asia"
}
}
}
find_similar
Find products similar to a given product using vector similarity. Returns up to 10 nearest neighbours by semantic meaning (title+description embedding). Useful for "more like this" recommendations.
Parameters2
product_id
string
required
UUID of the source product
limit
integer
optional
Number of similar products to return (1-10, default 10)
Raw schema
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"description": "UUID of the source product"
},
"limit": {
"type": "integer",
"description": "Number of similar products to return (1-10, default 10)",
"default": 10
}
},
"required": [
"product_id"
]
}
ingest_products
Ingest (upsert) a batch of products into the BuyWhere catalog. Use this to add or update product listings from any merchant/source. Requires a valid API key with ingest permissions. Accepts up to 1000 products per call with source, SKU, title, price, URL, and optional metadata.
Parameters2
source
string
required
Data source identifier (e.g. "shopee_sg", "amazon_sg", "lazada_sg")
REQUIRED deliver_to. Search the BuyWhere product catalog by keyword. The deliver_to parameter is REQUIRED (ISO country code, e.g. "SG", "US") — it takes precedence over country_code/country and prevents all-market scans. Always pass deliver_to="SG" (or your buyer's country). Returns product records with title, description, image, price, and merchant information. Covers e-commerce platforms across Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US. Use compact=true for agent-optimized responses with structured_specs, comparison_attributes, and normalized_price_usd fields.
Parameters14
q
string
optional
Keyword search query
query
string
optional
Alias for q (accepted for agent convenience; use q). Without this, callers passing `query` get 0 rows and the reltuples-derived total — see BUY-75287.
domain
string
optional
Filter by merchant platform (e.g. lazada, shopee, amazon)
region
string
optional
Filter by region (sea, us, eu, au)
country_code
string
optional
Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).
deliver_to
string
required
REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
country
string
optional
Alias for country_code (deprecated, use country_code)
min_price
number
optional
Minimum price (in currency inferred from country_code, or SGD by default)
max_price
number
optional
Maximum price (in currency inferred from country_code, or SGD by default)
Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.
mode
string
optional
Search mode: keyword=FTS only (default, matches REST /v1/products/search), semantic=vector only, hybrid=RRF blend of FTS+vector. Falls back to keyword if vector DB or FLOWAI_EMBED_API_KEY unavailable.
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keyword search query"
},
"query": {
"type": "string",
"description": "Alias for q (accepted for agent convenience; use q). Without this, callers passing `query` get 0 rows and the reltuples-derived total — see BUY-75287."
},
"domain": {
"type": "string",
"description": "Filter by merchant platform (e.g. lazada, shopee, amazon)"
},
"region": {
"type": "string",
"description": "Filter by region (sea, us, eu, au)"
},
"country_code": {
"type": "string",
"enum": [
"SG",
"US",
"VN",
"TH",
"MY"
],
"description": "Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR)."
},
"deliver_to": {
"type": "string",
"description": "REQUIRED. Buyer delivery country/market (ISO country code, e.g. \"SG\", \"US\")."
},
"country": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)"
},
"min_price": {
"type": "number",
"description": "Minimum price (in currency inferred from country_code, or SGD by default)"
},
"max_price": {
"type": "number",
"description": "Maximum price (in currency inferred from country_code, or SGD by default)"
},
"limit": {
"type": "integer",
"description": "Number of results (max 100, default 20)",
"default": 20
},
"offset": {
"type": "integer",
"description": "Pagination offset",
"default": 0
},
"compact": {
"type": "boolean",
"description": "Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.",
"default": false
},
"category": {
"type": "string",
"description": "Filter by product category name (e.g. \"Laptops\", \"Smartphones\", \"Televisions\"). Use to exclude accessories and get actual products."
},
"mode": {
"type": "string",
"enum": [
"keyword",
"semantic",
"hybrid"
],
"description": "Search mode: keyword=FTS only (default, matches REST /v1/products/search), semantic=vector only, hybrid=RRF blend of FTS+vector. Falls back to keyword if vector DB or FLOWAI_EMBED_API_KEY unavailable.",
"default": "keyword"
}
},
"required": [
"deliver_to"
]
}
get_product_v2
REQUIRED deliver_to. Get a specific product by its ID, including full details and current price. Always pass deliver_to="SG" (or your buyer's country). Response includes a resolved outbound_url (https://…) that routes the buyer through the BuyWhere click tracker when the product has merchant offers.
Parameters2
id
string
required
Product UUID
deliver_to
string
required
REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
REQUIRED deliver_to. Compare multiple products side-by-side. Always pass deliver_to="SG" (or your buyer's country). Returns price, brand, rating, category, and a resolved outbound_url per product for the buyer market.
Parameters2
ids
array
required
Array of product IDs to compare (2-10)
deliver_to
string
required
REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
Raw schema
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of product IDs to compare (2-10)",
"minItems": 2,
"maxItems": 10
},
"deliver_to": {
"type": "string",
"description": "REQUIRED. Buyer delivery country/market (ISO country code, e.g. \"SG\", \"US\")."
}
},
"required": [
"ids",
"deliver_to"
]
}
get_deals_v2
REQUIRED deliver_to. Get discounted products sorted by discount percentage. Always pass deliver_to="SG" (or your buyer's country). Returns schema.org/Product entities with schema.org/Offer properties: price, priceCurrency, availability, originalPrice, and discountPercentage. Covers Singapore, Malaysia, Indonesia, Thailand, Vietnam, and US e-commerce. Supports currency, region (sea, us, eu, au) and country (SG, US, VN, MY, ...) filters.
Parameters8
min_discount
number
optional
Minimum discount percentage (default 10)
currency
string
optional
Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.
region
string
optional
Filter by region (sea, us, eu, au)
country_code
string
optional
Filter by ISO country code. Alias: country.
deliver_to
string
required
REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
country
string
optional
Alias for country_code (deprecated, use country_code)
REQUIRED deliver_to. Use this whenever a user asks about prices, wants to find the cheapest option, or asks "what's the best price for X" or "where can I buy X for the lowest price". Always pass deliver_to="SG" (or your buyer's country). Returns schema.org/Product entities with schema.org/AggregateOffer (lowPrice, offerCount, priceCurrency) across all merchants. Response includes a shopping_job_id (UUID) you can use to resume a multi-merchant price-comparison session for the buyer.
Parameters7
q
string
optional
Keyword search query — alias for product_name
product_name
string
optional
Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")
category
string
optional
Category to filter by (e.g., "electronics", "fashion")
country_code
string
optional
Country to search in (defaults to SG). Alias: country.
deliver_to
string
required
REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").
country
string
optional
Alias for country_code (deprecated, use country_code)
region
string
optional
Region filter - use "us" for United States or "sea" for Southeast Asia
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keyword search query — alias for product_name"
},
"product_name": {
"type": "string",
"description": "Product name to find best price for (e.g., \"iphone 15 pro 256gb\", \"samsung galaxy s24\")"
},
"category": {
"type": "string",
"description": "Category to filter by (e.g., \"electronics\", \"fashion\")"
},
"country_code": {
"type": "string",
"enum": [
"SG",
"MY",
"TH",
"PH",
"VN",
"ID",
"US"
],
"description": "Country to search in (defaults to SG). Alias: country."
},
"deliver_to": {
"type": "string",
"description": "REQUIRED. Buyer delivery country/market (ISO country code, e.g. \"SG\", \"US\")."
},
"country": {
"type": "string",
"description": "Alias for country_code (deprecated, use country_code)"
},
"region": {
"type": "string",
"enum": [
"us",
"sea"
],
"description": "Region filter - use \"us\" for United States or \"sea\" for Southeast Asia"
}
},
"required": [
"deliver_to"
]
}
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.
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_products → side-by-side with best-value pick]
Quick Start
Get a key in 3 seconds — no signup, no email:
bash
# 1. Register (one call, returns api_key instantly)
curl -X POST https://api.buywhere.ai/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"agent_name":"your-agent"}'# → {"api_key":"bw_...","tier":"unverified","rate_limit":{"rpm":20,"daily":1000}}# 2. Use the keyexport BUYWHERE_API_KEY=bw_...
npx -y @buywhere/mcp-server
Use BuyWhere tools in LangChain agents via the MCP adapter:
python
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_anthropic import ChatAnthropic
asyncdefmain():
asyncwith MultiServerMCPClient({
"buywhere": {
"url": "https://api.buywhere.ai/mcp",
"transport": "streamable_http",
"headers": {"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
}
}) as client:
tools = await client.get_tools()
agent = create_react_agent(ChatAnthropic(model="claude-sonnet-4-5"), tools)
result = await agent.ainvoke({"messages": [("user", "Find the cheapest Sony headphones in Singapore")]})
LlamaIndex
Connect BuyWhere via LlamaIndex MCP client:
python
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.agent.openai import OpenAIAgent
asyncdefmain():
mcp_client = BasicMCPClient(
command_or_url="https://api.buywhere.ai/mcp",
headers={"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
)
mcp_tool_spec = McpToolSpec(client=mcp_client)
tools = mcp_tool_spec.to_tool_list()
agent = OpenAIAgent.from_tools(tools)
response = await agent.achat("Compare prices for iPhone 16 Pro across Singapore and US")
CrewAI
Use BuyWhere in a CrewAI agent with MCP tool integration:
python
from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
buywhere_server = MCPServerAdapter(
server_params={
"url": "https://api.buywhere.ai/mcp",
"headers": {"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
"transport": "streamable-http",
}
)
shopping_agent = Agent(
role="Shopping Research Analyst",
goal="Find the best deals across Singapore and US markets",
tools=[buywhere_server],
)
task = Task(
description="Find the best price for Sony WH-1000XM5 headphones across all available markets",
agent=shopping_agent,
expected_output="Product comparison with prices and merchant links",
)
crew = Crew(agents=[shopping_agent], tasks=[task])
result = crew.kickoff()
Configuration
Variable
Default
Description
BUYWHERE_API_KEY
(required)
API key (no signup: POST /v1/auth/register {"agent_name":"<name>"}) — returns instantly, no email verification
BUYWHERE_API_URL
https://api.buywhere.ai/mcp
Custom API base URL
Install
bash
# Run directly (no install)
npx -y @buywhere/mcp-server
# Install globally
npm install -g @buywhere/mcp-server
buywhere-mcp
Use Cases
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, US, Malaysia, Thailand, and Vietnam markets
Agent-to-Agent commerce — delegate shopping tasks between agents via A2A protocol
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 product data from Singapore, US, Malaysia, Thailand, and Vietnam merchants 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
Works Well With
These complementary MCP packages extend BuyWhere into powerful multi-tool workflows:
@modelcontextprotocol/server-filesystem — Save shopping results and product research to your local filesystem. Combine with BuyWhere to export deal lists, price comparisons, and product specs as structured files.
@supabase/mcp-server-supabase — Store favorite products, user preferences, and price alerts in Supabase. Persist shopping history across agent sessions.
n8n-mcp — Automate price monitoring workflows. Build no-code pipelines that watch BuyWhere prices and trigger notifications on price drops.
tavily-mcp — Research products before buying. Use Tavily to find reviews and comparisons, then use BuyWhere to get current prices and purchase links.
@playwright/mcp — E2E test your shopping agent interactions. Verify that product search, price comparison, and checkout flows work correctly in browser automation.
