ClubReady MCP server for AI agents

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

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

Connect

Just ClubReady

An MCP server for ClubReady 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/clubready
Every site

One MCP server for ClubReady 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 18
  • favoriteInstructorAdds an instructor from listInstructors to the signed-in member's favourites, or removes them with favorite: false.

    Arguments

    NameTypeRequired
    args{ studio: string, instructorId: string, favorite?: boolean }Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/favoriteInstructor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.favoriteInstructor({});
  • findStudiosFinds a brand's studios near a place.

    Arguments

    NameTypeRequired
    args{ brand: string, lat?: number, lng?: number, place?: string, host?: string, limit?: number }Yes

    Returns ClubreadyStudio[]

    interface ClubreadyStudio {
      id: string;
      name: string;
      address: string;
      city: string;
      state: string;
      zip: string;
      phone: string;
      email: string;
      timezone: string;
      lat: number;
      lng: number;
      openStatus: string;
      siteUrl: string;
      distanceMiles: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/findStudios

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.findStudios({
      brand: "cyclebar",
      lat: 37.8719,
      lng: -122.2722,
      limit: 5
    });
  • getClassReturns one scheduled class by id from listClasses ("piq_20416972") at a studio: title, description, times, instructor, capacity, free spots…

    Arguments

    NameTypeRequired
    args{ studio: string, classId: string }Yes

    Returns ClubreadyClass

    interface ClubreadyClass {
      id: string;
      studio: string;
      title: string;
      subtitle: string | null;
      description: string | null;
      category: string | null;
      startsAt: string;
      endsAt: string;
      instructor: { id: string; name: string } | null;
      capacity: number;
      freeSpots: number;
      hasWaitlist: boolean;
      waitlistSize: number;
      bookingOpensAt: string | null;
      bookingClosesAt: string | null;
      freeCancelUntil: string | null;
      bookingUrl: string;
    
      checkout: ClubreadyCheckout | null;
    }
    
    interface ClubreadyCheckout {
      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/clubready/getClass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.getClass({});
  • getClassPointsReturns the signed-in member's ClassPoints rewards dashboard.

    Arguments

    NameTypeRequired
    studiostringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/getClassPoints

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.getClassPoints("cyclebar-berkeley");
  • getMyMembershipReturns the signed-in caller's membership and class-credit summary at one studio of their own brand (a studio id from findStudios).

    Arguments

    NameTypeRequired
    studiostringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/getMyMembership

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.getMyMembership("cyclebar-berkeley");
  • getMyProfileReturns the signed-in caller's own profile.

    Arguments

    NameTypeRequired
    studiostringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/getMyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.getMyProfile("cyclebar-berkeley");
  • getStudioReturns one studio by its API id ("cyclebar-berkeley") or by its brand-site page URL ("https://www.cyclebar.com/location/berkeley"): address, phone…

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ClubreadyStudioDetail

    interface ClubreadyStudioDetail {
      id: string;
      name: string;
      address: string;
      address2: string | null;
      city: string;
      state: string;
      zip: string;
      country: string;
      phone: string;
      email: string;
      timezone: string;
      lat: number;
      lng: number;
      openStatus: string;
      siteUrl: string;
      waiverUrl: string;
      clubreadyId: string;
      hours: Record<string, [string, string][]> | null;
      whatToBring: string | null;
      parkingInfo: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/getStudio

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.getStudio("cyclebar-berkeley");
  • getWorkoutStatsReturns the signed-in caller's own workout/performance stats at their brand (CycleBar ride stats and similar, where the brand records them).

    Arguments

    NameTypeRequired
    studiostringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/getWorkoutStats

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.getWorkoutStats("cyclebar-berkeley");
  • listBrandsLists every studio brand on the Xponential/ClubReady member platform.

    Arguments

    NameTypeRequired
    hoststringNo

    Returns ClubreadyBrand[]

    interface ClubreadyBrand {
      id: string;
      name: string;
      slug: string;
      host: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listBrands

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listBrands();
  • listClassCategoriesLists a brand's class categories used to filter a schedule (Xpress, Classic, Performance, …) with a summary of each.

    Arguments

    NameTypeRequired
    brandstringYes

    Returns ClubreadyClassCategory[]

    interface ClubreadyClassCategory {
      id: string;
      name: string;
      summary: string | null;
      description: string | null;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listClassCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listClassCategories("cyclebar");
  • listClassesLists a studio's class schedule for a date or date range.

    Arguments

    NameTypeRequired
    args{ studio: string, from?: string, to?: string }Yes

    Returns ClubreadyClass[]

    interface ClubreadyClass {
      id: string;
      studio: string;
      title: string;
      subtitle: string | null;
      description: string | null;
      category: string | null;
      startsAt: string;
      endsAt: string;
      instructor: { id: string; name: string } | null;
      capacity: number;
      freeSpots: number;
      hasWaitlist: boolean;
      waitlistSize: number;
      bookingOpensAt: string | null;
      bookingClosesAt: string | null;
      freeCancelUntil: string | null;
      bookingUrl: string;
    
      checkout: ClubreadyCheckout | null;
    }
    
    interface ClubreadyCheckout {
      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/clubready/listClasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listClasses({ studio: "cyclebar-berkeley" });
  • listClassTypesLists every class type a brand runs (CycleBar Classic, Performance, Endurance, …) with its description and category; types the brand marks "DO NOT…

    Arguments

    NameTypeRequired
    brandstringYes

    Returns ClubreadyClassType[]

    interface ClubreadyClassType {
      id: string;
      name: string;
      description: string | null;
      category: string | null;
      categoryId: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listClassTypes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listClassTypes("cyclebar");
  • listInstructorsLists the instructors teaching at a studio over a date window (default the next 14 days), with each one's id, name, bio, headshot and class count.

    Arguments

    NameTypeRequired
    args{ studio: string, from?: string, to?: string }Yes

    Returns ClubreadyInstructor[]

    interface ClubreadyInstructor {
      id: string;
      name: string;
      bio: string | null;
      headshotUrl: string | null;
      classCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listInstructors

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listInstructors({ studio: "cyclebar-berkeley" });
  • listInvoicesLists the signed-in member's past purchases and invoices.

    Arguments

    NameTypeRequired
    studiostringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listInvoices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listInvoices("cyclebar-berkeley");
  • listMyBookingsLists the signed-in caller's upcoming and past class bookings and waitlist spots, across their brand's studios.

    Arguments

    NameTypeRequired
    studiostringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listMyBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listMyBookings("cyclebar-berkeley");
  • listPricingLists what a studio sells, drop-in classes, class packs and memberships, with each one's price, credit count, whether it is a membership or…

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ClubreadyPackage[]

    interface ClubreadyPackage {
      id: string;
      name: string;
      type: string;
      creditCount: number;
      isMembership: boolean;
      isRecurring: boolean;
      isUnlimited: boolean;
      price: { formatted: string; numeric: number; currency: string };
      category: string | null;
      description: string | null;
      contractUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listPricing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listPricing("cyclebar-berkeley");
  • listServiceAvailabilityLists who can take a one-on-one session at a studio on a date.

    Arguments

    NameTypeRequired
    args{ studio: string, serviceType: string, date: string }Yes

    Returns ClubreadyServiceSlot[]

    interface ClubreadyServiceSlot {
      instructor: { id: string; name: string } | null;
      startsAt: string;
      endsAt: string;
      durationId: string;
      durationMinutes: number;
      bookingOpensAt: string | null;
      bookingClosesAt: string | null;
      freeCancelUntil: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listServiceAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listServiceAvailability({});
  • listServiceTypesLists the one-on-one session types a studio sells.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ClubreadyServiceType[]

    interface ClubreadyServiceType {
      id: string;
      name: string;
      description: string | null;
      durations: { id: string; minutes: number }[];
      startMinutes: string[];
      allowCrossStudioBooking: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/listServiceTypes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.listServiceTypes("stretchlab-union-street");
Act 5
  • bookClassBooks the signed-in caller into a class from listClasses, spending an existing pass or membership credit.

    Arguments

    NameTypeRequired
    args{ studio: string, classId: string, seatId?: string }Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/bookClass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.bookClass({});
  • bookServiceBooks a one-on-one session from listServiceAvailability.

    Arguments

    NameTypeRequired
    args{ studio: string, instructorId: string, startsAt: string, durationId: string }Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/bookService

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.bookService({});
  • cancelBookingCancels a class booking or waitlist spot from listMyBookings.

    Arguments

    NameTypeRequired
    args{ studio: string, bookingId: string, acceptLateCancel?: boolean }Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/cancelBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.cancelBooking({});
  • joinWaitlistJoins the signed-in caller to a full class's waitlist.

    Arguments

    NameTypeRequired
    args{ studio: string, classId: string, seatId?: string }Yes

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.clubready.joinWaitlist({});
  • updateProfileEdits the signed-in member's own profile.

    Arguments

    NameTypeRequired
    args{ studio: string, fields: object }Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/clubready/updateProfile

    Call it

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

Use it from code