search_productsLABSCO SUMMARY
Making deliver_to mandatory is the right call, even though it breaks lazy prompts.
A price is only useful if the thing ships to the person asking, and v2 refuses to answer without knowing where that is. That is stricter than v1 and it will fail calls that forget the parameter — deliberately, because the alternative is a confident recommendation for a product the buyer cannot get. The registration path is the other notable choice: one POST returns a working key, so an agent can bootstrap itself without a human at a signup form.
What it is
A product catalogue and price-comparison service for AI agents. It searches products across merchants, compares listings, and returns the cheapest shippable option for a given country.
What you get
search_productssearches the catalogue by keyword, category, price and region;get_productreturns full details by IDcompare_pricesputs 2-5 products side by side;get_pricereturns current prices across merchants for one productget_catalogreturns the category taxonomy;get_affiliate_linkreturns a click-tracked URL- The v2 surface takes an end-user country code so results are ranked for what actually ships there:
search_products_v2,get_product_v2,compare_products_v2,find_best_price_v2andget_deals_v2 get_deals_v2returns products with price drops of 20% or more, filtered to what is shippable in that marketcompare_products_v2widens the comparison to 10 products- Agent-to-Agent protocol is supported alongside MCP
Requirements
The npm package @buywhere/mcp-server, version 1.1.0, run with npx, or the hosted endpoint https://api.buywhere.ai/mcp over streamable HTTP. BUYWHERE_API_KEY is required and can be minted without an email: POST to https://api.buywhere.ai/v1/auth/register with an agent name and the key comes back immediately. BUYWHERE_API_URL overrides the base URL. Every v2 search, price and deals call must pass deliver_to as an ISO 3166-1 alpha-2 country code, or it returns error -32602.
Setup effort
One command plus a key — npx -y @buywhere/mcp-server, then supply credentials
USE CASES
01
Finding something that actually ships to you
Search with a destination country so the results are filtered to shippable listings.
02
Deciding between three options
Put the candidates side by side and get a best-value pick rather than three separate lookups.
03
Answering "where is this cheapest"
Return the single cheapest shippable listing for a query in one call.
04
Watching for real discounts
Pull products whose price dropped at least 20%, scoped to a market.
11 tools
Listed in project docs. Your client may show a different list.
get_productcompare_pricesget_priceget_affiliate_linkget_catalogsearch_products_v2get_product_v2compare_products_v2find_best_price_v2get_deals_v2BEFORE YOU INSTALL
What to know first
Tools you get
11 tools named in the project's documentation.
Requires
- npx on PATH
- BUYWHERE_API_KEY — in the env block for the npx server, or sent as an Authorization: Bearer header to the hosted endpoint https://api.buywhere.ai/mcp
Where it runs
All 4 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y @buywhere/mcp-serverHosted endpoint
ENDPOINT URL
https://api.buywhere.ai/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Desktop, Cursor, Cline, Windsurf
JSON
{
"mcpServers": {
"buywhere": {
"command": "npx",
"args": [
"-y",
"@buywhere/mcp-server"
],
"env": {
"BUYWHERE_API_KEY": "<YOUR_BUYWHERE_API_KEY>"
}
}
}
}
