lookup_product is the interesting side — one call takes a barcode, an ASIN, a Walmart item_id or a raw product page URL, with the 7 vetted retailers parsed directly, Shopify-hosted stores read through /products/<handle>.json and anything else attempted via Product JSON-LD, so coverage on an unknown retailer degrades rather than fails outright. get_offers does not generalise that way: it reports a Walmart product's live sellers field by field down to return_window_days and max_order_quantity, and no equivalent exists for the retailers lookup_product can otherwise read.
A product-data lookup with 2 tools: lookup_product resolves a barcode, a retailer item id or a product page URL to one record, and get_offers returns the live seller list on a Walmart product.
- lookup_product accepts a UPC, EAN, ISBN, GTIN, ASIN or Walmart item_id, so whichever identifier you happen to be holding is the one you pass; identifier_type and retailer disambiguate when the identifier alone is not enough.
- A raw product page URL works as an identifier too: on the 7 vetted retailers with dedicated parsers — Amazon /dp/, Walmart /ip/, Target /p/, Home Depot /p/, Lowe's /pd/, Best Buy /product/ and eBay /itm/ — on every Shopify-hosted store globally through the public /products/<handle>.json endpoint, and on any other retailer that ships Product JSON-LD.
- include_cross_retailer, include_seller_context and force_refresh are the switches on that call.
- get_offers returns a Walmart product's full live seller list by item_id, each offer carrying seller_id, seller_id_hex, seller_name, price, in_stock, wfs, pro_seller, shipping_cost, delivery_date, seller_type as 1p or 3p, offer_id, max_delivery_date, max_order_quantity, fulfillment_type, returnable, return_window_days, free_returns, condition and quantity_available, with include_offers_history as its second parameter.
A RETAILERAPI_KEY. lookup_product needs an identifier or a product page URL; get_offers needs a Walmart item_id.
One command plus a key — RETAILERAPI_KEY=rk_live_your_key_here npx @retailerapi/mcp, then supply credentials