lululemon MCP server for AI agents

Let Claude, ChatGPT or your own agent read lululemon: 7 typed functions through one MCP server. No lululemon API key needed.

Functions
7
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just lululemon

An MCP server for lululemon alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/lululemon
Every site

One MCP server for lululemon and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 7
  • getProductReads one product's full configurator the way its product page presents it.

    Arguments

    NameTypeRequired
    query{ productId: string; country?: "us" | "ca" } | LululemonRowYes
    interface LululemonRow {
      id: string;
      title: string;
      url: string;
    
      priceLow: number | null;
      priceHigh: number | null;
      colorCount: number | null;
      inStock: boolean | null;
      onSale: boolean | null;
      /** False only on the fallback path (the store's search did not answer). */
      priced: boolean;
      image: string | null;
      /** ISO 4217 for priceLow/priceHigh: "USD", or "CAD" on a Canadian search. */
      currency: string | null;
      category: string | null;
      colorFamilies: string[];
    }

    Returns LululemonProduct

    interface LululemonVariant {
      /** The identifier lululemon's own checkout uses, e.g. "us_117376359". */
      sku: string;
      /** Which option each dimension is set to, e.g. { size: "4" }. */
      options: Record<string, string>;
      /** The store's own availability flag for this exact SKU. */
      available: boolean;
      price: number | null;
      salePrice: number | null;
      /** Why this SKU's price is, or is not, a markdown. Derived from price and
       * salePrice, so it can never disagree with them. */
      sale: SaleEvidence;
    }
    
    interface SaleEvidence {
      /** True only with retailer evidence. NEVER from a low price or a title. */
      onSale: boolean;
      currentPrice: number | null;
      /** The list price, when the markdown is against one. */
      originalPrice: number | null;
      /** ISO 4217, e.g. "USD". */
      currency: string | null;
      promotionMessage: string | null;
      evidenceType: "compare_at_price" | "sale_price" | "retailer_sale_badge" | "published_promotion" | "none";
      /** The retailer text or field the classification rests on, verbatim. */
      evidenceText: string | null;
    }
    
    interface ProductImage {
      /** Absolute HTTPS url. */
      url: string;
      altText: string | null;
      /** The colourway's own colour, sound because lululemon publishes its image
       * list PER COLOURWAY, so every picture in it is that colour by construction. */
      color: string | null;
      colorId: string | null;
      /** Always [] here: this feed links a picture to a COLOUR, never to a size. */
      variantIds: string[];
    }
    
    /** The retailer's own labels, transcribed from what the store's product service
     * publishes. A field it does not publish is null or [], never guessed. Fabric,
     * fit, rise and the detail bullets come from getProductAttributes. */
    interface PublishedProductAttributes {
      audience: string | null;
      garmentType: "sports_bra" | "tank" | "crop_top" | "leggings" | "shorts" | "other" | null;
      categories: string[];
      collections: string[];
      fabrics: string[];
      materials: string[];
      color: string | null;
      colorFamily: string | null;
      pattern: string | null;
      styleTags: string[];
      neckline: string | null;
      strapWidth: string | null;
      backDesign: string | null;
      sleeveLength: string | null;
      rise: string | null;
      waistband: string | null;
      inseam: string | null;
      legShape: string | null;
      fit: string | null;
      coverage: string | null;
    }
    
    /** Shared colour and family, what makes two pieces PLAUSIBLY coordinate. None
     * of it establishes a set. */
    interface CoordinationMetadata {
      collectionNames: string[];
      fabricNames: string[];
      colorName: string | null;
      colorId: string | null;
      colorFamily: string | null;
      productFamily: string | null;
    }
    
    /** An EXPLICIT retailer-published relationship, the store's own "shop this
     * look" pairing for a colourway, resolved to the companion product it names. Not
     * the algorithmic "You may also like" rail, which is getSimilarProducts. */
    interface RetailerSetEvidence {
      evidenceType: "official_set" | "shop_the_set" | "complete_the_look" | "matching_piece";
      evidenceText: string | null;
      sourceUrl: string | null;
      setId: string | null;
      relatedProducts: Array<{ productId: string | null; handle: string | null; title: string | null; url: string | null }>;
    }
    
    interface LululemonOptionGroup {
    
      type: string;
      /** The site's own label for the picker, e.g. "Size". */
      label: string;
      options: { value: string; label: string }[];
    }
    
    interface LululemonColorway {
      /** lululemon's own colour code, e.g. "TRUE-NAVY". */
      colorId: string;
      color: string;
      colorFamily: string | null;
      price: number | null;
      /** Set only when this colourway is marked down. */
      salePrice: number | null;
      promoMessage: string | null;
      /** The product URL pinned to this colour, as the store publishes it. */
      url: string;
      swatchImage: string | null;
      images: string[];
      /** The SAME pictures as images, carrying this colourway's colour and colorId.
       * images stays a bare string[] for existing callers; this is the additive half. */
      imageAssets: ProductImage[];
      sale: SaleEvidence;
      coordination: CoordinationMetadata;
      /** ISO 4217 from the colourway url's own locale, or null for an unknown one. */
      currency: string | null;
      inStock: boolean;
      optionGroups: LululemonOptionGroup[];
    
      variants: LululemonVariant[];
    }
    
    interface LululemonSizeType {
      /** A sibling product that is the same style in another length. */
      productId: string;
      size: string;
      selected: boolean;
    }
    
    interface LululemonProduct {
      id: string;
      title: string;
      brand: string;
      /** The product page on the store it was read from, /en-ca/ for Canada. */
      url: string;
      /** Which storefront answered: "us" (the default) or "ca". */
      country: "us" | "ca";
      /** ISO 4217 for every price on this record: "USD", or "CAD" for Canada. */
      currency: string | null;
      /** The store's own audience attribute, e.g. "women". */
      gender: string | null;
      rating: number | null;
      reviewCount: number | null;
      inStock: boolean;
      priceLow: number | null;
      priceHigh: number | null;
      colorways: LululemonColorway[];
      /** Other LENGTHS of the same style (25", 28", 31"), each its own product id, * an inseam is a separate product on this site. Regional lengths the US store
       * does not sell are left out. */
      sizeTypes: LululemonSizeType[];
      attributes: PublishedProductAttributes;
      coordination: CoordinationMetadata;
      /** An explicit retailer-published pairing, shopThisLook, resolved to the
       * companion products it names. Empty when the colourway named none, or named
       * only ids the store no longer carries. */
      retailerSetEvidence: RetailerSetEvidence[];
      /** Non-empty only when resolving shopThisLook failed to answer, the
       * companion products could not be looked up this call. Empty otherwise. */
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/lululemon/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lululemon.getProduct({ productId: "prod2020012" });
  • getProductAttributesReads what lululemon publishes ABOUT a garment rather than what it costs: the category it is filed under, the collection description, the trademarked…

    Arguments

    NameTypeRequired
    query{ productId: string; country?: "us" | "ca" } | LululemonRowYes
    interface LululemonRow {
      id: string;
      title: string;
      url: string;
    
      priceLow: number | null;
      priceHigh: number | null;
      colorCount: number | null;
      inStock: boolean | null;
      onSale: boolean | null;
      /** False only on the fallback path (the store's search did not answer). */
      priced: boolean;
      image: string | null;
      /** ISO 4217 for priceLow/priceHigh: "USD", or "CAD" on a Canadian search. */
      currency: string | null;
      category: string | null;
      colorFamilies: string[];
    }

    Returns LululemonProductAttributes

    /** One published product-detail block from the page, verbatim. */
    interface LululemonFeature {
      heading: string;
      body: string;
    }
    
    interface LululemonProductAttributes {
      productId: string;
      url: string;
      title: string;
      /** Which storefront answered: "us" or "ca". */
      country: "us" | "ca";
      /** The site's own ProductGroup category, e.g. "Leggings". */
      category: string | null;
      description: string | null;
      /** Trademarked fabric names off the product-detail region, e.g. ["Nulu"]. */
      fabrics: string[];
      fit: string | null;
      /** "High-Rise" / "Mid-Rise" / "Low-Rise", as the title spells it. */
      rise: string | null;
      /** Every detail block, unmapped and in page order. */
      features: LululemonFeature[];
    
      ratingValue: number | null;
      reviewCount: number | null;
      /** What lululemon says the garment is FOR, in its own words, e.g.
       * ["Dance", "Pilates", "Yoga"]. Published, never inferred from the prose,
       * and empty when the store names none. OUTSIDE completeness on purpose. */
      activities: string[];
      /** Named collections, e.g. ["Align"]. */
      collections: string[];
      /** The single activity the store badges the product with, when it does. */
      designedFor: string | null;
      /** Per-FIELD origin for the eight facts above, keyed by the same names. THIS
       * is how a refused read is told apart from a garment with nothing published:
       * fabrics [] beside status "absent" is lululemon saying it names no fabric,
       * and fabrics [] beside status "unreachable" is the page refusing us. Ranking
       * that treats the two alike silently prefers whichever candidates loaded. */
      provenance: Record<string, FieldProvenance>;
      /** The roll-up. On a refused page ratio is 0 and unreachableFields names all
       * eight, the machine-readable form of the sentence in warnings. */
      completeness: Completeness;
      /** What could not be reached. Non-empty means the page refused. */
      warnings: string[];
    }
    
    /** Where one field's value came from, and the retailer text behind it. */
    interface FieldProvenance {
      /** "published", lululemon stated it. "absent", the page rendered and said
       * nothing about this field. "unreachable", the page refused, so UNKNOWN. */
      status: "published" | "absent" | "unreachable";
    
      source: string | null;
      /** The retailer's own words the value rests on, for a field derived from
       * prose. Null for a field the site published as a typed value. */
      evidence: string | null;
      /** On "unreachable" only: what was refused. */
      detail?: string;
    }
    
    interface Completeness {
      fields: number;
      published: number;
      absent: number;
      unreachable: number;
      /** published / fields, to 3dp. */
      ratio: number;
      /** The fields that are UNKNOWN rather than known-empty. */
      unreachableFields: string[];
      sourcesUsed: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/lululemon/getProductAttributes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lululemon.getProductAttributes({ productId: "prod2020012" });
  • getProductsReads the full configurator for MANY products in one call.

    Arguments

    NameTypeRequired
    query{ productIds: string[]; country?: "us" | "ca" }Yes

    Returns LululemonProductBatch

    interface LululemonVariant {
      /** The identifier lululemon's own checkout uses, e.g. "us_117376359". */
      sku: string;
      /** Which option each dimension is set to, e.g. { size: "4" }. */
      options: Record<string, string>;
      /** The store's own availability flag for this exact SKU. */
      available: boolean;
      price: number | null;
      salePrice: number | null;
      /** Why this SKU's price is, or is not, a markdown. Derived from price and
       * salePrice, so it can never disagree with them. */
      sale: SaleEvidence;
    }
    
    interface SaleEvidence {
      /** True only with retailer evidence. NEVER from a low price or a title. */
      onSale: boolean;
      currentPrice: number | null;
      /** The list price, when the markdown is against one. */
      originalPrice: number | null;
      /** ISO 4217, e.g. "USD". */
      currency: string | null;
      promotionMessage: string | null;
      evidenceType: "compare_at_price" | "sale_price" | "retailer_sale_badge" | "published_promotion" | "none";
      /** The retailer text or field the classification rests on, verbatim. */
      evidenceText: string | null;
    }
    
    interface ProductImage {
      /** Absolute HTTPS url. */
      url: string;
      altText: string | null;
      /** The colourway's own colour, sound because lululemon publishes its image
       * list PER COLOURWAY, so every picture in it is that colour by construction. */
      color: string | null;
      colorId: string | null;
      /** Always [] here: this feed links a picture to a COLOUR, never to a size. */
      variantIds: string[];
    }
    
    /** The retailer's own labels, transcribed from what the store's product service
     * publishes. A field it does not publish is null or [], never guessed. Fabric,
     * fit, rise and the detail bullets come from getProductAttributes. */
    interface PublishedProductAttributes {
      audience: string | null;
      garmentType: "sports_bra" | "tank" | "crop_top" | "leggings" | "shorts" | "other" | null;
      categories: string[];
      collections: string[];
      fabrics: string[];
      materials: string[];
      color: string | null;
      colorFamily: string | null;
      pattern: string | null;
      styleTags: string[];
      neckline: string | null;
      strapWidth: string | null;
      backDesign: string | null;
      sleeveLength: string | null;
      rise: string | null;
      waistband: string | null;
      inseam: string | null;
      legShape: string | null;
      fit: string | null;
      coverage: string | null;
    }
    
    /** Shared colour and family, what makes two pieces PLAUSIBLY coordinate. None
     * of it establishes a set. */
    interface CoordinationMetadata {
      collectionNames: string[];
      fabricNames: string[];
      colorName: string | null;
      colorId: string | null;
      colorFamily: string | null;
      productFamily: string | null;
    }
    
    /** An EXPLICIT retailer-published relationship, the store's own "shop this
     * look" pairing for a colourway, resolved to the companion product it names. Not
     * the algorithmic "You may also like" rail, which is getSimilarProducts. */
    interface RetailerSetEvidence {
      evidenceType: "official_set" | "shop_the_set" | "complete_the_look" | "matching_piece";
      evidenceText: string | null;
      sourceUrl: string | null;
      setId: string | null;
      relatedProducts: Array<{ productId: string | null; handle: string | null; title: string | null; url: string | null }>;
    }
    
    interface LululemonOptionGroup {
    
      type: string;
      /** The site's own label for the picker, e.g. "Size". */
      label: string;
      options: { value: string; label: string }[];
    }
    
    interface LululemonColorway {
      /** lululemon's own colour code, e.g. "TRUE-NAVY". */
      colorId: string;
      color: string;
      colorFamily: string | null;
      price: number | null;
      /** Set only when this colourway is marked down. */
      salePrice: number | null;
      promoMessage: string | null;
      /** The product URL pinned to this colour, as the store publishes it. */
      url: string;
      swatchImage: string | null;
      images: string[];
      /** The SAME pictures as images, carrying this colourway's colour and colorId.
       * images stays a bare string[] for existing callers; this is the additive half. */
      imageAssets: ProductImage[];
      sale: SaleEvidence;
      coordination: CoordinationMetadata;
      /** ISO 4217 from the colourway url's own locale, or null for an unknown one. */
      currency: string | null;
      inStock: boolean;
      optionGroups: LululemonOptionGroup[];
    
      variants: LululemonVariant[];
    }
    
    interface LululemonSizeType {
      /** A sibling product that is the same style in another length. */
      productId: string;
      size: string;
      selected: boolean;
    }
    
    interface LululemonProduct {
      id: string;
      title: string;
      brand: string;
      /** The product page on the store it was read from, /en-ca/ for Canada. */
      url: string;
      /** Which storefront answered: "us" (the default) or "ca". */
      country: "us" | "ca";
      /** ISO 4217 for every price on this record: "USD", or "CAD" for Canada. */
      currency: string | null;
      /** The store's own audience attribute, e.g. "women". */
      gender: string | null;
      rating: number | null;
      reviewCount: number | null;
      inStock: boolean;
      priceLow: number | null;
      priceHigh: number | null;
      colorways: LululemonColorway[];
      /** Other LENGTHS of the same style (25", 28", 31"), each its own product id, * an inseam is a separate product on this site. Regional lengths the US store
       * does not sell are left out. */
      sizeTypes: LululemonSizeType[];
      attributes: PublishedProductAttributes;
      coordination: CoordinationMetadata;
      /** An explicit retailer-published pairing, shopThisLook, resolved to the
       * companion products it names. Empty when the colourway named none, or named
       * only ids the store no longer carries. */
      retailerSetEvidence: RetailerSetEvidence[];
      /** Non-empty only when resolving shopThisLook failed to answer, the
       * companion products could not be looked up this call. Empty otherwise. */
      warnings: string[];
    }
    
    /** What getProducts returns. Every id search returns reads here; an id that
     * does not is NAMED in missing rather than silently dropped. A legacy prod…
     * id is answered under the product's current id. */
    interface LululemonProductBatch {
      /** In the order the ids were passed, not the order they finished. */
      products: LululemonProduct[];
      /** Every id that did not read, with the catalogue's own sentence. */
      missing: Array<{ productId: string; detail: string }>;
      requested: number;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/lululemon/getProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lululemon.getProducts({
      productIds: ["prod2020012", "prod6020330", "prod00000000"]
    });
  • getReviewsReads the customer reviews on one product.

    Arguments

    NameTypeRequired
    query{ productId: string; country?: "us" | "ca" } | LululemonRowYes
    interface LululemonRow {
      id: string;
      title: string;
      url: string;
    
      priceLow: number | null;
      priceHigh: number | null;
      colorCount: number | null;
      inStock: boolean | null;
      onSale: boolean | null;
      /** False only on the fallback path (the store's search did not answer). */
      priced: boolean;
      image: string | null;
      /** ISO 4217 for priceLow/priceHigh: "USD", or "CAD" on a Canadian search. */
      currency: string | null;
      category: string | null;
      colorFamilies: string[];
    }

    Returns { reviews: LululemonReview[]; warnings: string[] }

    /** One review on a product, as lululemon's Bazaarvoice-hosted review section
     * publishes it. */
    interface LululemonReview {
      /** The reviewer's rating, 1-5. */
      rating: number;
      title: string;
      body: string;
      /** How many people marked this review helpful. */
      helpfulCount: number;
      /** ISO 8601. */
      date: string;
      /** The reviewer's screen name, null when Bazaarvoice publishes none. */
      reviewerName: string | null;
      /** The size the reviewer says they purchased, when the review carries that
       * field. Null on a review that answered no size question. */
      sizeAndFit: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/lululemon/getReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lululemon.getReviews({ productId: "prod2020012" });
  • getSimilarProductsReturns the products lululemon's own product pages recommend alongside one product.

    Arguments

    NameTypeRequired
    query{ productId: string; limit?: number } | LululemonRowYes
    interface LululemonRow {
      id: string;
      title: string;
      url: string;
    
      priceLow: number | null;
      priceHigh: number | null;
      colorCount: number | null;
      inStock: boolean | null;
      onSale: boolean | null;
      /** False only on the fallback path (the store's search did not answer). */
      priced: boolean;
      image: string | null;
      /** ISO 4217 for priceLow/priceHigh: "USD", or "CAD" on a Canadian search. */
      currency: string | null;
      category: string | null;
      colorFamilies: string[];
    }

    Returns LululemonSimilarProducts

    interface LululemonRow {
      id: string;
      title: string;
      url: string;
    
      priceLow: number | null;
      priceHigh: number | null;
      colorCount: number | null;
      inStock: boolean | null;
      onSale: boolean | null;
      /** False only on the fallback path (the store's search did not answer). */
      priced: boolean;
      image: string | null;
      /** ISO 4217 for priceLow/priceHigh: "USD", or "CAD" on a Canadian search. */
      currency: string | null;
      category: string | null;
      colorFamilies: string[];
    }
    
    /** US store only: the rail is a third party's, and it has no Canadian catalogue. */
    interface LululemonSimilarProducts {
      seedProductId: string;
      products: LululemonRow[];
      totalRanked: number | null;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/lululemon/getSimilarProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lululemon.getSimilarProducts({ productId: "prod2020012" });
  • getSizeGuideReturns lululemon's size chart for one garment.

    Arguments

    NameTypeRequired
    query{ productId: string; country?: "us" | "ca" } | LululemonRowYes
    interface LululemonRow {
      id: string;
      title: string;
      url: string;
    
      priceLow: number | null;
      priceHigh: number | null;
      colorCount: number | null;
      inStock: boolean | null;
      onSale: boolean | null;
      /** False only on the fallback path (the store's search did not answer). */
      priced: boolean;
      image: string | null;
      /** ISO 4217 for priceLow/priceHigh: "USD", or "CAD" on a Canadian search. */
      currency: string | null;
      category: string | null;
      colorFamilies: string[];
    }

    Returns LululemonSizeGuide

    /** One row of a size chart: the row header ("Your Waist") and one cell per size column. */
    interface LululemonSizeChartRow {
      label: string;
      values: string[];
    }
    
    interface LululemonSizeChart {
      /** The chart's own title, e.g. "Leggings Size Chart". */
      title: string;
      /** "numeric" or "alpha", as the store labels it. */
      sizingSystem: string | null;
      /** What the chart covers, markdown links verbatim. */
      description: string | null;
      inches: LululemonSizeChartRow[];
      centimeters: LululemonSizeChartRow[];
    }
    
    interface LululemonSizeGuide {
      productId: string;
      productName: string | null;
      /** The store's own key for the guide, e.g. "womens-pants". */
      sizeGuideCategory: string;
      /** The guide page on that storefront, /en-ca/help/size-guide/… for Canada. */
      guideUrl: string;
      country: "us" | "ca";
      charts: LululemonSizeChart[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/lululemon/getSizeGuide

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lululemon.getSizeGuide({ productId: "prod2020012" });

Use it from code