Salt & Stone MCP server for AI agents

Let Claude, ChatGPT or your own agent read Salt & Stone: 3 typed functions through one MCP server. No Salt & Stone API key needed.

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

Connect

Just Salt & Stone

An MCP server for Salt & Stone 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/saltandstone
Every site

One MCP server for Salt & Stone 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 3
  • getScentProductsLists the real core products (body wash, body mist, body lotion, deodorant, hand cream, candle) available in one named scent family, with each one's…

    Arguments

    NameTypeRequired
    familyNamestringYes

    Returns ScentProduct[]

    interface ScentProduct {
      handle: string;           // "body-wash" | "body-mist" | "body-lotion" | "natural-deodorant" | "hand-cream" | "candle"
      title: string;
      productType: string;
      variantId: string;
      variantTitle: string;
      price: number;            // dollars, real Shopify variant price
      compareAtPrice: number | null;
      available: boolean;       // real live stock flag
      url: string;              // real product page, this exact variant preselected
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/saltandstone/getScentProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.saltandstone.getScentProducts("Santal & Vetiver");
  • listScentFamiliesLists Salt & Stone's real six named scent families (Santal & Vetiver, Bergamot & Hinoki, Saffron & Cedar, Neroli & Basil, Black Rose & Oud, Lily &…

    Arguments

    None.

    Returns ScentFamily[]

    // Salt & Stone's OWN shapes, not a capability contract.
    interface ScentFamily {
      handle: string;
      name: string;             // e.g. "Santal & Vetiver"
      description: string;      // the site's own mood copy
      notes: { top: string[]; heart: string[]; base: string[] }; // real fragrance notes
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/saltandstone/listScentFamilies

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.saltandstone.listScentFamilies();
  • matchScentSalt & Stone's own Scent Quiz, reimplemented: given a free-text scent preference, computes a real ranked match across all six scent families by…

    Arguments

    NameTypeRequired
    preferencesstringYes

    Returns ScentMatch[]

    interface ScentMatch {
      handle: string;
      name: string;
      score: number;            // 0-1, how much of the caller's preference matched this family's real notes/copy
      matchedTerms: string[];   // which of the caller's own words matched, and why
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/saltandstone/matchScent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.saltandstone.matchScent("woodsy warm spicy cedar");

Use it from code