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.

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/marks
Every 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/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 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

    NameTypeRequired
    latitudenumberYes
    longitudenumberYes
    radiusKmnumber
    Default 25, max 2000.
    No
    limitnumber
    Default 10, max 50.
    No

    Returns MarksStoreSearch

    interface 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/findStores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    productstring | MarksProductRefYes
    options.storeIdstring | number
    A findStores storeId; adds that store's per-SKU quantity.
    No
    interface MarksProductRef {
      code?: string;
      url?: string;
      storeId?: string | number;
    }

    Returns MarksProduct

    interface 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/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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 MarksSearchResult

    interface 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/searchProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.marks.searchProducts({ query: "jeans" });

Use it from code