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.
- Site
- mango.com
- 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/mangoEvery 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/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
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
Name Type Required 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mango.getProduct("37055981");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mango.getProduct("37055981"))curl -X POST https://api.bowmark.ai/v1/sites/mango/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"productId":"37055981"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mango.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mango.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/mango/listCategories \ -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.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
Name Type Required 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
MangoSearchResultinterface 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/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mango.searchProducts({ query: "sweater", gender: "men", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mango.searchProducts({"query": "sweater", "gender": "men", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/mango/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"sweater","gender":"men","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.mango.searchProducts({ query: "sweater", gender: "men", limit: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/mango/<function> - OpenAPI
/v1/sites/mango/openapi.json