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.
- Site
- jcrew.com
- Functions
- 12
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/jcrewOne 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/mcpSet it up in your clientBoth 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.
browseCategoryLists the products in one J.Crew category the way the site's own category pages do.Arguments
Name Type Required categoryIdstringYes startnumberZero-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 countnumberRows per page, 1-200 (default 25).No sortstringOne 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
BrowseCategoryResultinterface 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/browseCategoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.browseCategory({ categoryId: "mens" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.browseCategory({"categoryId": "mens"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/browseCategory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"categoryId":"mens"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.browseCategory({ categoryId: "mens" });checkVariantStockAnswers whether one specific colour and size of a J.Crew style is buyable right now.Arguments
Name Type Required idstringYes colourstringYes sizestringYes fitstringNo country"us" | "ca"No Returns
CheckVariantStockResultinterface 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/checkVariantStockCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.checkVariantStock({ id: "BX291", colour: "White", size: "M" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.checkVariantStock({"id": "BX291", "colour": "White", "size": "M"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/checkVariantStock \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"BX291","colour":"White","size":"M"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required zipstringNo latitudenumberNo longitudenumberNo radiusKmnumberNo maxResultsnumberNo Returns
FindStoresResultinterface 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/findStoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.findStores({ latitude: 40.7128, longitude: -74.006, radiusKm: 50 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.findStores({"latitude": 40.7128, "longitude": -74.006, "radiusKm": 50}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/findStores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"latitude":40.7128,"longitude":-74.006,"radiusKm":50}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.findStores({ latitude: 40.7128, longitude: -74.006, radiusKm: 50 });getCategoryReads one J.Crew category by id.Arguments
Name Type Required categoryIdstringYes country"us" | "ca"No Returns
GetCategoryResultinterface 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/getCategoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.getCategory({ categoryId: "mens" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.getCategory({"categoryId": "mens"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/getCategory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"categoryId":"mens"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.getCategory({ categoryId: "mens" });getProductReads one J.Crew product in full the way its own product detail page does.Arguments
Name Type Required 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
GetProductResultinterface 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.getProduct({ id: "BX291" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.getProduct({"id": "BX291"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"BX291"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.getProduct({ id: "BX291" });getProductsReads several J.Crew products in one call, given a list of style ids.Arguments
Name Type Required idsstring[]Style ids or product URLs, at most 24.Yes country"us" | "ca""us" (default) | "ca".No Returns
GetProductsResultinterface 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/getProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.getProducts({ ids: ["BX291", "MS068"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.getProducts({"ids": ["BX291", "MS068"]}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/getProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"ids":["BX291","MS068"]}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required categoryIdstringNo levelsnumberNo country"us" | "ca""us" (default) | "ca", the same tree and ids in both.No Returns
ListCategoriesResultinterface 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.listCategories({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.listCategories({}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.listCategories({});listProductReviewsReads the customer reviews on one J.Crew product off Bazaarvoice, the site's third-party review platform.Arguments
Name Type Required idstringYes limitnumberNo Returns
ListProductReviewsResultinterface 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/listProductReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.listProductReviews({ id: "BX291" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.listProductReviews({"id": "BX291"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/listProductReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"BX291"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.listProductReviews({ id: "BX291" });listSearchRefinementsLists the filters J.Crew itself offers for a given search or category.Arguments
Name Type Required querystringNo categoryIdstringNo country"us" | "ca""us" (default) | "ca", the Canadian store's counts, and its c_discountPercentageCAD "Discount" group.No Returns
ListSearchRefinementsResultinterface 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/listSearchRefinementsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.listSearchRefinements({ query: "oxford shirt" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.listSearchRefinements({"query": "oxford shirt"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/listSearchRefinements \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"oxford shirt"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.listSearchRefinements({ query: "oxford shirt" });listSortOptionsLists the sort orders J.Crew's own result pages offer.Arguments
None.
Returns
ListSortOptionsResultinterface JcrewSortOption { id: string; label: string; } interface ListSortOptionsResult { sortOptions: JcrewSortOption[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/jcrew/listSortOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.listSortOptions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.listSortOptions())curl -X POST https://api.bowmark.ai/v1/sites/jcrew/listSortOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.listSortOptions();searchProductsSearches J.Crew's live catalogue the way its own search bar does.Arguments
Name Type Required querystringYes startnumberZero-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 countnumberRows per page, 1-200 (default 25).No sortstringOne 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
SearchProductsResultinterface 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/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.searchProducts({ query: "oxford shirt" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.searchProducts({"query": "oxford shirt"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"oxford shirt"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.searchProducts({ query: "oxford shirt" });suggestSearchTermsCompletes a partial search the way J.Crew's own type-ahead does.Arguments
Name Type Required querystringYes country"us" | "ca"No Returns
SuggestSearchTermsResultinterface 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/suggestSearchTermsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.jcrew.suggestSearchTerms({ query: "oxford" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.jcrew.suggestSearchTerms({"query": "oxford"}))curl -X POST https://api.bowmark.ai/v1/sites/jcrew/suggestSearchTerms \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"oxford"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.jcrew.suggestSearchTerms({ query: "oxford" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/jcrew/<function> - OpenAPI
/v1/sites/jcrew/openapi.json