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
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/floathelmOne MCP server for FloatHelm 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.
findStudioFind a studio/location by name from the available locations.Arguments
Name Type Required 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/findStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.findStudio("Marina");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.findStudio("Marina"))curl -X POST https://api.bowmark.ai/v1/sites/floathelm/findStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"Marina"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.floathelm.findStudio("Marina");getRoomReads one room's own detail popup.Arguments
Name Type Required roomIdnumberYes Returns
FloathelmRoomDetailinterface 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/getRoomCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.getRoom(1205727);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.getRoom(1205727))curl -X POST https://api.bowmark.ai/v1/sites/floathelm/getRoom \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"roomId":1205727}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required date.yearnumberYes date.monthnumber1-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/listAvailableSlotsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.listAvailableSlots({ year: 2026, month: 12, day: 15 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.listAvailableSlots({"year": 2026, "month": 12, "day": 15}))curl -X POST https://api.bowmark.ai/v1/sites/floathelm/listAvailableSlots \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"date":{"year":2026,"month":12,"day":15}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listGiftCardsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.listGiftCards();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.listGiftCards())curl -X POST https://api.bowmark.ai/v1/sites/floathelm/listGiftCards \ -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.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/listLocationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.listLocations();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.listLocations())curl -X POST https://api.bowmark.ai/v1/sites/floathelm/listLocations \ -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.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/listRoomsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.listRooms();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.listRooms())curl -X POST https://api.bowmark.ai/v1/sites/floathelm/listRooms \ -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.floathelm.listRooms();listStoreItemsLists every membership, multi-session package and single service the online store sells at one location (findStudio/listLocations' location code)…Arguments
Name Type Required 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/listStoreItemsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.listStoreItems();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.listStoreItems())curl -X POST https://api.bowmark.ai/v1/sites/floathelm/listStoreItems \ -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.floathelm.listStoreItems();
createAccountCreates a new FloatHelm account for the caller.Arguments
Name Type Required firstNamestringYes lastNamestringYes emailstringYes phoneNumberstringYes passwordstringYes Returns
FloathelmAccountCreatedinterface FloathelmAccountCreated { created: true; email: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/floathelm/createAccountCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.floathelm.createAccount({ firstName: "<firstName>", lastName: "<lastName>", email: "<email>", phoneNumber: "<phoneNumber>", password: "<password>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.floathelm.createAccount({ "firstName": "<firstName>", "lastName": "<lastName>", "email": "<email>", "phoneNumber": "<phoneNumber>", "password": "<password>" }))curl -X POST https://api.bowmark.ai/v1/sites/floathelm/createAccount \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"account":{"firstName":"<firstName>","lastName":"<lastName>","email":"<email>","phoneNumber":"<phoneNumber>","password":"<password>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.floathelm.createAccount({ firstName: "<firstName>", lastName: "<lastName>", email: "<email>", phoneNumber: "<phoneNumber>", password: "<password>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/floathelm/<function> - OpenAPI
/v1/sites/floathelm/openapi.json