Name: RetailerAPI Product Data
Author: retailerapi

LABSCO SUMMARY

The lookup half is deliberately identifier-agnostic; the seller half is Walmart and nothing else.

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.

What it is

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.

What you get

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.

Requirements

A RETAILERAPI_KEY. lookup_product needs an identifier or a product page URL; get_offers needs a Walmart item_id.

Setup effort

One command plus a key — RETAILERAPI_KEY=<YOUR_RETAILERAPI_KEY> npx @retailerapi/mcp

See installation options

USE CASES

01

Turning a scanned barcode into a product record

Pass whichever identifier you hold — a UPC off a label, an ASIN from a listing, or the product page URL itself — and get one record back.

lookup_product

02

Checking who is selling a Walmart item now

Resolve the listing to its Walmart item_id, then read the live seller list with price, stock, fulfillment and return terms per offer.

lookup_productget_offers

2 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`get_offers`

List the current sellers on a Walmart product. Returns the full live seller list — each offer with seller_id (numeric, linkable seller-page id), seller_id_hex, seller_name, price, in_stock, wfs, pro_seller, shipping_cost, delivery_date, seller_type (1p/3p), offer_id, max_delivery_date, max_order_quantity, fulfillment_type, returnable, return_window_days, free_returns, condition, quantity_available, and an is_buy_box flag — plus total_offers (the number of competing sellers, equal to the list length). Set include_offers_history=true (+5 tokens) to also return offers_history — the Keepa-style price/seller archive for the item (each entry stamped with observed_at + was_price). Use to compare seller prices, gauge competition, find the buy-box holder, or chart historical pricing.

BEFORE YOU INSTALL

What to know first

Tools you get

2 tools when we connected. Both tools only read. include_cross_retailer costs 2 extra tokens and include_seller_context 3 against your quota.

Requires

npx on PATH
RETAILERAPI_KEY in your environment

CONTEXT COST

Light Standing cost

Rated by the size of the 2 tool definitions that ride along on every turn, not by how many there are

INSTALLATION

Connect your client

Server setup

Any MCP client — stdio

TERMINAL

RETAILERAPI_KEY=<YOUR_RETAILERAPI_KEY> npx @retailerapi/mcp

MCP Clients

Claude Desktop, Cursor

JSON

{
  "mcpServers": {
    "retailerapi": {
      "command": "npx",
      "args": [
        "-y",
        "@retailerapi/mcp"
      ],
      "env": {
        "RETAILERAPI_KEY": "<YOUR_RETAILERAPI_KEY>"
      }
    }
  }
}

Claude Code

CLAUDE CODE · TERMINAL

claude mcp add --env RETAILERAPI_KEY=<YOUR_RETAILERAPI_KEY> --transport stdio retailerapi \
  -- npx -y @retailerapi/mcp

RetailerAPI Product Data