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.
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.
- `search_products` searches the catalogue by keyword, category, price and region; `get_product` returns full details by ID
- `compare_prices` puts 2-5 products side by side; `get_price` returns current prices across merchants for one product
- `get_catalog` returns the category taxonomy; `get_affiliate_link` returns 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_v2` and `get_deals_v2`
- `get_deals_v2` returns products with price drops of 20% or more, filtered to what is shippable in that market
- `compare_products_v2` widens the comparison to 10 products
- Agent-to-Agent protocol is supported alongside MCP
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.
One command plus a key — npx -y @buywhere/mcp-server, then supply credentials