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.
- Site
- saltandstone.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/saltandstoneOne 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/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.
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
Name Type Required 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/getScentProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.saltandstone.getScentProducts("Santal & Vetiver");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.saltandstone.getScentProducts("Santal & Vetiver"))curl -X POST https://api.bowmark.ai/v1/sites/saltandstone/getScentProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"familyName":"Santal & Vetiver"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listScentFamiliesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.saltandstone.listScentFamilies();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.saltandstone.listScentFamilies())curl -X POST https://api.bowmark.ai/v1/sites/saltandstone/listScentFamilies \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/matchScentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.saltandstone.matchScent("woodsy warm spicy cedar");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.saltandstone.matchScent("woodsy warm spicy cedar"))curl -X POST https://api.bowmark.ai/v1/sites/saltandstone/matchScent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"preferences":"woodsy warm spicy cedar"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.saltandstone.matchScent("woodsy warm spicy cedar");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/saltandstone/<function> - OpenAPI
/v1/sites/saltandstone/openapi.json