Mark's MCP server for AI agents
Let Claude, ChatGPT or your own agent read Mark's: 3 typed functions through one MCP server. No Mark's API key needed.
- Site
- marks.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Mark's
An MCP server for Mark's 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/marksEvery site
One MCP server for Mark's 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.
Read 3
findStoresLists the Mark's stores nearest a latitude/longitude with address, distance, opening hours and the storeId getProduct takes for per-store stock.Arguments
Name Type Required latitudenumberYes longitudenumberYes radiusKmnumberDefault 25, max 2000.No limitnumberDefault 10, max 50.No Returns
MarksStoreSearchinterface MarksStoreHours { day: string; open: string | null; // "10:00 AM" close: string | null; closed: boolean; } interface MarksStore { storeId: string; // pass to getProduct / searchProducts as storeId name: string; address: string | null; city: string | null; province: string | null; // "ON" postalCode: string | null; phone: string | null; latitude: number | null; longitude: number | null; distanceKm: number | null; url: string; inStorePickup: boolean; hours: MarksStoreHours[]; } interface MarksStoreSearch { latitude: number; longitude: number; radiusKm: number; stores: MarksStore[]; // nearest first; empty when no Mark's is inside the radius }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/marks/findStoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.marks.findStores({ latitude: 43.6532, longitude: -79.3832 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.marks.findStores({"latitude": 43.6532, "longitude": -79.3832}))curl -X POST https://api.bowmark.ai/v1/sites/marks/findStores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"latitude":43.6532,"longitude":-79.3832}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.marks.findStores({ latitude: 43.6532, longitude: -79.3832 });getProductReads one Mark's product's size and colour options and every SKU with its CAD price, regular price, sale, online quantity and, given a storeId, that…Arguments
Name Type Required productstring | MarksProductRefYes options.storeIdstring | numberA findStores storeId; adds that store's per-SKU quantity.No interface MarksProductRef { code?: string; url?: string; storeId?: string | number; }Returns
MarksProductinterface MarksColour { id: string; // e.g. "COLOUR_Light_Wash" name: string; // e.g. "Light Wash" url: string; // opens the product on this colour price: number | null; // CAD, what it costs now originalPrice: number | null; // CAD, the regular price onSale: boolean; salePercent: number | null; saleEndsOn: string | null; // ISO date the sale price ends availableToSell: number | null; // the site's max units available for any one SKU of this colour (search only) image: string | null; images: string[]; swatch: string | null; skuCodes: string[]; } interface MarksOptionAxis { descriptor: string; // e.g. "WAIST_SIZE_CD" name: string; // e.g. "Waist/Size", "Pants Length", "Primary Colour" values: string[]; } interface MarksSku { sku: string; url: string; // opens the product on exactly this SKU colour: string | null; size: string | null; // the non-colour options, waist first: "32 / 30" options: Record<string, string>; // axis name -> value price: number | null; // CAD originalPrice: number | null; // CAD onSale: boolean; salePercent: number | null; saleEndsOn: string | null; // ISO date onlineQuantity: number | null; // units available to ship (null if stock could not be read) inStockOnline: boolean | null; storeQuantity: number | null; // units at options.storeId; null when no storeId was given inStockAtStore: boolean | null; lowStock: boolean; sellable: boolean; } interface MarksProduct { code: string; name: string; brand: string | null; url: string; currency: "CAD"; price: number | null; originalPrice: number | null; onSale: boolean; salePercent: number | null; saleEndsOn: string | null; rating: number | null; ratingsCount: number | null; description: string | null; features: string[]; images: string[]; options: MarksOptionAxis[]; colours: MarksColour[]; sizes: string[]; skus: MarksSku[]; storeId: string | null; // the store storeQuantity is for; null = online stock only inStockOnline: boolean; warnings: string[]; // stock that could not be read for some SKUs; empty when complete }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/marks/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.marks.getProduct("12593084F", { storeId: "536" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.marks.getProduct("12593084F", {"storeId": "536"}))curl -X POST https://api.bowmark.ai/v1/sites/marks/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"product":"12593084F","options":{"storeId":"536"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.marks.getProduct("12593084F", { storeId: "536" });searchProductsSearches Mark's live clothing and workwear catalog (www.marks.com, Canada only) for what a shopper types, optionally men's/women's and on-sale only…Arguments
Name Type Required argsMarksSearchArgs | stringYes interface MarksSearchArgs { query: string; storeId?: string | number; // a findStores storeId; only scopes the site's own search, stock is getProduct's job gender?: "men" | "women"; onSaleOnly?: boolean; // the site's own "Sale" deal filter (Clearance is a separate deal) limit?: number; // default 24, max 1000; walks result pages until it has this many }Returns
MarksSearchResultinterface MarksColour { id: string; // e.g. "COLOUR_Light_Wash" name: string; // e.g. "Light Wash" url: string; // opens the product on this colour price: number | null; // CAD, what it costs now originalPrice: number | null; // CAD, the regular price onSale: boolean; salePercent: number | null; saleEndsOn: string | null; // ISO date the sale price ends availableToSell: number | null; // the site's max units available for any one SKU of this colour (search only) image: string | null; images: string[]; swatch: string | null; skuCodes: string[]; } interface MarksSearchHit { code: string; // pass to getProduct title: string; brand: string | null; url: string; // marks.com product page image: string | null; currency: "CAD"; price: number | null; // cheapest colour's current price originalPrice: number | null; // that colour's regular price onSale: boolean; // any colour on sale salePercent: number | null; saleEndsOn: string | null; rating: number | null; ratingsCount: number | null; badges: string[]; // e.g. "SALE", "BESTSELLER", "Flash_Sale" colours: MarksColour[]; } interface MarksSearchResult { query: string; gender: "men" | "women" | null; onSaleOnly: boolean; storeId: string | null; currency: "CAD"; total: number; // products the site matched pageCount: number; pagesRead: number; hasMore: boolean; redirectUrl: string | null; // set when the site sends this query to a category page instead hits: MarksSearchHit[]; warnings: string[]; // a results page that failed after the first; empty when complete }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/marks/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.marks.searchProducts({ query: "jeans" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.marks.searchProducts({"query": "jeans"}))curl -X POST https://api.bowmark.ai/v1/sites/marks/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"jeans"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.marks.searchProducts({ query: "jeans" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/marks/<function> - OpenAPI
/v1/sites/marks/openapi.json