Uniqlo MCP server for AI agents

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

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

Connect

Just Uniqlo

An MCP server for Uniqlo 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/uniqlo
Every site

One MCP server for Uniqlo 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 Uniqlo product's every color × size with its price, live stock status and unit count, per-color in-stock and sold-out size lists, photos…

    Arguments

    NameTypeRequired
    productstring | { productId: string; priceGroup?: string; market?: "com" | "ca"; country?: "us" | "ca" } | UniqloSearchHitYes
    interface UniqloColorRef {
      code: string; // color display code, e.g. "69"
      name: string | null; // "NAVY"
      image: string | null; // this color's product photo
    }
    
    interface UniqloSearchHit {
      productId: string; // pass with priceGroup to getProduct (or pass the hit itself)
      priceGroup: string; // "00" full price, "01"/"02" a reduced price for select colors/sizes
      country: "us" | "ca"; // the store this hit came from; getProduct(hit) reads the same store
      url: string;
      name: string;
      gender: string | null; // "MEN" | "WOMEN" | "UNISEX" | …
      price: number | null; // what it costs now
      regularPrice: number | null; // the original, ONLY when the site publishes one, usually null on a Sale item
      onSale: boolean; // the site marks it Sale
      currency: string | null; // "USD" | "CAD"
      rating: number | null;
      reviewCount: number | null;
      colors: UniqloColorRef[];
      sizes: string[];
      image: string | null;
    }

    Returns UniqloProduct

    interface UniqloSku {
      l2Id: string;
      color: string | null;
      colorCode: string | null;
      size: string | null; // "M", "L", "3XL", …
      sizeCode: string | null;
      url: string; // opens this color AND size
      price: number | null;
      regularPrice: number | null; // original, when published; else null
      onSale: boolean;
      inStock: boolean; // IN_STOCK or LOW_STOCK
      lowStock: boolean;
      quantity: number | null; // units the site reports
      status: string | null; // "IN_STOCK" | "LOW_STOCK" | "STOCK_OUT"
    }
    
    interface UniqloColor {
      code: string;
      name: string | null;
      url: string; // opens this color
      image: string | null; // main photo
      images: string[]; // main photo first, then this color's other views
      inStock: boolean;
      sizesInStock: string[];
      sizesOutOfStock: string[];
    }
    
    interface UniqloProduct {
      productId: string;
      priceGroup: string;
      country: "us" | "ca";
      url: string;
      name: string;
      gender: string | null;
      price: number | null;
      regularPrice: number | null; // original, when published; else null
      onSale: boolean;
      currency: string | null; // "USD" | "CAD"
      rating: number | null;
      reviewCount: number | null;
      composition: string | null; // "100% Cotton\nImported"
      sizes: string[];
      colors: UniqloColor[];
      skus: UniqloSku[];
      inStock: boolean;
      warnings: string[]; // the full-price lookup for a reduced price group failed; empty otherwise
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.uniqlo.getProduct({ productId: "E450260-000", market: "com" });
  • searchProductsSearches Uniqlo's live clothing catalog, the US store (uniqlo.com/us, USD) by default or the Canadian one (uniqlo.com/ca, CAD) with country: "ca", by…

    Arguments

    NameTypeRequired
    argsUniqloSearchArgs | stringYes
    interface UniqloSearchArgs {
      query?: string; // a query, a department, or both
      department?: "men" | "women" | "kids" | "baby"; // department alone lists the whole department
      onSaleOnly?: boolean; // the site's own Sale filter
      limit?: number; // default 24, max 1000; the search walks result pages until it has this many
      market?: "com" | "ca"; // which storefront: "com" (US, default) or "ca" (Canada, CAD prices and Canadian stock)
      country?: "us" | "ca"; // compatibility alias for market: "us" or "ca"
    }

    Returns UniqloSearchResult

    interface UniqloColorRef {
      code: string; // color display code, e.g. "69"
      name: string | null; // "NAVY"
      image: string | null; // this color's product photo
    }
    
    interface UniqloSearchHit {
      productId: string; // pass with priceGroup to getProduct (or pass the hit itself)
      priceGroup: string; // "00" full price, "01"/"02" a reduced price for select colors/sizes
      country: "us" | "ca"; // the store this hit came from; getProduct(hit) reads the same store
      url: string;
      name: string;
      gender: string | null; // "MEN" | "WOMEN" | "UNISEX" | …
      price: number | null; // what it costs now
      regularPrice: number | null; // the original, ONLY when the site publishes one, usually null on a Sale item
      onSale: boolean; // the site marks it Sale
      currency: string | null; // "USD" | "CAD"
      rating: number | null;
      reviewCount: number | null;
      colors: UniqloColorRef[];
      sizes: string[];
      image: string | null;
    }
    
    interface UniqloSearchResult {
      query: string | null;
      department: "men" | "women" | "kids" | "baby" | null;
      onSaleOnly: boolean;
      country: "us" | "ca";
      total: number; // products the site matched
      hasMore: boolean; // true when more matching products exist past `limit`
      hits: UniqloSearchHit[];
      warnings: string[]; // a results page that failed after the first; empty when complete
    }

    HTTP endpoint

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

    Call it

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

Use it from code