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.
- Site
- vessi.com
- 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/vessiEvery 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/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 4
getFitGuideReads Vessi's own computed per-style fit-guide.Arguments
Name Type Required handlestringYes Returns
VessiFitGuide | nullinterface 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/getFitGuideCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.vessi.getFitGuide("womens-weekend-classic-marble-white");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.vessi.getFitGuide("womens-weekend-classic-marble-white"))curl -X POST https://api.bowmark.ai/v1/sites/vessi/getFitGuide \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"womens-weekend-classic-marble-white"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.vessi.getProduct("womens-weekend-classic-marble-white");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.vessi.getProduct("womens-weekend-classic-marble-white"))curl -X POST https://api.bowmark.ai/v1/sites/vessi/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"womens-weekend-classic-marble-white"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.vessi.listProducts("Shoes");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.vessi.listProducts("Shoes"))curl -X POST https://api.bowmark.ai/v1/sites/vessi/listProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"productType":"Shoes"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.vessi.listProducts("Shoes");searchProductsSearches the live catalog by a fuzzy match on product title or handle.Arguments
Name Type Required 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/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.vessi.searchProducts("weekend classic");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.vessi.searchProducts("weekend classic"))curl -X POST https://api.bowmark.ai/v1/sites/vessi/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"weekend classic"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.vessi.searchProducts("weekend classic");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/vessi/<function> - OpenAPI
/v1/sites/vessi/openapi.json