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

Just Sun Home Saunas

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/sunhomesaunas
Every site

One 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/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 2
  • 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

    NameTypeRequired
    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/getPersonalizedSaunaMatches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getSaunaFinderQuestions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.sunhomesaunas.getSaunaFinderQuestions();
Act 1
  • 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

    NameTypeRequired
    handlestringYes
    quantitynumberNo

    Returns SunHomeSaunasCartResult

    interface 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/addSaunaToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.sunhomesaunas.addSaunaToCart("<handle>");

Use it from code