MCP tools reference

lookup_product

Resolve any identifier into a product summary with per-retailer Bucket-1 facts and computed marketplace fees.

Inputs:
  identifier: string  # required. UPC, EAN, ISBN, GTIN, ASIN, or item_id
  identifier_type?: "UPC" | "EAN" | "ISBN" | "GTIN" | "ASIN" | "item_id"
  include_cross_retailer?: boolean   # +2 tokens — cached cells for all retailers we have for this UPC (read-only)
  include_seller_context?: boolean   # +3 tokens — live restriction + WFS state
  retailer?: string                  # anchor response to a specific retailer
  force_refresh?: boolean            # only valid with retailer — bypass cache, force fresh scrape

Returns:
  {
    item_id, title, brand, image, current_price,
    buybox_price, offers_count, total_offers,
    queried_identifier,
    retailer_links?: [...],
    cross_retailer?: {                # only when include_cross_retailer=true
      walmart: {
        retailer, status, price, url, in_stock, unavailable,
        sold_tag, estimated_sales, is_best_seller, pack_count, hazmat,
        seller_context: {
          referral_fee_usd,   # FREE in base call
          wfs_fee_usd,        # FREE in base call
          restricted?,        # only with include_seller_context
          wfs_eligibility?    # only with include_seller_context
        }
      },
      amazon: { ... },
      ebay: { ... }, ...
    },
    seller_context?: {        # top-level, only with include_seller_context
      restricted: { any, retailers: [...], primary_reason }
    }
  }

Cost: 1-11 tokens depending on flags (1 base + optional +5 offers/reviews + optional +2 cross-retailer + optional +3 seller-context). The cross_retailer block is read-only over our cache — to force a fresh scrape of a specific retailer, call with retailer=<slug> and force_refresh=true.

get_offers

Current Walmart marketplace sellers for an item_id.

Inputs:
  item_id: string

Returns:
  {
    item_id,
    offers: [{ seller_id, seller_name, price, is_buy_box, in_stock }],
    buy_box_seller_id
  }

Cost: 6 tokens (1 base lookup + 5 offers/reviews bundle).

What ships next

• compare_retailers (June 2026) — single-call cross-retailer comparison without chaining
• watch_product (July 2026) — server-side price-drop alerts via webhook
• bulk_lookup (August 2026) — batched UPC lookup at discounted token rate