Banana Republic MCP server for AI agents

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

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

Connect

Just Banana Republic

An MCP server for Banana Republic 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/banana_republic
Every site

One MCP server for Banana Republic 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 Banana Republic product's variant-level sizes, colors and fits with each SKU's sale price, regular price and live in-stock flag, plus…

    Arguments

    NameTypeRequired
    productstring | { ccId: string; country?: "us" | "ca" } | BananaRepublicSearchHitYes
    interface BananaRepublicSearchHit {
      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 BananaRepublicProduct

    interface BananaRepublicSku {
      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 BananaRepublicColor {
      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 BananaRepublicProduct {
      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: BananaRepublicColor[];
      skus: BananaRepublicSku[];
      inStock: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.banana_republic.getProduct("894900002");
  • searchProductsSearches Banana Republic's live apparel catalog (bananarepublic.gap.com clothing store) for what a shopper types.

    Arguments

    NameTypeRequired
    argsBananaRepublicSearchArgs | stringYes
    interface BananaRepublicSearchArgs {
      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" = bananarepublic.gapcanada.ca, prices in CAD
    }

    Returns BananaRepublicSearchResult

    interface BananaRepublicSearchHit {
      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 BananaRepublicSearchResult {
      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: BananaRepublicSearchHit[];
      warnings: string[]; // a results page that failed after the first; empty when complete
    }

    HTTP endpoint

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

    Call it

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

Use it from code