Buywhere Mcp

buywhere/buywhere-mcp

Connects your AI agent to 50M+ products across Singapore, Southeast Asia, and US markets through six core tools: search_products for catalog queries with filters on price and category, get_product for full specs and pricing, compare_prices for side-by-side analysis, get_price for real-time merchant data, get_affiliate_link for tracked URLs, and get_catalog for browsing taxonomy. Built on the BuyWhere API with multi-currency support and coverage of Lazada, Shopee, Amazon, and regional retailers. Reach for this when you're building shopping assistants, price comparison agents, or deal finders that need structured product data instead of web scraping. Supports both stdio and streamable HTTP transports. Requires a free API key from buywhere.ai.

GitHub stars: 15
tools: 13
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Aug 29, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.buywhere.ai/mcp --name buywhere-mcp --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http buywhere-mcp https://api.buywhere.ai/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 13 tools

Verified live against the running server on Nov 6, 2026.

search_productsSearch 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...15 params

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...

Parameters* required

categorystring

Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.

compactboolean

Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.default: false

countrystring

Alias for country_code (deprecated, use country_code)

country_codestring

Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).one of SG · US · VN · TH · MY

deliver_tostring

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.

domainstring

Filter by merchant platform (e.g. lazada, shopee, amazon)

limitinteger

Number of results (max 100, default 20)default: 20

marketstring

Alias for country_code (deprecated, use country_code).

max_pricenumber

Maximum price (in currency inferred from country_code, or SGD by default)

min_pricenumber

Minimum price (in currency inferred from country_code, or SGD by default)

modestring

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.one of keyword · semantic · hybriddefault: keyword

offsetinteger

Pagination offsetdefault: 0

qstring

Keyword search query

querystring

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.

regionstring

Filter by region (sea, us, eu, au)

get_productGet a specific product by its ID, including full details and current price.1 params

Get a specific product by its ID, including full details and current price.

Parameters* required

id*string

Product UUID

compare_productsCompare multiple products side-by-side. Returns price, brand, rating, and category for each.1 params

Compare multiple products side-by-side. Returns price, brand, rating, and category for each.

Parameters* required

ids*array

Array of product IDs to compare (2-10)

get_dealsGet 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....10 params

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....

Parameters* required

categorystring

Filter deals by product category (e.g. "Electronics", "Beauty", "home_and_kitchen"). Handler matches against category text and category_path[1]; slug-style input is accepted. BUY-76853/BUY-83657.

countrystring

Alias for country_code (deprecated, use country_code)

country_codestring

Filter by ISO country code. Alias: country.one of SG · US · VN · TH · MY

currencystring

Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.default: SGD

deliver_tostring

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.

limitinteger

Number of results (max 100, default 20)default: 20

marketstring

Alias for country_code (deprecated, use country_code).

min_discountnumber

Minimum discount percentage (default 10)default: 10

offsetinteger

Pagination offsetdefault: 0

regionstring

Filter by region (sea, us, eu, au)

list_categoriesList top-level product categories available in the BuyWhere catalog.4 params

List top-level product categories available in the BuyWhere catalog.

Parameters* required

countrystring

Alias for country_code (deprecated, use country_code)

country_codestring

Filter by ISO country code. Defaults to SG.one of SG · US · VN · TH · MY · GB

marketstring

Alias for country_code (deprecated, use country_code).

regionstring

Region alias mapped to ISO country code.one of us · sg · my · gb · in · au

find_best_priceUse 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...8 params

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...

Parameters* required

categorystring

Category to filter by (e.g., "electronics", "fashion")

countrystring

Alias for country_code (deprecated, use country_code)

country_codestring

Country to search in (defaults to SG). Alias: country.one of SG · MY · TH · PH · VN · ID

deliver_tostring

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.

marketstring

Alias for country_code (deprecated, use country_code).

product_namestring

Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")

qstring

Keyword search query — alias for product_name

regionstring

Region filter - use "us" for United States or "sea" for Southeast Asiaone of us · sea

find_similarFind 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.2 params

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.

Parameters* required

limitinteger

Number of similar products to return (1-10, default 10)default: 10

product_id*string

UUID of the source product

ingest_productsIngest (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.2 params

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.

Parameters* required

products*array

Array of product objects to ingest (max 1000)

source*string

Data source identifier (e.g. "shopee_sg", "amazon_sg", "lazada_sg")

search_products_v2REQUIRED 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). R...14 params

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). R...

Parameters* required

categorystring

Filter by product category name (e.g. "Laptops", "Smartphones", "Televisions"). Use to exclude accessories and get actual products.

compactboolean

Return agent-optimized compact shape: structured_specs, comparison_attributes, normalized_price_usd. Reduces response size ~40%. Recommended for agent tool-use.default: false

countrystring

Alias for country_code (deprecated, use country_code)

country_codestring

Filter by ISO country code. Also infers default currency for price filters (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR).one of SG · US · VN · TH · MY

deliver_to*string

REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").

domainstring

Filter by merchant platform (e.g. lazada, shopee, amazon)

limitinteger

Number of results (max 100, default 20)default: 20

max_pricenumber

Maximum price (in currency inferred from country_code, or SGD by default)

min_pricenumber

Minimum price (in currency inferred from country_code, or SGD by default)

modestring

offsetinteger

Pagination offsetdefault: 0

qstring

Keyword search query

querystring

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.

regionstring

Filter by region (sea, us, eu, au)

get_product_v2REQUIRED 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 produ...2 params

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 produ...

Parameters* required

deliver_to*string

REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").

id*string

Product UUID

compare_products_v2REQUIRED 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.2 params

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.

Parameters* required

deliver_to*string

REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").

ids*array

Array of product IDs to compare (2-10)

get_deals_v2REQUIRED 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. C...9 params

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. C...

Parameters* required

categorystring

Filter deals by product category (e.g. "Electronics", "Beauty", "home_and_kitchen"). Handler matches against category text and category_path[1]; slug-style input is accepted. BUY-76853/BUY-83657.

countrystring

Alias for country_code (deprecated, use country_code)

country_codestring

Filter by ISO country code. Alias: country.one of SG · US · VN · TH · MY

currencystring

Filter by currency code (SGD, USD, MYR, VND, THB). Defaults to SGD.default: SGD

deliver_to*string

REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").

limitinteger

Number of results (max 100, default 20)default: 20

min_discountnumber

Minimum discount percentage (default 10)default: 10

offsetinteger

Pagination offsetdefault: 0

regionstring

Filter by region (sea, us, eu, au)

find_best_price_v2REQUIRED 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 wit...7 params

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 wit...

Parameters* required

categorystring

Category to filter by (e.g., "electronics", "fashion")

countrystring

Alias for country_code (deprecated, use country_code)

country_codestring

Country to search in (defaults to SG). Alias: country.one of SG · MY · TH · PH · VN · ID

deliver_to*string

REQUIRED. Buyer delivery country/market (ISO country code, e.g. "SG", "US").

product_namestring

Product name to find best price for (e.g., "iphone 15 pro 256gb", "samsung galaxy s24")

qstring

Keyword search query — alias for product_name

regionstring

Region filter - use "us" for United States or "sea" for Southeast Asiaone of us · sea

Configuration

BUYWHERE_API_KEY*secret

API key from https://api.buywhere.ai/v1/auth/register

Readme

BuyWhere MCP Server — Product Search & Price Comparison for AI Agents

AI agents use BuyWhere to search products, compare prices, and discover deals across Singapore and US merchants in real time.

Install in 30 Seconds

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

Use with Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev, and any MCP-compatible client.

npm: https://www.npmjs.com/package/@buywhere/mcp-server
GitHub: https://github.com/BuyWhere/buywhere-mcp
MCP Registry: https://registry.modelcontextprotocol.io/?q=io.github.BuyWhere%2Fbuywhere-mcp

_{Or get one in 3 seconds, no signup, no email: POST /v1/auth/register · Legacy form: buywhere.ai/api-keys}

View the full README on GitHub

Details

Repository: github.com/buywhere/buywhere-mcp
Website: buywhere.ai
Category: AI & LLM Tools
Package: @buywhere/mcp-server
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related AI & LLM Tools MCP servers

View all

Northwestern University Libraries Digital Collections APInulib/dc-api-v2Agent integration with the Northwestern University Libraries Digital Collections API0stars

Longhandwynelson94/longhandLocal memory for Claude Code: 13 MCP tools for semantic recall, file replay, and git history.14stars

HeyLead — AI agent for LinkedIn outreachd4umak/linkedin-outreach-mcpAI agent for LinkedIn outreach: finds the right people, writes in your voice, follows up, replies.13stars

Starlogstarloghq/indexVet a package (CVEs, license, maintenance) before your AI agent uses it, plus capability discovery.0stars

Reliquary-TCthe-40-thieves/reliquary-tcGoverned Obsidian vault access: hybrid retrieval, Markdown-native memory, HITL confirmations.13stars

Mathlasarcherkattri/mathlasAirtight math for AI agents: 3.68M-doc theorem search + numeric/Lean verification. No LLM, no key.12stars