SoulCycle MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on SoulCycle: 23 typed functions through one MCP server. No SoulCycle API key needed.
- Site
- soul-cycle.com
- Functions
- 23
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for SoulCycle 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/soulcycleOne MCP server for SoulCycle 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 that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
findStudioFinds a studio from what a caller holds.Arguments
Name Type Required querystringA studio name ("Union Street"), its page URL, or its slug.Yes Returns
{ studios: SoulcycleStudio[] }interface SoulcycleStudio { id: number; // the studio id the schedule functions take title: string; slug: string; // e.g. "ca-sanfrancisco-castro" url: string; shortName?: string; regionTitle?: string; address?: string; phone?: string; lat?: number; lon?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/findStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.findStudio({ query: "Castro" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.findStudio({"query": "Castro"}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/findStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Castro"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.findStudio({ query: "Castro" });getBikeMapReturns a class's room map: every bike (seat) id and whether it is taken.Arguments
Name Type Required classIdnumberFrom getStudioSchedule() or getStudio().Yes Returns
{ seats: SoulcycleBikeMapSeat[] }interface SoulcycleBikeMapSeat { seatId: number; // the id bookBike takes taken: boolean; position?: unknown; // the seat's floor position, UNMEASURED, site shape not yet captured signed in }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/getBikeMapCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.getBikeMap({ classId: 2421671 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.getBikeMap({"classId": 2421671}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/getBikeMap \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"classId":2421671}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.getBikeMap({ classId: 2421671 });getClassAvailabilityReturns how many bikes are booked in a class and which bike (seat) ids are taken.Arguments
Name Type Required classIdnumberFrom getStudioSchedule().Yes Returns
{ availability: SoulcycleClassAvailability }interface SoulcycleClassAvailability { classId: number; bookedCount: number; takenSeatIds: number[]; // the full seat layout is signed-in only (getBikeMap) }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/getClassAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.getClassAvailability({ classId: 2421671 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.getClassAvailability({"classId": 2421671}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/getClassAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"classId":2421671}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.getClassAvailability({ classId: 2421671 });getInstructorReturns one instructor's profile: full bio, Q&A (music, energy, workout style), photos, playlist tracks and their upcoming classes with studio and…Arguments
Name Type Required instructorIdnumberYes Returns
{ instructor: SoulcycleInstructor }interface SoulcycleInstructorSummary { id: number; // the id getInstructor takes; getStudioSchedule's instructor.id name: string; bioShort?: string; imageUrl?: string; spotifyPlaylistUrl?: string; questions: { question: string; answer: string }[]; } interface SoulcycleInstructor extends SoulcycleInstructorSummary { bioFull?: string; heroImageUrl?: string; music: { artist: string; track: string; url?: string }[]; classes: { classId: number; startTime: string; // ISO 8601 with the studio's offset classType: string; durationMinutes?: number; seatsAvailable?: number; capacity?: number; isOpen?: boolean; studio: { title: string; address?: string; timezone?: string }; }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/getInstructorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.getInstructor({ instructorId: 10693 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.getInstructor({"instructorId": 10693}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/getInstructor \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"instructorId":10693}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.getInstructor({ instructorId: 10693 });getMyCreditsReturns the signed-in rider's usable class credits.Arguments
None.
Returns
{ credits: SoulcycleCredits }interface SoulcycleCredits { usableCredits: number; // what bookBike spends }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/getMyCreditsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.getMyCredits();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.getMyCredits())curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/getMyCredits \ -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.soulcycle.getMyCredits();getStudioReturns one studio's page: address, phone, email, coordinates, photos, its next 10 classes (class id, start time, class type, instructor) and its…Arguments
Name Type Required slugstringE.g. "ca-sanfrancisco-castro", or the studio page URL.Yes Returns
{ studio: SoulcycleStudioDetail }interface SoulcycleStudioDetail { id: number; title: string; slug: string; url: string; regionTitle?: string; address?: string; phone?: string; email?: string; lat?: number; lon?: number; imageUrls: string[]; upcomingClasses: { classId: number; // the id getClassAvailability and bookBike take startTime: string; // local studio time, "YYYY-MM-DD HH:MM:SS" classType: string; instructor: { id: number; name: string }; }[]; instructors: { id: number; name: string; imageUrl?: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/getStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.getStudio({ slug: "ca-sanfrancisco-castro" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.getStudio({"slug": "ca-sanfrancisco-castro"}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/getStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"ca-sanfrancisco-castro"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.getStudio({ slug: "ca-sanfrancisco-castro" });getStudioScheduleLists a studio's classes for the week containing a date: class id, start time, class type, instructor (id and name), and state.Arguments
Name Type Required studioIdnumberFrom listStudios() or findStudio().Yes datestring"YYYY-MM-DD" within the target week; omit for the current week.No Returns
{ sessions: SoulcycleClassSession[] }interface SoulcycleClassSession { classId: number; // the id bookBike, joinWaitlist and getClassAvailability take startTime: string; // local time at the studio, "YYYY-MM-DD HH:MM:SS", no published timezone classType: string; instructor: { id: number; name: string }; state: string; // "open" | "expired" | "full" | "supersoul open" (SuperSoul-only booking window), verbatim checkout?: SoulcycleCheckout | null; } interface SoulcycleCheckout { status: "ready_to_checkout" | "needs_login" | "unavailable"; /** Always https, on the studio's own site. */ url: string; /** ready_to_checkout only: carries_items opens this very slot, product_page opens the studio's schedule. */ urlKind?: "carries_items" | "signed_in_cart" | "product_page"; /** unavailable only: out_of_stock (class full, no waitlist) or not_available_for_dates (cancelled). */ reason?: string; detail?: string; account: { site: string; hint: string; signedInAs?: string; signInUrl?: 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; /** ISO start/end of the class or slot, with the studio's UTC offset when the site gives one. */ dates?: { start: string; end?: string }; } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/getStudioScheduleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.getStudioSchedule({ studioId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.getStudioSchedule({"studioId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/getStudioSchedule \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"studioId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.getStudioSchedule({ studioId: 1 });listClassHistoryLists the signed-in rider's past classes.Arguments
None.
Returns
{ classes: SoulcycleBooking[] }interface SoulcycleBooking { reservationId?: string; // the id cancelBooking takes, when the page carried one classId: number; startTime: string; // local studio time, "YYYY-MM-DD HH:MM:SS" classType: string; studioTitle?: string; instructor: { id: number; name: string }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listClassHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listClassHistory();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listClassHistory())curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listClassHistory \ -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.soulcycle.listClassHistory();listInstructorsLists the instructors teaching in a region: id, name, short bio, photo, Spotify playlist and their Q&A answers.Arguments
Name Type Required regionIdnumberFrom listRegions().Yes Returns
{ instructors: SoulcycleInstructorSummary[] }interface SoulcycleInstructorSummary { id: number; // the id getInstructor takes; getStudioSchedule's instructor.id name: string; bioShort?: string; imageUrl?: string; spotifyPlaylistUrl?: string; questions: { question: string; answer: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listInstructorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listInstructors({ regionId: 27 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listInstructors({"regionId": 27}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listInstructors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"regionId":27}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.listInstructors({ regionId: 27 });listMyBookingsLists the signed-in rider's upcoming booked classes with studio, time, instructor, bike number and the reservation id cancelBooking takes.Arguments
None.
Returns
{ bookings: SoulcycleBooking[] }interface SoulcycleBooking { reservationId?: string; // the id cancelBooking takes, when the page carried one classId: number; startTime: string; // local studio time, "YYYY-MM-DD HH:MM:SS" classType: string; studioTitle?: string; instructor: { id: number; name: string }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listMyBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listMyBookings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listMyBookings())curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listMyBookings \ -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.soulcycle.listMyBookings();listMyBookmarksLists the classes the signed-in rider has bookmarked (to book once they open).Arguments
None.
Returns
{ classes: SoulcycleBooking[] }interface SoulcycleBooking { reservationId?: string; // the id cancelBooking takes, when the page carried one classId: number; startTime: string; // local studio time, "YYYY-MM-DD HH:MM:SS" classType: string; studioTitle?: string; instructor: { id: number; name: string }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listMyBookmarksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listMyBookmarks();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listMyBookmarks())curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listMyBookmarks \ -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.soulcycle.listMyBookmarks();listRegionsLists SoulCycle's regions (NYC, San Francisco, Bay Area, London …) with the studios in each: region id, studio ids and titles, and each studio's…Arguments
None.
Returns
{ regions: SoulcycleRegion[] }interface SoulcycleRegion { id: number; // the region id listStudios takes, e.g. 27 = San Francisco title: string; country: string; studios: { id: number; title: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listRegionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listRegions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listRegions())curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listRegions \ -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.soulcycle.listRegions();listSeriesLists what a region sells and at what price: class packs (new-rider, starter, standard, student, SuperSoul) and Soul Renew memberships, each with…Arguments
Name Type Required regionIdnumberFrom listRegions(), e.g. 27 = San Francisco.Yes Returns
{ series: SoulcycleSeries[] }interface SoulcycleSeries { productId: number; seriesId: string; // the site's series code; several pack sizes share one kind: "pack" | "membership"; // membership = Soul Renew, a recurring payment category: string; // "Starter Packs", "Standard Packs", "Super Soul", "Student Packs", "Soul Renew" name: string; classes: number; price: string; // as shown, e.g. "$1,020" priceAmount: number; currency: string; expires?: string; // verbatim, e.g. "Expires in 30 days" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listSeriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listSeries({ regionId: 27 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listSeries({"regionId": 27}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listSeries \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"regionId":27}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.listSeries({ regionId: 27 });listShopProductsLists the SoulCycle merch store's products (apparel, accessories) with price, variants and image.Arguments
Name Type Required limitnumber1-250, default 50.No pagenumber1-based.No Returns
{ products: SoulcycleShopProduct[] }interface SoulcycleShopProduct { id: number; title: string; handle: string; url: string; productType?: string; vendor?: string; tags: string[]; description?: string; imageUrl?: string; priceMin: number; // USD priceMax: number; available: boolean; variants: { id: number; title: string; price: number; available: boolean; sku?: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listShopProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listShopProducts({ limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listShopProducts({"limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listShopProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.listShopProducts({ limit: 5 });listStudiosLists the studios in a region (or all regions) with address, phone, coordinates and studio page URL.Arguments
Name Type Required regionIdnumberFrom listRegions(); omit for every region.No Returns
{ studios: SoulcycleStudio[] }interface SoulcycleStudio { id: number; // the studio id the schedule functions take title: string; slug: string; // e.g. "ca-sanfrancisco-castro" url: string; shortName?: string; regionTitle?: string; address?: string; phone?: string; lat?: number; lon?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/listStudiosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.listStudios({ regionId: 27 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.listStudios({"regionId": 27}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/listStudios \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"regionId":27}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.listStudios({ regionId: 27 });
bookBikeBooks a bike in a class for the signed-in rider, spending one class credit.Arguments
Name Type Required classIdnumberFrom getStudioSchedule().Yes seatIdnumberA free seat from getBikeMap().Yes Returns
SoulcycleBookBikeResultinterface SoulcycleBookBikeResult { booked: boolean; code: string; // the site's reply code, "booked" | "success" message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/bookBikeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.bookBike({ classId: 1, seatId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.bookBike({"classId": 1, "seatId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/bookBike \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"classId":1,"seatId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.bookBike({ classId: 1, seatId: 1 });cancelBookingCancels one of the signed-in rider's bookings.Arguments
Name Type Required reservationIdstringFrom listMyBookings().Yes acceptLateCancelbooleanAfter 5pm the day before, the only cancel forfeits the credit; refused unless true.No Returns
SoulcycleCancelResultinterface SoulcycleActionResult { ok: boolean; message?: string; } interface SoulcycleCancelResult extends SoulcycleActionResult { late: boolean; // true = the credit-forfeiting late cancel }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/cancelBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.cancelBooking({ reservationId: "<reservationId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.cancelBooking({"reservationId": "<reservationId>"}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/cancelBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"reservationId":"<reservationId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.cancelBooking({ reservationId: "<reservationId>" });joinWaitlistJoins the waitlist for a full class.Arguments
Name Type Required classIdnumberA full class from getStudioSchedule().Yes Returns
SoulcycleActionResultinterface SoulcycleActionResult { ok: boolean; message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/joinWaitlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.joinWaitlist({ classId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.joinWaitlist({"classId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/joinWaitlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"classId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.joinWaitlist({ classId: 1 });redeemReferralCreditsRedeems the free classes the signed-in rider earned by referring friends (Spread the Soul).Arguments
None.
Returns
SoulcycleActionResultinterface SoulcycleActionResult { ok: boolean; message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/redeemReferralCreditsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.redeemReferralCredits();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.redeemReferralCredits())curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/redeemReferralCredits \ -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.soulcycle.redeemReferralCredits();setFavoriteInstructorAdds or removes an instructor from the signed-in rider's favorites.Arguments
Name Type Required instructorIdnumberFrom listInstructors() or getInstructor().Yes enabledbooleanYes Returns
SoulcycleActionResultinterface SoulcycleActionResult { ok: boolean; message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/setFavoriteInstructorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.setFavoriteInstructor({ instructorId: 1, enabled: true });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.setFavoriteInstructor({"instructorId": 1, "enabled": True}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/setFavoriteInstructor \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"instructorId":1,"enabled":true}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.setFavoriteInstructor({ instructorId: 1, enabled: true });setFavoriteStudioAdds or removes a studio from the signed-in rider's favorites.Arguments
Name Type Required studioIdnumberFrom listStudios() or findStudio().Yes enabledbooleanYes Returns
SoulcycleActionResultinterface SoulcycleActionResult { ok: boolean; message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/setFavoriteStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.setFavoriteStudio({ studioId: 1, enabled: true });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.setFavoriteStudio({"studioId": 1, "enabled": True}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/setFavoriteStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"studioId":1,"enabled":true}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.setFavoriteStudio({ studioId: 1, enabled: true });setSeriesTransferTurns on or off letting the signed-in rider's series be used in another region.Arguments
Name Type Required enabledbooleanYes Returns
SoulcycleSeriesTransferResultinterface SoulcycleSeriesTransferResult { enabled: boolean; // the state SoulCycle reports after the call message?: string; transferableCredits?: number; transferableRegions?: string; usableCredits?: number; region?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/setSeriesTransferCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.setSeriesTransfer({ enabled: true });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.setSeriesTransfer({"enabled": True}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/setSeriesTransfer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"enabled":true}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.setSeriesTransfer({ enabled: true });updatePreferencesSaves the signed-in rider's Preferences tab: favorite instructors and studios, primary studio, and the ride-reward-on-renewal switch.Arguments
Name Type Required addInstructorIdsnumber[]No removeInstructorIdsnumber[]No addFavoriteStudioIdsnumber[]No removeFavoriteStudioIdsnumber[]No primaryStudioIdnumber | nullNo applyRideRewardOnRenewalbooleanNo Returns
SoulcycleActionResultinterface SoulcycleActionResult { ok: boolean; message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soulcycle/updatePreferencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soulcycle.updatePreferences({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soulcycle.updatePreferences({}))curl -X POST https://api.bowmark.ai/v1/sites/soulcycle/updatePreferences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soulcycle.updatePreferences({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/soulcycle/<function> - OpenAPI
/v1/sites/soulcycle/openapi.json