Sun Home Saunas MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Sun Home Saunas: 3 typed functions through one MCP server. No Sun Home Saunas API key needed.
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Sun Home Saunas 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/sunhomesaunasOne MCP server for Sun Home Saunas 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.
getPersonalizedSaunaMatchesApplies real answers to the live Digioh product-weight rules the site's quiz publishes, then returns its weighted product ranking with real current…Arguments
Name Type Required answers{questionId: string, optionIds: string[]}[]Yes Returns
SunHomeSaunasMatch[]interface SunHomeSaunasMatch { handle: string; // the key addSaunaToCart takes title: string; price: number; // dollars, real live Shopify price matchScore: number; // selected answers that positively weighted this product matchOutOf: number; // submitted answer selections }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sunhomesaunas/getPersonalizedSaunaMatchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sunhomesaunas.getPersonalizedSaunaMatches([ { questionId: "ep2", optionIds: ["ep2button3"] }, { questionId: "ep6", optionIds: ["ep6button4"] } ]);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sunhomesaunas.getPersonalizedSaunaMatches([ {"questionId": "ep2", "optionIds": ["ep2button3"]}, {"questionId": "ep6", "optionIds": ["ep6button4"]} ]))curl -X POST https://api.bowmark.ai/v1/sites/sunhomesaunas/getPersonalizedSaunaMatches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"answers":[{"questionId":"ep2","optionIds":["ep2button3"]},{"questionId":"ep6","optionIds":["ep6button4"]}]}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sunhomesaunas.getPersonalizedSaunaMatches([ { questionId: "ep2", optionIds: ["ep2button3"] }, { questionId: "ep6", optionIds: ["ep6button4"] } ]);getSaunaFinderQuestionsReads Sun Home Saunas' real, live Digioh buyer quiz from its public breakpoint configuration.Arguments
None.
Returns
SunHomeSaunasQuizQuestion[]// Sun Home Saunas' OWN shapes, not a capability contract. interface SunHomeSaunasQuizOption { id: string; label: string; } interface SunHomeSaunasQuizQuestion { id: string; // pass back as answers[].questionId title: string; type: string; // the site's own Digioh question type, e.g. "DIGIOH_PRQ" options: SunHomeSaunasQuizOption[]; // option.id -> answers[].optionIds }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sunhomesaunas/getSaunaFinderQuestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sunhomesaunas.getSaunaFinderQuestions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sunhomesaunas.getSaunaFinderQuestions())curl -X POST https://api.bowmark.ai/v1/sites/sunhomesaunas/getSaunaFinderQuestions \ -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.sunhomesaunas.getSaunaFinderQuestions();
addSaunaToCartAdds one real matched product to a real Shopify cart at Sun Home Saunas' own real live price (POST /cart/add.js through a cookie jar), and reads the…Arguments
Name Type Required handlestringYes quantitynumberNo Returns
SunHomeSaunasCartResultinterface SunHomeSaunasCartResult { handle: string; title: string; variantId: number; linePrice: number; // dollars, for the quantity added quantity: number; cartItemCount: number; // the live cart's total items AFTER this add cartTotal: number; // dollars, the live cart's total price after this add checkout: SunHomeSaunasCheckoutHandoff; // a Shopify cart link that carries the item, for the person to open. Bowmark never pays } // The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders. // Switch on `status`; a status you do not recognise means "show the person `url` and stop". interface SunHomeSaunasCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; // the https page to open on the site urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page reason?: string; // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart detail?: string; // unavailable only: one sentence saying why account: { site: string; hint: string; signedInAs?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sunhomesaunas/addSaunaToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sunhomesaunas.addSaunaToCart("<handle>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sunhomesaunas.addSaunaToCart("<handle>"))curl -X POST https://api.bowmark.ai/v1/sites/sunhomesaunas/addSaunaToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"<handle>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sunhomesaunas.addSaunaToCart("<handle>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/sunhomesaunas/<function> - OpenAPI
/v1/sites/sunhomesaunas/openapi.json