J.Crew MCP server for AI agents

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

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

Connect

Just J.Crew

An MCP server for J.Crew 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/jcrew
Every site

One MCP server for J.Crew 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 12
  • browseCategoryLists the products in one J.Crew category the way the site's own category pages do.

    Arguments

    NameTypeRequired
    categoryIdstringYes
    startnumber
    Zero-based offset. Pass start + pageSize for the next page; the walk is done once start >= total. Without it only the first page (25) is read.
    No
    countnumber
    Rows per page, 1-200 (default 25).
    No
    sortstring
    One of listSortOptions()' ids, e.g. "Price-Low-to-High".
    No
    refineRecord<string, string>
    Filters, refinement id -> value from listSearchRefinements(), e.g. { c_isSaleSkuUs: "true" } (items actually marked down), { c_productGender: "Men" } (keeps women's items out of a search), { c_masterSize: "LARGE" }.
    No
    country"us" | "ca"
    "us" (default) | "ca", same category ids, prices in CAD.
    No

    Returns BrowseCategoryResult

    interface BrowseCategoryResult {
      categoryId: string;
      country: "us" | "ca";
      currency: string;
      total: number;
      pageSize: number;
      products: Array<{
        id: string;
        name: string;
        price: number | null;
        currency: string | null;
        orderable: boolean | null;
        image: string | null;
        url: string;
      }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/browseCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.browseCategory({ categoryId: "mens" });
  • checkVariantStockAnswers whether one specific colour and size of a J.Crew style is buyable right now.

    Arguments

    NameTypeRequired
    idstringYes
    colourstringYes
    sizestringYes
    fitstringNo
    country"us" | "ca"No

    Returns CheckVariantStockResult

    interface CheckVariantStockResult {
      id: string;
      country: "us" | "ca";
      /** "USD" | "CAD", price and listPrice. */
      currency: string;
      variantId: string;
      colour: string;
      size: string;
      fit: string | null;
      price: number | null;
      listPrice: number | null;
      onSale: boolean;
      orderable: boolean | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/checkVariantStock

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.checkVariantStock({ id: "BX291", colour: "White", size: "M" });
  • findStoresFinds physical J.Crew stores near a point the way the site's own store locator does.

    Arguments

    NameTypeRequired
    zipstringNo
    latitudenumberNo
    longitudenumberNo
    radiusKmnumberNo
    maxResultsnumberNo

    Returns FindStoresResult

    interface JcrewStoreWeek {
      monday: string;
      tuesday: string;
      wednesday: string;
      thursday: string;
      friday: string;
      saturday: string;
      sunday: string;
    }
    
    interface JcrewStore {
      id: string;
      name: string;
      address1: string;
      address2: string | null;
      city: string;
      state: string;
      zip: string;
      countryCode: string;
      phone: string;
      email: string;
      latitude: number;
      longitude: number;
      distance: number;
      distanceUnit: string;
      hours: JcrewStoreWeek;
      curbsidePickup: boolean;
      inStorePickup: boolean;
      sameDayDelivery: boolean;
      availableMerchandise: string[];
    }
    
    interface FindStoresResult {
      latitude: number;
      longitude: number;
      radiusKm: number;
      total: number;
      stores: JcrewStore[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/findStores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.findStores({ latitude: 40.7128, longitude: -74.006, radiusKm: 50 });
  • getCategoryReads one J.Crew category by id.

    Arguments

    NameTypeRequired
    categoryIdstringYes
    country"us" | "ca"No

    Returns GetCategoryResult

    interface JcrewCategoryAncestor {
      id: string;
      name: string;
    }
    
    interface GetCategoryResult {
      id: string;
      name: string;
      parentId: string | null;
      path: JcrewCategoryAncestor[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/getCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.getCategory({ categoryId: "mens" });
  • getProductReads one J.Crew product in full the way its own product detail page does.

    Arguments

    NameTypeRequired
    argsGetProductArgs | stringYes
    interface GetProductArgs {
      /** A style id ("BX291") or a jcrew.com product URL, a /ca/p/... URL reads
       * the Canadian store. A searchProducts row can be passed whole. */
      id: string;
      /** "us" (default) | "ca". Absent, a /ca/ URL in id (or the row's url) decides. */
      country?: "us" | "ca";
      url?: string;
    }

    Returns GetProductResult

    interface JcrewProductVariant {
      id: string;
      colour: string | null;
      /** J.Crew's colour code, e.g. "WZ8904". */
      colourCode: string | null;
      /** This colour's 600px product image. */
      image: string | null;
      size: string | null;
      fit: string | null;
      price: number | null;
      /** Pre-discount price for this variant's fit. */
      listPrice: number | null;
      /** price < listPrice, J.Crew marks down per SKU. */
      onSale: boolean;
      orderable: boolean | null;
    }
    
    interface JcrewProductImage {
      url: string;
      alt: string | null;
    }
    
    interface GetProductResult {
      id: string;
      country: "us" | "ca";
      /** This product's page in that store. */
      url: string;
      name: string;
      description: string | null;
      longDescription: string | null;
      price: number | null;
      priceRange: string | null;
      currency: string | null;
      orderable: boolean | null;
      stockLevel: number | null;
      listPrice: number | null;
      rating: number | null;
      reviewCount: number | null;
      colours: string[];
      sizes: string[];
      fits: string[];
      variants: JcrewProductVariant[];
      images: JcrewProductImage[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.getProduct({ id: "BX291" });
  • getProductsReads several J.Crew products in one call, given a list of style ids.

    Arguments

    NameTypeRequired
    idsstring[]
    Style ids or product URLs, at most 24.
    Yes
    country"us" | "ca"
    "us" (default) | "ca".
    No

    Returns GetProductsResult

    interface JcrewProductVariant {
      id: string;
      colour: string | null;
      /** J.Crew's colour code, e.g. "WZ8904". */
      colourCode: string | null;
      /** This colour's 600px product image. */
      image: string | null;
      size: string | null;
      fit: string | null;
      price: number | null;
      /** Pre-discount price for this variant's fit. */
      listPrice: number | null;
      /** price < listPrice, J.Crew marks down per SKU. */
      onSale: boolean;
      orderable: boolean | null;
    }
    
    interface JcrewProductImage {
      url: string;
      alt: string | null;
    }
    
    interface GetProductsItem {
      id: string;
      name: string;
      description: string | null;
      longDescription: string | null;
      price: number | null;
      priceRange: string | null;
      currency: string | null;
      orderable: boolean | null;
      stockLevel: number | null;
      /** The style's pre-discount list price. */
      listPrice: number | null;
      /** True when any variant is below its list price. */
      onSale: boolean;
      colours: string[];
      sizes: string[];
      fits: string[];
      variants: JcrewProductVariant[];
      images: JcrewProductImage[];
    }
    
    interface GetProductsResult {
      country: "us" | "ca";
      /** "USD" | "CAD", every price in every product. */
      currency: string;
      products: GetProductsItem[];
      missing: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.getProducts({ ids: ["BX291", "MS068"] });
  • listCategoriesWalks J.Crew's own category tree from a starting category down a requested number of levels, returning each category's id, display name and parent.

    Arguments

    NameTypeRequired
    categoryIdstringNo
    levelsnumberNo
    country"us" | "ca"
    "us" (default) | "ca", the same tree and ids in both.
    No

    Returns ListCategoriesResult

    interface JcrewCategory {
      id: string;
      name: string;
      parentId: string;
    }
    
    interface ListCategoriesResult {
      categoryId: string;
      levels: number;
      categories: JcrewCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.listCategories({});
  • listProductReviewsReads the customer reviews on one J.Crew product off Bazaarvoice, the site's third-party review platform.

    Arguments

    NameTypeRequired
    idstringYes
    limitnumberNo

    Returns ListProductReviewsResult

    interface JcrewReview {
      rating: number;
      title: string;
      body: string;
      helpfulCount: number;
      date: string;
      reviewerName: string | null;
      sizePurchased: string | null;
    }
    
    interface ListProductReviewsResult {
      id: string;
      total: number;
      reviews: JcrewReview[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/listProductReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.listProductReviews({ id: "BX291" });
  • listSearchRefinementsLists the filters J.Crew itself offers for a given search or category.

    Arguments

    NameTypeRequired
    querystringNo
    categoryIdstringNo
    country"us" | "ca"
    "us" (default) | "ca", the Canadian store's counts, and its c_discountPercentageCAD "Discount" group.
    No

    Returns ListSearchRefinementsResult

    interface JcrewRefinementValue {
      value: string;
      label: string;
      count: number;
    }
    
    interface JcrewRefinementGroup {
      id: string;
      label: string;
      values: JcrewRefinementValue[];
    }
    
    interface ListSearchRefinementsResult {
      query: string | null;
      categoryId: string | null;
      country: "us" | "ca";
      refinements: JcrewRefinementGroup[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/listSearchRefinements

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.listSearchRefinements({ query: "oxford shirt" });
  • listSortOptionsLists the sort orders J.Crew's own result pages offer.

    Arguments

    None.

    Returns ListSortOptionsResult

    interface JcrewSortOption {
      id: string;
      label: string;
    }
    
    interface ListSortOptionsResult {
      sortOptions: JcrewSortOption[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/listSortOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.listSortOptions();
  • searchProductsSearches J.Crew's live catalogue the way its own search bar does.

    Arguments

    NameTypeRequired
    querystringYes
    startnumber
    Zero-based offset. Pass start + pageSize for the next page; the walk is done once start >= total. Without it only the first page (25) is read.
    No
    countnumber
    Rows per page, 1-200 (default 25).
    No
    sortstring
    One of listSortOptions()' ids, e.g. "Price-Low-to-High".
    No
    refineRecord<string, string>
    Filters, refinement id -> value from listSearchRefinements(), e.g. { c_isSaleSkuUs: "true" } (items actually marked down), { c_productGender: "Men" } (keeps women's items out of a search), { c_masterSize: "LARGE" }.
    No
    country"us" | "ca"
    "us" (default) | "ca", the Canadian store, prices in CAD.
    No

    Returns SearchProductsResult

    interface JcrewSearchProduct {
      id: string;
      name: string;
      price: number | null;
      currency: string | null;
      orderable: boolean | null;
      image: string | null;
      url: string;
    }
    
    interface SearchProductsResult {
      query: string;
      country: "us" | "ca";
      /** "USD" | "CAD", every price on the page. */
      currency: string;
      total: number;
      pageSize: number;
      products: JcrewSearchProduct[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/searchProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.searchProducts({ query: "oxford shirt" });
  • suggestSearchTermsCompletes a partial search the way J.Crew's own type-ahead does.

    Arguments

    NameTypeRequired
    querystringYes
    country"us" | "ca"No

    Returns SuggestSearchTermsResult

    interface JcrewSuggestedCategory {
      id: string;
      name: string;
      parentCategoryName: string | null;
    }
    
    interface JcrewSuggestedProduct {
      id: string;
      name: string;
      price: number | null;
      currency: string | null;
    }
    
    interface SuggestSearchTermsResult {
      query: string;
      country: "us" | "ca";
      currency: string;
      terms: string[];
      categories: JcrewSuggestedCategory[];
      products: JcrewSuggestedProduct[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/jcrew/suggestSearchTerms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.jcrew.suggestSearchTerms({ query: "oxford" });

Use it from code