Mango MCP server for AI agents

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

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

Connect

Just Mango

An MCP server for Mango 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/mango
Every site

One MCP server for Mango 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
  • getProductReads one Mango product's colors and sizes with each color's price, compare-at price, discount, live per-size stock and photos (model, flat…

    Arguments

    NameTypeRequired
    productIdstring | MangoProduct | { productId: string; country?: MangoCountry }Yes
    /** Which Mango store: "us" (default, USD) or "ca" (Canada, CAD). Catalogs differ by store. */
    type MangoCountry = "us" | "ca";
    
    interface MangoSize { sizeId: string; label: string; inStock: boolean; lastUnits: boolean }
    
    /** Mango's own photo URLs for one color. A product with no studio shoot (home goods)
     * has only the swatch; its other shots answer 403. */
    interface MangoImages {
      /** Full-length, front, back, on a model. */
      model: string[];
      /** The garment alone. */
      flat: string;
      /** A close-up. */
      detail: string;
      /** The fabric swatch; always present. */
      swatch: string;
    }
    
    interface MangoColor {
      colorId: string;
      label: string;
      price: number | null;
      /** Mango's previous price when the color is marked down; null when it is not. */
      compareAtPrice: number | null;
      discountPercent: number | null;
      onSale: boolean;
      /** Sizes of THIS color. A search's size filter matches the product, so check here. */
      sizes: MangoSize[];
      /** The first model shot, images.model[0]. */
      imageUrl: string;
      images: MangoImages;
    }
    
    interface MangoProduct {
      productId: string;
      /** The store it was read from. Pass the hit itself to getProduct to stay in that store. */
      country: MangoCountry;
      /** "USD" or "CAD"; every price on this product is in it. */
      currency: string;
      name: string;
      url: string;
      model: string | null;
      collection: string | null;
      gender: string | null;
      families: string[];
      colors: MangoColor[];
      minPrice: number | null;
      onSale: boolean;
      inStock: boolean;
    }

    Returns MangoProduct

    /** Which Mango store: "us" (default, USD) or "ca" (Canada, CAD). Catalogs differ by store. */
    type MangoCountry = "us" | "ca";
    
    interface MangoSize { sizeId: string; label: string; inStock: boolean; lastUnits: boolean }
    
    /** Mango's own photo URLs for one color. A product with no studio shoot (home goods)
     * has only the swatch; its other shots answer 403. */
    interface MangoImages {
      /** Full-length, front, back, on a model. */
      model: string[];
      /** The garment alone. */
      flat: string;
      /** A close-up. */
      detail: string;
      /** The fabric swatch; always present. */
      swatch: string;
    }
    
    interface MangoColor {
      colorId: string;
      label: string;
      price: number | null;
      /** Mango's previous price when the color is marked down; null when it is not. */
      compareAtPrice: number | null;
      discountPercent: number | null;
      onSale: boolean;
      /** Sizes of THIS color. A search's size filter matches the product, so check here. */
      sizes: MangoSize[];
      /** The first model shot, images.model[0]. */
      imageUrl: string;
      images: MangoImages;
    }
    
    interface MangoProduct {
      productId: string;
      /** The store it was read from. Pass the hit itself to getProduct to stay in that store. */
      country: MangoCountry;
      /** "USD" or "CAD"; every price on this product is in it. */
      currency: string;
      name: string;
      url: string;
      model: string | null;
      collection: string | null;
      gender: string | null;
      families: string[];
      colors: MangoColor[];
      minPrice: number | null;
      onSale: boolean;
      inStock: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mango.getProduct("37055981");
  • listCategoriesLists the Mango catalog categories (men's sweaters and cardigans, shirts, jeans, women's dresses…) with the ids searchProducts takes; the same ids…

    Arguments

    None.

    Returns MangoCategory[]

    interface MangoCategory { id: string; gender: "men" | "women" | "kids"; title: string }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mango.listCategories();
  • searchProductsSearches Mango's apparel catalog for what a shopper asks (men's sweater, long sleeve shirt) and returns each product with variant sizes, sale and…

    Arguments

    NameTypeRequired
    argsMangoSearchArgs | stringYes
    /** Which Mango store: "us" (default, USD) or "ca" (Canada, CAD). Catalogs differ by store. */
    type MangoCountry = "us" | "ca";
    
    interface MangoSearchArgs {
      /** Shopper words, "sweater", "long sleeve shirt". Matched to a category; with no category match, to product names. */
      query?: string;
      /** A category id from listCategories(); overrides the match. */
      category?: string;
      gender?: "men" | "women" | "kids";
      /** Size label as Mango prints it: "M", "XL", "32", "One size". */
      size?: string;
      onSaleOnly?: boolean;
      inStockOnly?: boolean;
      /** 1-60, default 20. For more, page with offset. */
      limit?: number;
      /** Listing position to start at, pass the previous result's nextOffset. Default 0. */
      offset?: number;
      /** "us" (default) or "ca" for Canadian prices (CAD), stock and URLs. */
      country?: MangoCountry;
    }

    Returns MangoSearchResult

    interface MangoCategory { id: string; gender: "men" | "women" | "kids"; title: string }
    
    /** Which Mango store: "us" (default, USD) or "ca" (Canada, CAD). Catalogs differ by store. */
    type MangoCountry = "us" | "ca";
    
    interface MangoSize { sizeId: string; label: string; inStock: boolean; lastUnits: boolean }
    
    /** Mango's own photo URLs for one color. A product with no studio shoot (home goods)
     * has only the swatch; its other shots answer 403. */
    interface MangoImages {
      /** Full-length, front, back, on a model. */
      model: string[];
      /** The garment alone. */
      flat: string;
      /** A close-up. */
      detail: string;
      /** The fabric swatch; always present. */
      swatch: string;
    }
    
    interface MangoColor {
      colorId: string;
      label: string;
      price: number | null;
      /** Mango's previous price when the color is marked down; null when it is not. */
      compareAtPrice: number | null;
      discountPercent: number | null;
      onSale: boolean;
      /** Sizes of THIS color. A search's size filter matches the product, so check here. */
      sizes: MangoSize[];
      /** The first model shot, images.model[0]. */
      imageUrl: string;
      images: MangoImages;
    }
    
    interface MangoProduct {
      productId: string;
      /** The store it was read from. Pass the hit itself to getProduct to stay in that store. */
      country: MangoCountry;
      /** "USD" or "CAD"; every price on this product is in it. */
      currency: string;
      name: string;
      url: string;
      model: string | null;
      collection: string | null;
      gender: string | null;
      families: string[];
      colors: MangoColor[];
      minPrice: number | null;
      onSale: boolean;
      inStock: boolean;
    }
    
    interface MangoSearchResult {
      country: MangoCountry;
      currency: string;
      category: MangoCategory;
      /** Tiles Mango lists (one per product COLOR), so distinct products are fewer. */
      totalInCategory: number;
      offset: number;
      /** Products read this call to find the hits; one call reads at most 120. */
      scanned: number;
      hits: MangoProduct[];
      /** More of the category remains, fewer hits than limit does NOT mean the category is done. */
      hasMore: boolean;
      /** Pass as offset to read the next stretch: while (r.hasMore) r = await searchProducts({ ...args, offset: r.nextOffset }). Null when done. */
      nextOffset: number | null;
      /** Listed products that could not be read; empty on a whole answer. */
      warnings: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mango.searchProducts({ query: "sweater", gender: "men", limit: 3 });

Use it from code