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.

Functions
23
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just SoulCycle

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

One MCP server for SoulCycle 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 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.

Read 15
  • findStudioFinds a studio from what a caller holds.

    Arguments

    NameTypeRequired
    querystring
    A 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/findStudio

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.findStudio({ query: "Castro" });
  • getBikeMapReturns a class's room map: every bike (seat) id and whether it is taken.

    Arguments

    NameTypeRequired
    classIdnumber
    From 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/getBikeMap

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.getBikeMap({ classId: 2421671 });
  • getClassAvailabilityReturns how many bikes are booked in a class and which bike (seat) ids are taken.

    Arguments

    NameTypeRequired
    classIdnumber
    From 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/getClassAvailability

    Call it

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

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

    Call it

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

    Call it

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

    NameTypeRequired
    slugstring
    E.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/getStudio

    Call it

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

    NameTypeRequired
    studioIdnumber
    From 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/getStudioSchedule

    Call it

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

    Call it

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

    NameTypeRequired
    regionIdnumber
    From 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/listInstructors

    Call it

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

    Call it

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

    Call it

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

    Call it

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

    NameTypeRequired
    regionIdnumber
    From 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/listSeries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.listSeries({ regionId: 27 });
  • listShopProductsLists the SoulCycle merch store's products (apparel, accessories) with price, variants and image.

    Arguments

    NameTypeRequired
    limitnumber
    1-250, default 50.
    No
    pagenumber
    1-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/listShopProducts

    Call it

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

    NameTypeRequired
    regionIdnumber
    From 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/listStudios

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.listStudios({ regionId: 27 });
Act 8
  • bookBikeBooks a bike in a class for the signed-in rider, spending one class credit.

    Arguments

    NameTypeRequired
    classIdnumber
    From getStudioSchedule().
    Yes
    seatIdnumber
    A free seat from getBikeMap().
    Yes

    Returns SoulcycleBookBikeResult

    interface SoulcycleBookBikeResult {
      booked: boolean;
      code: string; // the site's reply code, "booked" | "success"
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/soulcycle/bookBike

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.bookBike({ classId: 1, seatId: 1 });
  • cancelBookingCancels one of the signed-in rider's bookings.

    Arguments

    NameTypeRequired
    reservationIdstring
    From listMyBookings().
    Yes
    acceptLateCancelboolean
    After 5pm the day before, the only cancel forfeits the credit; refused unless true.
    No

    Returns SoulcycleCancelResult

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.cancelBooking({ reservationId: "<reservationId>" });
  • joinWaitlistJoins the waitlist for a full class.

    Arguments

    NameTypeRequired
    classIdnumber
    A full class from getStudioSchedule().
    Yes

    Returns SoulcycleActionResult

    interface SoulcycleActionResult {
      ok: boolean;
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/soulcycle/joinWaitlist

    Call it

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

    interface SoulcycleActionResult {
      ok: boolean;
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/soulcycle/redeemReferralCredits

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.redeemReferralCredits();
  • setFavoriteInstructorAdds or removes an instructor from the signed-in rider's favorites.

    Arguments

    NameTypeRequired
    instructorIdnumber
    From listInstructors() or getInstructor().
    Yes
    enabledbooleanYes

    Returns SoulcycleActionResult

    interface SoulcycleActionResult {
      ok: boolean;
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/soulcycle/setFavoriteInstructor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.setFavoriteInstructor({ instructorId: 1, enabled: true });
  • setFavoriteStudioAdds or removes a studio from the signed-in rider's favorites.

    Arguments

    NameTypeRequired
    studioIdnumber
    From listStudios() or findStudio().
    Yes
    enabledbooleanYes

    Returns SoulcycleActionResult

    interface SoulcycleActionResult {
      ok: boolean;
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/soulcycle/setFavoriteStudio

    Call it

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

    NameTypeRequired
    enabledbooleanYes

    Returns SoulcycleSeriesTransferResult

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

    Call it

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

    NameTypeRequired
    addInstructorIdsnumber[]No
    removeInstructorIdsnumber[]No
    addFavoriteStudioIdsnumber[]No
    removeFavoriteStudioIdsnumber[]No
    primaryStudioIdnumber | nullNo
    applyRideRewardOnRenewalbooleanNo

    Returns SoulcycleActionResult

    interface SoulcycleActionResult {
      ok: boolean;
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/soulcycle/updatePreferences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soulcycle.updatePreferences({});

Use it from code