Buywhere Mcp

io.github.richmondteo-codePublished by GitHub account richmondteo-codev1.0.0Updated Oct 24, 2026

Agent-native product catalog API for Southeast Asia — search, compare prices, find deals.

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

A local MCP server that lets an assistant search the BuyWhere Southeast Asian product catalog, compare prices and get affiliate links.

What you can do
Search the product catalog by keyword or natural language, with optional country, category and result limit filters, and list available categories and subcategories for Singapore, Malaysia and Indonesia. Retrieve full details for a single product by its BuyWhere ID. Compare current prices for one product across merchants, ranked by total price including shipping, with best-price and best-value picks. Compare two to five products side by side with price range, differences and pros and cons. Generate click-tracked affiliate links for products.
When to use it
Useful when an assistant needs to help with shopping research in Southeast Asia: finding products, checking which merchant is cheapest, or comparing a shortlist before a purchase decision.
Requirements
Runs as a local Python process started by the MCP client, with the server script available locally. A BuyWhere API key is required in the BUYWHERE_API_KEY environment variable, obtained by signing up on the BuyWhere developer site. Network access to the BuyWhere API is needed; the base URL can be overridden with BUYWHERE_API_URL.
Before you install
The API key is a credential placed in the client configuration file, so keep that file private. Affiliate links are click-tracked and log a referral, so tell users when sharing them. Product data and queries are sent to the BuyWhere API. The server only reads catalog data and does not place orders or make payments.

Installation

In SourceWeft

  1. Open Buywhere Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

buywhere-mcp

MCP server for the BuyWhere product catalog. Lets Claude Desktop, Cursor, Windsurf, and other MCP-compatible agents search and retrieve products without writing any HTTP code.

Setup

1. Get your API key

Sign up at buywhere.ai/developers and copy your API key.

2. Configure your client

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

json
{  "mcpServers": {    "buywhere": {      "command": "python",      "args": ["mcp_server.py"],      "env": {        "BUYWHERE_API_KEY": "your_api_key_here"      }    }  }}
Cursor

Open Settings → MCP and add a new server, or edit ~/.cursor/mcp.json:

json
{  "mcpServers": {    "buywhere": {      "command": "python",      "args": ["mcp_server.py"],      "env": {        "BUYWHERE_API_KEY": "your_api_key_here"      }    }  }}
Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "buywhere": {      "command": "python",      "args": ["mcp_server.py"],      "env": {        "BUYWHERE_API_KEY": "your_api_key_here"      }    }  }}

3. Ask your agent to search products

Restart your client, then try:

"Search BuyWhere for wireless earbuds under $50 in Singapore"

"Use BuyWhere to compare the cheapest iPhone 15 cases"

"Get me the affiliate link for product ID abc123 from BuyWhere"

Tools

search_products

Search the BuyWhere catalog using keywords or natural language.

ParameterTypeRequiredDescription
querystringyesKeyword or natural-language query
countrystringnoCountry code hint (sg, my, id)
categorystringnoCategory slug (e.g. electronics/smartphones)
limitintegernoMax results, 1–50 (default 10)

get_product

Fetch full details for a single product.

ParameterTypeRequiredDescription
product_idstringyesBuyWhere product ID

get_price

Compare current prices for a product across all available merchants. Returns listings ranked by total price (including shipping), plus best-price and best-value recommendations.

ParameterTypeRequiredDescription
product_idstringyesBuyWhere product ID

compare_prices

Side-by-side comparison of 2–5 products. Returns structured differentiators, price range, pros/cons, and a best-value recommendation — purpose-built for AI agent decision-making.

ParameterTypeRequiredDescription
product_idsstring[]yesArray of 2–5 BuyWhere product IDs

get_affiliate_link

Get the click-tracked BuyWhere affiliate link for a product. Always use this instead of raw product URLs when sharing links with users — it logs the referral and redirects to the merchant page.

ParameterTypeRequiredDescription
product_idstringyesBuyWhere product ID

get_catalog

List available product categories. Use this to discover what categories exist before searching or filtering.

ParameterTypeRequiredDescription
parent_slugstringnoParent slug for subcategories (omit for top-level)

Resources

URIDescription
buywhere://catalog/sgAvailable categories in Singapore
buywhere://catalog/myAvailable categories in Malaysia
buywhere://catalog/idAvailable categories in Indonesia

Environment variables

VariableRequiredDescription
BUYWHERE_API_KEYyesYour BuyWhere API key
BUYWHERE_API_URLnoOverride API base URL (default: https://api.buywhere.ai)

Sample agent conversation

User: Find the cheapest mechanical keyboard on BuyWhere and compare the top 2
Claude: I'll search BuyWhere for mechanical keyboards and compare the top results.
[Calls search_products with query="mechanical keyboard", limit=5]
Found 12 products. Top results:1. Keychron K2 — SGD 89.00 (prod_abc123)2. Royal Kludge RK61 — SGD 65.00 (prod_def456)
[Calls compare_prices with product_ids=["prod_abc123", "prod_def456"]]
Comparison: Keychron K2 vs Royal Kludge RK61Price range: SGD 65 – SGD 89Key differences:  • Keychron K2: full-size TKL layout, Mac-optimised keycaps  • RK61: compact 60% layout, budget-friendlyBest value: Royal Kludge RK61 at SGD 65
[Calls get_affiliate_link with product_id="prod_def456"]
Here's your purchase link: https://api.buywhere.ai/r/prod_def456

Development

bash
npm installnpm run buildBUYWHERE_API_KEY=your_key python mcp_server.py

Source: README.md at commit e263ba0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.