FloatHelm MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on FloatHelm: 8 typed functions through one MCP server. No FloatHelm API key needed.

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

Connect

Just FloatHelm

An MCP server for FloatHelm 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/floathelm
Every site

One MCP server for FloatHelm 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 7
  • findStudioFind a studio/location by name from the available locations.

    Arguments

    NameTypeRequired
    querystringYes

    Returns FloathelmStudio[]

    interface FloathelmStudio {
      /** FloatHelm's own short ?location=<n> code, e.g. 1 for Marina. */
      location: 1 | 2 | 3;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/findStudio

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.findStudio("Marina");
  • getRoomReads one room's own detail popup.

    Arguments

    NameTypeRequired
    roomIdnumberYes

    Returns FloathelmRoomDetail

    interface FloathelmRoom {
      /** FloatHelm's own room_id, what getRoom takes. */
      roomId: number;
      name: string;
    }
    
    interface FloathelmRoomDetail extends FloathelmRoom {
      description: string | null;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/getRoom

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.getRoom(1205727);
  • listAvailableSlotsLists every slot (open or reserved) on the booking calendar for one day, optionally narrowed to one room/service's room_id from listRooms.

    Arguments

    NameTypeRequired
    date.yearnumberYes
    date.monthnumber
    1-12, calendar convention, NOT a JS Date 0-11 month.
    Yes
    date.daynumberYes
    roomIdnumberNo

    Returns FloathelmSlot[]

    interface FloathelmSlot {
      roomId: number;
      /** FloatHelm's own event id, what bookAppointment will need. */
      eventId: string;
      /** Local wall-clock start time, 24-hour "HH:MM". */
      time: string;
      available: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/listAvailableSlots

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.listAvailableSlots({ year: 2026, month: 12, day: 15 });
  • listGiftCardsLists every gift-card denomination and prepaid-service card the gift-card store sells.

    Arguments

    None.

    Returns FloathelmGiftCard[]

    interface FloathelmGiftCard {
      optionId: number;
      title: string;
      price: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/listGiftCards

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.listGiftCards();
  • listLocationsList all available studio locations.

    Arguments

    None.

    Returns FloathelmStudio[]

    interface FloathelmStudio {
      /** FloatHelm's own short ?location=<n> code, e.g. 1 for Marina. */
      location: 1 | 2 | 3;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/listLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.listLocations();
  • listRoomsLists the rooms/services the booking calendar offers (sauna, compression boots, T-Shock), each with the room_id getRoom takes.

    Arguments

    None.

    Returns FloathelmRoom[]

    interface FloathelmRoom {
      /** FloatHelm's own room_id, what getRoom takes. */
      roomId: number;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/listRooms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.listRooms();
  • listStoreItemsLists every membership, multi-session package and single service the online store sells at one location (findStudio/listLocations' location code)…

    Arguments

    NameTypeRequired
    location1 | 2 | 3No

    Returns FloathelmStoreItem[]

    interface FloathelmStoreItem {
      itemId: number;
      itemType: "membership" | "package" | "service";
      name: string;
      price: number;
      description: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/listStoreItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.listStoreItems();
Act 1
  • createAccountCreates a new FloatHelm account for the caller.

    Arguments

    NameTypeRequired
    firstNamestringYes
    lastNamestringYes
    emailstringYes
    phoneNumberstringYes
    passwordstringYes

    Returns FloathelmAccountCreated

    interface FloathelmAccountCreated {
      created: true;
      email: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/floathelm/createAccount

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.floathelm.createAccount({
      firstName: "<firstName>",
      lastName: "<lastName>",
      email: "<email>",
      phoneNumber: "<phoneNumber>",
      password: "<password>"
    });

Use it from code