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.

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

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

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.gap.getProduct("847912062");
  • searchProductsSearches Gap's live apparel catalog (www.gap.com) for what a shopper types.

    Arguments

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

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.gap.searchProducts({ query: "shirt", department: "men" });

Use it from code