Gap MCP server for AI agents
Let Claude, ChatGPT or your own agent read Gap: 2 typed functions through one MCP server. No Gap API key needed.
- Site
- gap.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Gap
An MCP server for Gap 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/gapEvery site
One MCP server for Gap 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 2
getProductReads one Gap product's variant-level sizes, colors and fits with each SKU's sale price, regular price and live in-stock flag, plus per-color photos…Arguments
Name Type Required productstring | { ccId: string; country?: "us" | "ca" } | GapSearchHitYes interface GapSearchHit { styleId: string; ccId: string; // pass to getProduct (or pass the whole hit, which carries its country) country: "us" | "ca"; currency: string; // "USD" | "CAD" url: string; // opens this color title: string; color: string | null; colorDescription: string | null; productType: string | null; // e.g. "mens shirts" price: number | null; // what it costs now regularPrice: number | null; // compare-at percentOff: number | null; onSale: boolean; inStock: boolean; // "In Stock", "Low" and "Very Low" are all in stock lowStock: boolean; // "Low" / "Very Low" inventoryStatus: string | null; // "In Stock" | "Low" | "Very Low" | … reviewScore: number | null; reviewCount: number | null; image: string | null; // this color's product photo }Returns
GapProductinterface GapSku { skuId: string; fit: string; // "REGULAR", "TALL", "PETITE", … ccId: string; color: string | null; size: string | null; size2: string | null; // second size dimension (e.g. inseam), when the product has one price: number | null; regularPrice: number | null; percentOff: number | null; onSale: boolean; inStock: boolean; lowStock: boolean; status: string | null; // "IN_STOCK" | "OUT_OF_STOCK" | … } interface GapColor { ccId: string; color: string | null; fit: string; url: string; // opens this color price: number | null; regularPrice: number | null; percentOff: number | null; onSale: boolean; inStock: boolean; sizesInStock: string[]; sizesOutOfStock: string[]; image: string | null; // main photo of this color images: string[]; // main photo first, then the alternate views swatch: string | null; // fabric swatch } interface GapProduct { styleId: string; ccId: string; country: "us" | "ca"; currency: string; // every price on this product is in this currency url: string; title: string; fits: string[]; sizes: string[]; colors: GapColor[]; skus: GapSku[]; inStock: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/gap/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.gap.getProduct("847912062");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.gap.getProduct("847912062"))curl -X POST https://api.bowmark.ai/v1/sites/gap/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"product":"847912062"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.gap.getProduct("847912062");searchProductsSearches Gap's live apparel catalog (www.gap.com) for what a shopper types.Arguments
Name Type Required argsGapSearchArgs | stringYes interface GapSearchArgs { query: string; department?: "men" | "women"; inStockOnly?: boolean; onSaleOnly?: boolean; limit?: number; // default 24, max 2000; the search walks result pages until it has this many country?: "us" | "ca"; // which store; default "us". "ca" = www.gapcanada.ca, prices in CAD }Returns
GapSearchResultinterface GapSearchHit { styleId: string; ccId: string; // pass to getProduct (or pass the whole hit, which carries its country) country: "us" | "ca"; currency: string; // "USD" | "CAD" url: string; // opens this color title: string; color: string | null; colorDescription: string | null; productType: string | null; // e.g. "mens shirts" price: number | null; // what it costs now regularPrice: number | null; // compare-at percentOff: number | null; onSale: boolean; inStock: boolean; // "In Stock", "Low" and "Very Low" are all in stock lowStock: boolean; // "Low" / "Very Low" inventoryStatus: string | null; // "In Stock" | "Low" | "Very Low" | … reviewScore: number | null; reviewCount: number | null; image: string | null; // this color's product photo } interface GapSearchResult { query: string; department: "Men" | "Women" | null; country: "us" | "ca"; currency: string; total: number; // colors the site matched, before inStockOnly/onSaleOnly/limit pagesRead: number; pageCount: number; // result pages the site has for this query (200 colors each) hasMore: boolean; // true when more matching colors exist past `limit` hits: GapSearchHit[]; warnings: string[]; // a results page that failed after the first; empty when complete }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/gap/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.gap.searchProducts({ query: "shirt", department: "men" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.gap.searchProducts({"query": "shirt", "department": "men"}))curl -X POST https://api.bowmark.ai/v1/sites/gap/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"shirt","department":"men"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.gap.searchProducts({ query: "shirt", department: "men" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/gap/<function> - OpenAPI
/v1/sites/gap/openapi.json