ClassPass MCP server for AI agents

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

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

Connect

Just ClassPass

An MCP server for ClassPass 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/classpass
Every site

One MCP server for ClassPass 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 24
  • checkAvailabilityChecks whether one already-known class slot is still bookable and at what credit price, without walking the whole day's timetable again.

    Arguments

    NameTypeRequired
    scheduleIdnumberYes

    Returns ClasspassSession

    interface ClasspassSession {
      /** Stable id of THIS session. */
      id: number;
      /** The recurring class it is an instance of, shared by every occurrence, so it
       *  is not a session key. */
      classId: number | null;
      name: string;
      classAlias: string | null;
      activities: string[];
      level: string | null;
      description: string | null;
      /** Absolute instant, ISO-8601 UTC. */
      startTime: string;
      endTime: string | null;
      /** The calendar date AT THE VENUE, YYYY-MM-DD. */
      localDate: string;
      durationMinutes: number | null;
      instructor: string | null;
      /** Credits to book. null where the site withholds a price, never 0-as-free. */
      credits: number | null;
      /** The site's own word: "available", "waitlist", "full", … */
      availability: string | null;
      isLivestream: boolean;
      demandSignals: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/checkAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.checkAvailability(1);
  • findLocationTurns a place name a caller holds (Charlotte, a neighbourhood, an address) into the coordinates search and findStudio both require, using ClassPass's…

    Arguments

    NameTypeRequired
    querystringYes

    Returns ClasspassFindLocationResult

    /** One place a location name resolved to, the coordinates search and findStudio
     *  both require. A query can match several real places, so every autocomplete
     *  match is resolved, not just the first. */
    interface ClasspassLocation {
      placeId: string;
      /** The short label ("Charlotte"). */
      name: string;
      /** The full disambiguated label ("Charlotte, NC, USA"). */
      description: string;
      latitude: number;
      longitude: number;
      timeZone: string | null;
      /** ClassPass's own suggested search radius for this place, km. Null where the
       *  details call did not carry one. */
      radiusKm: number | null;
    }
    
    interface ClasspassFindLocationResult {
      locations: ClasspassLocation[];
      /** Named autocomplete matches that failed to resolve to coordinates, the rest
       *  of the list is still complete, this is what was LOST from it. */
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/findLocation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.findLocation("Charlotte");
  • findStudioFinds ClassPass studios by NAME (and matching brand) near a point.

    Arguments

    NameTypeRequired
    querystringYes
    location{ lat: number; lon: number }Yes

    Returns ClasspassStudioMatch[]

    /** One studio NAME match, from findStudio. A caller holding only words gets
     *  this; getStudio(alias) follows up for the full profile. */
    interface ClasspassStudioMatch {
      id: number;
      alias: string;
      name: string;
      /** The qualifier for a chain branch ("Charlotte"). */
      subtitle: string | null;
      neighborhood: string | null;
      /** ClassPass's own metro-area id, not a human-readable name. */
      msaId: number | null;
      latitude: number;
      longitude: number;
      /** The site's own unlabelled distance figure from the query point, an
       *  ordering signal, not a verified unit. */
      distance: number | null;
      photo: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.findStudio("Barry's", { lat: 35.2068515, lon: -80.8616703 });
  • getBillingHistoryLists the signed-in member's past charges.

    Arguments

    None.

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getBillingHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getBillingHistory();
  • getBookingQuoteReturns what booking one specific class slot would cost THIS member.

    Arguments

    NameTypeRequired
    scheduleIdnumberYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getBookingQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getBookingQuote(1);
  • getClassReturns one class's own description at a studio.

    Arguments

    NameTypeRequired
    studionumber | stringYes
    classAliasstringYes

    Returns ClasspassClass

    /** One class a studio teaches, its own description, no date or time. Same shape
     *  whether read from the catalogue (listStudioClasses) or singly (getClass). */
    interface ClasspassClass {
      id: number;
      alias: string;
      name: string;
      description: string | null;
    
      durationMinutes: number | null;
    
      activities: string[];
      ratingAverage: number | null;
      /** The site's own display string ("1,000+"), never coerced to a number. */
      ratingCountDisplay: string | null;
      latitude: number | null;
      longitude: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getClass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getClass(1, "<classAlias>");
  • getClassReviewsReads the reviews members left for one class (not the whole studio), keyed by the class's NUMERIC id.

    Arguments

    NameTypeRequired
    classIdnumberYes

    Returns ClasspassClassReviews

    /** One member review. `reviewerName` is a first name plus a last initial, *  never assembled into a full name the reviewer did not give. */
    interface ClasspassReview {
      id: number;
      className: string | null;
      /** 1-5. Null on the rare row that carries no rating. */
      rating: number | null;
      text: string | null;
      createdAt: string;
      reviewerName: string | null;
      teacherName: string | null;
      isPublic: boolean;
      photoUrl: string | null;
    }
    
    interface ClasspassClassReviews {
      classId: number;
      featuredReviews: ClasspassReview[];
      reviews: ClasspassReview[];
      /** The site's own count across every page; `reviews` is its first page only. */
      totalCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getClassReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getClassReviews(1);
  • getCreditBalanceReturns how many credits the signed-in member has left this cycle, what rolls over and when the cycle renews.

    Arguments

    None.

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getCreditBalance

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getCreditBalance();
  • getMyProfileReturns the signed-in member's profile: name, email, home market, photo and the numeric user id every account route is keyed on.

    Arguments

    None.

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getMyProfile();
  • getMySubscriptionReturns the signed-in member's plan: tier, monthly credits, price, renewal date, and any pending pause or cancellation.

    Arguments

    None.

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getMySubscription

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getMySubscription();
  • getReservationReturns one reservation in full.

    Arguments

    NameTypeRequired
    reservationKeystringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getReservation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getReservation("x");
  • getScheduleReturns one studio's upcoming bookable class/appointment timetable.

    Arguments

    NameTypeRequired
    studionumber | stringYes
    options.datestring
    First day, YYYY-MM-DD.
    No
    options.daysnumber
    Consecutive days from date, 1-7 (each day is one live request).
    No

    Returns ClasspassSchedule

    interface ClasspassSchedule {
      venue: ClasspassVenue;
      /** Dates covered, YYYY-MM-DD in the venue's zone, ascending. A day with no
       *  sessions still appears, "nothing published" is an answer. */
      dates: string[];
      sessions: ClasspassSession[];
    }
    
    interface ClasspassVenue {
      id: number;
      alias: string;
      name: string;
      /** The qualifier the site prints after the name ("Charlotte"), how a chain's
       *  branches are told apart. */
      subtitle: string | null;
      /** IANA zone, e.g. "America/New_York". Every startTime is an absolute instant;
       *  this is what renders one as the wall-clock time a person would read. */
      timeZone: string | null;
      street: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      latitude: number | null;
      longitude: number | null;
      activities: string[];
      amenities: string[];
      ratingAverage: number | null;
      ratingCount: number | null;
    }
    
    interface ClasspassSession {
      /** Stable id of THIS session. */
      id: number;
      /** The recurring class it is an instance of, shared by every occurrence, so it
       *  is not a session key. */
      classId: number | null;
      name: string;
      classAlias: string | null;
      activities: string[];
      level: string | null;
      description: string | null;
      /** Absolute instant, ISO-8601 UTC. */
      startTime: string;
      endTime: string | null;
      /** The calendar date AT THE VENUE, YYYY-MM-DD. */
      localDate: string;
      durationMinutes: number | null;
      instructor: string | null;
      /** Credits to book. null where the site withholds a price, never 0-as-free. */
      credits: number | null;
      /** The site's own word: "available", "waitlist", "full", … */
      availability: string | null;
      isLivestream: boolean;
      demandSignals: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getSchedule

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getSchedule("barrys-charlotte");
  • getStudioReturns one gym/studio/spa/salon's ClassPass profile in a single request.

    Arguments

    NameTypeRequired
    studionumber | stringYes

    Returns ClasspassStudio

    /** Everything /v2/venues publishes about one studio, a superset of
     *  ClasspassVenue, so anything holding one can hold the other. */
    interface ClasspassStudio extends ClasspassVenue {
      /** What the studio does. On THIS function it comes from the venue record's own
       *  tag block, so it is correct even on a day the studio publishes no classes. */
      activities: string[];
      /** ISO-3166 alpha-2, e.g. "US", "GB". */
      country: string | null;
      /** The site's neighbourhood label ("South Charlotte"). Null where it publishes none. */
      neighborhood: string | null;
      /** The metro area the studio is sold in ("Charlotte Metro", "London Metro"). */
      metroArea: string | null;
      description: string | null;
      /** The studio's OWN site, not its ClassPass page. Null where it publishes none. */
      website: string | null;
      phone: string | null;
      instagram: string | null;
      facebook: string | null;
      twitter: string | null;
      /** Real photographs, largest first. ClassPass's generic fallback placeholders are
       *  dropped, a placeholder passed off as the studio is worse than nothing. */
      photos: string[];
      logo: string | null;
      /** Only the attributes the studio asserts, e.g. ["lgbtq_friendly",
       *  "wheelchair_accessible"]. A false flag means "not claimed" and is dropped. */
      inclusivity: string[];
      bookingWindow: string | null;
      whenToArrive: string | null;
      whatToBring: string | null;
      howToGetThere: string | null;
      proTip: string | null;
      cancellationPolicy: string | null;
      /** null where the site holds no policy (it sends the sentinel "UNKNOWN"). */
      lateCancellation: string | null;
      demandSignals: string[];
      /** ClassPass's own published fraction (0-1). Returned under the site's own name
       *  and NOT relabelled a saving, the site does not document its basis. There is
       *  no credit price on this record; per-class cost is getSchedule's `credits`. */
      averageDiscount: number | null;
      outOfNetwork: boolean;
      spots: number | null;
    }
    
    interface ClasspassVenue {
      id: number;
      alias: string;
      name: string;
      /** The qualifier the site prints after the name ("Charlotte"), how a chain's
       *  branches are told apart. */
      subtitle: string | null;
      /** IANA zone, e.g. "America/New_York". Every startTime is an absolute instant;
       *  this is what renders one as the wall-clock time a person would read. */
      timeZone: string | null;
      street: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      latitude: number | null;
      longitude: number | null;
      activities: string[];
      amenities: string[];
      ratingAverage: number | null;
      ratingCount: number | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getStudio("barrys-charlotte");
  • getStudioReviewsReads a studio's member reviews.

    Arguments

    NameTypeRequired
    studionumber | stringYes

    Returns ClasspassStudioReviews

    /** One member review. `reviewerName` is a first name plus a last initial, *  never assembled into a full name the reviewer did not give. */
    interface ClasspassReview {
      id: number;
      className: string | null;
      /** 1-5. Null on the rare row that carries no rating. */
      rating: number | null;
      text: string | null;
      createdAt: string;
      reviewerName: string | null;
      teacherName: string | null;
      isPublic: boolean;
      photoUrl: string | null;
    }
    
    interface ClasspassStudioReviews {
      /** The studio this function resolved the numeric id for. */
      venue: { id: number; alias: string; name: string };
      featuredReviews: ClasspassReview[];
      reviews: ClasspassReview[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getStudioReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getStudioReviews("barrys-charlotte");
  • getVideoReturns one on-demand video.

    Arguments

    NameTypeRequired
    videoIdstringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/getVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.getVideo("x");
  • listCategoriesLists ClassPass's activity and category vocabulary (Classes & Appointments, Yoga, Pilates, Massage, …) with the tag ids a filtered search takes.

    Arguments

    None.

    Returns ClasspassCategory[]

    /** One node of the tag tree. `id` is the tag id a filtered search takes. */
    interface ClasspassCategory {
      id: string;
      name: string;
      parentId: string | null;
      filterable: boolean;
      subtags: ClasspassCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listCategories();
  • listFavoritesLists the studios the signed-in member has saved as favourites.

    Arguments

    None.

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listFavorites

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listFavorites();
  • listMarketsLists the cities and metro areas ClassPass operates in, with each market's id, alias, country and currency.

    Arguments

    None.

    Returns ClasspassMarket[]

    /** One ClassPass market (an MSA). `alias` is the slug the site's city pages use;
     * `priceMonthly` is the entry plan's advertised monthly price in `currency`. */
    interface ClasspassMarket {
      id: number;
      alias: string;
      name: string;
      city: string;
      country: string | null;
      countryCode: string | null;
      currency: string | null;
      timeZone: string | null;
      lat: number | null;
      lon: number | null;
      priceMonthly: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listMarkets

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listMarkets();
  • listMyReservationsLists the signed-in member's upcoming and past reservations.

    Arguments

    None.

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listMyReservations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listMyReservations();
  • listOnDemandVideosLists the member on-demand workout videos (filters, collections, stacks) included with a ClassPass plan.

    Arguments

    None.

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listOnDemandVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listOnDemandVideos();
  • listSimilarStudiosLists studios ClassPass considers similar to one studio.

    Arguments

    NameTypeRequired
    studionumber | stringYes

    Returns ClasspassSimilarStudios

    interface ClasspassVenue {
      id: number;
      alias: string;
      name: string;
      /** The qualifier the site prints after the name ("Charlotte"), how a chain's
       *  branches are told apart. */
      subtitle: string | null;
      /** IANA zone, e.g. "America/New_York". Every startTime is an absolute instant;
       *  this is what renders one as the wall-clock time a person would read. */
      timeZone: string | null;
      street: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      latitude: number | null;
      longitude: number | null;
      activities: string[];
      amenities: string[];
      ratingAverage: number | null;
      ratingCount: number | null;
    }
    
    interface ClasspassSimilarStudio extends ClasspassVenue {
      /** The site's own distance from the studio asked about. */
      distanceMi: number | null;
    }
    
    interface ClasspassSimilarStudios {
      venue: { id: number; alias: string; name: string };
      studios: ClasspassSimilarStudio[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listSimilarStudios

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listSimilarStudios("barrys-charlotte");
  • listStudioBranchesLists the other locations of the same brand on ClassPass.

    Arguments

    NameTypeRequired
    studionumber | stringYes

    Returns ClasspassStudioBranches

    interface ClasspassVenue {
      id: number;
      alias: string;
      name: string;
      /** The qualifier the site prints after the name ("Charlotte"), how a chain's
       *  branches are told apart. */
      subtitle: string | null;
      /** IANA zone, e.g. "America/New_York". Every startTime is an absolute instant;
       *  this is what renders one as the wall-clock time a person would read. */
      timeZone: string | null;
      street: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      latitude: number | null;
      longitude: number | null;
      activities: string[];
      amenities: string[];
      ratingAverage: number | null;
      ratingCount: number | null;
    }
    
    /** Every OTHER location of the same brand; the studio asked about is not in it. */
    interface ClasspassStudioBranches {
      venue: { id: number; alias: string; name: string };
      branches: ClasspassVenue[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listStudioBranches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listStudioBranches("barrys-charlotte");
  • listStudioClassesLists the classes a studio teaches.

    Arguments

    NameTypeRequired
    studionumber | stringYes

    Returns ClasspassClass[]

    /** One class a studio teaches, its own description, no date or time. Same shape
     *  whether read from the catalogue (listStudioClasses) or singly (getClass). */
    interface ClasspassClass {
      id: number;
      alias: string;
      name: string;
      description: string | null;
    
      durationMinutes: number | null;
    
      activities: string[];
      ratingAverage: number | null;
      /** The site's own display string ("1,000+"), never coerced to a number. */
      ratingCountDisplay: string | null;
      latitude: number | null;
      longitude: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/listStudioClasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.listStudioClasses("barrys-charlotte");
Act 3
  • addFavoriteSaves a studio to the signed-in member's favourites.

    Arguments

    NameTypeRequired
    venueIdnumberYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/addFavorite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.addFavorite(1);
  • checkInMarks one of the signed-in member's reservations as attended (the app's check-in).

    Arguments

    NameTypeRequired
    reservationKeystringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/checkIn

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.checkIn("<reservationKey>");
  • removeFavoriteRemoves a studio from the signed-in member's favourites.

    Arguments

    NameTypeRequired
    venueIdnumberYes

    Returns { removed: boolean; venueId: number }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classpass/removeFavorite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classpass.removeFavorite(1);

Use it from code