Vessi MCP server for AI agents

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

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

Connect

Just Vessi

An MCP server for Vessi 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/vessi
Every site

One MCP server for Vessi 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 4
  • getFitGuideReads Vessi's own computed per-style fit-guide.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns VessiFitGuide | null

    interface VessiFitGuide {
      productHandle: string;
      colorwayName: string;
      styleDirection: string;         // e.g. "snug"
      introCopy: string;              // the site's own plain-language fit summary
      chips: string[];                // e.g. ["whole_sizes_only", "Slightly snug"]
      sizeChart: { gender: string; headers: string[]; rows: string[][] };
      // keyed by foot profile, e.g. "standard" | "wide" | "narrow" | "between"
      recommendations: Record<string, { offsetSizes: number; reason: string }>;
      returnData: {
        snugPct: number;
        loosePct: number;
        otherPct: number;
        ratioLabel: string;    // e.g. "2.2 to 1"
        window: string;        // e.g. "H1 2026 · current (gendered) SKUs"
        returnedUnits: number; // e.g. 4826
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vessi/getFitGuide

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vessi.getFitGuide("womens-weekend-classic-marble-white");
  • getProductReads one product's complete colorway x size grid with live price, SKU and availability.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns VessiProduct

    // Vessi's OWN shapes, not a capability contract.
    interface VessiVariant {
      productHandle: string;
      productTitle: string;
      colorway: string;
      size: string;
      sku: string;
      price: number;
      priceFormatted: string;
      available: boolean;
    }
    
    interface VessiProduct {
      handle: string;
      title: string;
      productType: string;   // "Shoes" | "Bags" | "Socks" | "Gloves" | "Hats" | "Clothing"
      url: string;
      colorways: string[];
      sizes: string[];
      priceRange: { min: number; max: number };
      variants: VessiVariant[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vessi.getProduct("womens-weekend-classic-marble-white");
  • listProductsLists every Vessi product from the storefront's own live catalog, optionally narrowed to one product type (Shoes, Bags, Socks, Gloves, Hats…

    Arguments

    NameTypeRequired
    productTypestringNo

    Returns VessiProduct[]

    // Vessi's OWN shapes, not a capability contract.
    interface VessiVariant {
      productHandle: string;
      productTitle: string;
      colorway: string;
      size: string;
      sku: string;
      price: number;
      priceFormatted: string;
      available: boolean;
    }
    
    interface VessiProduct {
      handle: string;
      title: string;
      productType: string;   // "Shoes" | "Bags" | "Socks" | "Gloves" | "Hats" | "Clothing"
      url: string;
      colorways: string[];
      sizes: string[];
      priceRange: { min: number; max: number };
      variants: VessiVariant[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vessi/listProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vessi.listProducts("Shoes");
  • searchProductsSearches the live catalog by a fuzzy match on product title or handle.

    Arguments

    NameTypeRequired
    querystringYes

    Returns VessiProduct[]

    // Vessi's OWN shapes, not a capability contract.
    interface VessiVariant {
      productHandle: string;
      productTitle: string;
      colorway: string;
      size: string;
      sku: string;
      price: number;
      priceFormatted: string;
      available: boolean;
    }
    
    interface VessiProduct {
      handle: string;
      title: string;
      productType: string;   // "Shoes" | "Bags" | "Socks" | "Gloves" | "Hats" | "Clothing"
      url: string;
      colorways: string[];
      sizes: string[];
      priceRange: { min: number; max: number };
      variants: VessiVariant[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vessi.searchProducts("weekend classic");

Use it from code