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.
- Site
- classpass.com
- Functions
- 27
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/classpassOne MCP server for ClassPass 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.
checkAvailabilityChecks whether one already-known class slot is still bookable and at what credit price, without walking the whole day's timetable again.Arguments
Name Type Required scheduleIdnumberYes Returns
ClasspassSessioninterface 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/checkAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.checkAvailability(1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.checkAvailability(1))curl -X POST https://api.bowmark.ai/v1/sites/classpass/checkAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"scheduleId":1}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/findLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.findLocation("Charlotte");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.findLocation("Charlotte"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/findLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"Charlotte"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.findLocation("Charlotte");findStudioFinds ClassPass studios by NAME (and matching brand) near a point.Arguments
Name Type Required 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/findStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.findStudio("Barry's", { lat: 35.2068515, lon: -80.8616703 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.findStudio("Barry's", {"lat": 35.2068515, "lon": -80.8616703}))curl -X POST https://api.bowmark.ai/v1/sites/classpass/findStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"Barry'\''s","location":{"lat":35.2068515,"lon":-80.8616703}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/getBillingHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getBillingHistory();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getBillingHistory())curl -X POST https://api.bowmark.ai/v1/sites/classpass/getBillingHistory \ -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.classpass.getBillingHistory();getBookingQuoteReturns what booking one specific class slot would cost THIS member.Arguments
Name Type Required scheduleIdnumberYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/getBookingQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getBookingQuote(1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getBookingQuote(1))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getBookingQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"scheduleId":1}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.getBookingQuote(1);getClassReturns one class's own description at a studio.Arguments
Name Type Required 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/getClassCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getClass(1, "<classAlias>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getClass(1, "<classAlias>"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getClass \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":1,"classAlias":"<classAlias>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getClassReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getClassReviews(1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getClassReviews(1))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getClassReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"classId":1}'// The body of a run: the MCP run tool, or POST /v1/run return 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/getCreditBalanceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getCreditBalance();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getCreditBalance())curl -X POST https://api.bowmark.ai/v1/sites/classpass/getCreditBalance \ -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.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/getMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getMyProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getMyProfile())curl -X POST https://api.bowmark.ai/v1/sites/classpass/getMyProfile \ -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.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/getMySubscriptionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getMySubscription();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getMySubscription())curl -X POST https://api.bowmark.ai/v1/sites/classpass/getMySubscription \ -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.classpass.getMySubscription();getReservationReturns one reservation in full.Arguments
Name Type Required reservationKeystringYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/getReservationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getReservation("x");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getReservation("x"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getReservation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"reservationKey":"x"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.getReservation("x");getScheduleReturns one studio's upcoming bookable class/appointment timetable.Arguments
Name Type Required studionumber | stringYes options.datestringFirst day, YYYY-MM-DD.No options.daysnumberConsecutive days from date, 1-7 (each day is one live request).No Returns
ClasspassScheduleinterface 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/getScheduleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getSchedule("barrys-charlotte");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getSchedule("barrys-charlotte"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getSchedule \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"barrys-charlotte"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.getSchedule("barrys-charlotte");getStudioReturns one gym/studio/spa/salon's ClassPass profile in a single request.Arguments
Name Type Required 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/getStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getStudio("barrys-charlotte");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getStudio("barrys-charlotte"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"barrys-charlotte"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.getStudio("barrys-charlotte");getStudioReviewsReads a studio's member reviews.Arguments
Name Type Required 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/getStudioReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getStudioReviews("barrys-charlotte");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getStudioReviews("barrys-charlotte"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getStudioReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"barrys-charlotte"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.getStudioReviews("barrys-charlotte");getVideoReturns one on-demand video.Arguments
Name Type Required videoIdstringYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/getVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.getVideo("x");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.getVideo("x"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/getVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"videoId":"x"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/classpass/listCategories \ -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.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/listFavoritesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listFavorites();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listFavorites())curl -X POST https://api.bowmark.ai/v1/sites/classpass/listFavorites \ -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.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/listMarketsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listMarkets();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listMarkets())curl -X POST https://api.bowmark.ai/v1/sites/classpass/listMarkets \ -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.classpass.listMarkets();listMyReservationsLists the signed-in member's upcoming and past reservations.Arguments
None.
HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/listMyReservationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listMyReservations();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listMyReservations())curl -X POST https://api.bowmark.ai/v1/sites/classpass/listMyReservations \ -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.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/listOnDemandVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listOnDemandVideos();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listOnDemandVideos())curl -X POST https://api.bowmark.ai/v1/sites/classpass/listOnDemandVideos \ -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.classpass.listOnDemandVideos();listSimilarStudiosLists studios ClassPass considers similar to one studio.Arguments
Name Type Required studionumber | stringYes Returns
ClasspassSimilarStudiosinterface 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/listSimilarStudiosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listSimilarStudios("barrys-charlotte");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listSimilarStudios("barrys-charlotte"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/listSimilarStudios \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"barrys-charlotte"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.listSimilarStudios("barrys-charlotte");listStudioBranchesLists the other locations of the same brand on ClassPass.Arguments
Name Type Required studionumber | stringYes Returns
ClasspassStudioBranchesinterface 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/listStudioBranchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listStudioBranches("barrys-charlotte");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listStudioBranches("barrys-charlotte"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/listStudioBranches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"barrys-charlotte"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.listStudioBranches("barrys-charlotte");listStudioClassesLists the classes a studio teaches.Arguments
Name Type Required 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/listStudioClassesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.listStudioClasses("barrys-charlotte");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.listStudioClasses("barrys-charlotte"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/listStudioClasses \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"barrys-charlotte"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.listStudioClasses("barrys-charlotte");searchSearches fitness, wellness AND beauty businesses (gyms, studios, spas and salons) near a location.Arguments
Name Type Required latnumberCentre of the search, decimal degrees.Yes lonnumberYes radiusnumberSearch radius (default 1, clamped to 1-50); turned into a bounding box.Yes radiusUnits"mi" | "km""mi" (default) or "km".No datestringFirst day, YYYY-MM-DD.No Returns
ClasspassSearchResultinterface 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 ClasspassSearchVenue { id: number; alias: string; name: string; locationName: string | null; description: string | null; activities: string[]; /** Null when the site has nothing to show yet. */ ratingAverage: number | null; /** The site's OWN display string ("30000+", "3", "0"), never coerced to a * number, since past a threshold the site itself only publishes a floor. */ ratingCountDisplay: string | null; latitude: number; longitude: number; /** Largest real photo; ClassPass's shared placeholder is dropped. */ photo: string | null; } interface ClasspassSearchResult { results: ClasspassSearchVenue[]; /** The origin's own session id for this search. */ searchId: string; /** What this function did to the caller's query (defaults applied). */ warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.search({ lat: 35.2068515, lon: -80.8616703, radius: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.search({"lat": 35.2068515, "lon": -80.8616703, "radius": 5}))curl -X POST https://api.bowmark.ai/v1/sites/classpass/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"lat":35.2068515,"lon":-80.8616703,"radius":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.search({ lat: 35.2068515, lon: -80.8616703, radius: 5 });
addFavoriteSaves a studio to the signed-in member's favourites.Arguments
Name Type Required venueIdnumberYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/addFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.addFavorite(1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.addFavorite(1))curl -X POST https://api.bowmark.ai/v1/sites/classpass/addFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"venueId":1}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.addFavorite(1);checkInMarks one of the signed-in member's reservations as attended (the app's check-in).Arguments
Name Type Required reservationKeystringYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/checkInCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.checkIn("<reservationKey>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.checkIn("<reservationKey>"))curl -X POST https://api.bowmark.ai/v1/sites/classpass/checkIn \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"reservationKey":"<reservationKey>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.checkIn("<reservationKey>");removeFavoriteRemoves a studio from the signed-in member's favourites.Arguments
Name Type Required venueIdnumberYes Returns
{ removed: boolean; venueId: number }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/classpass/removeFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.classpass.removeFavorite(1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.classpass.removeFavorite(1))curl -X POST https://api.bowmark.ai/v1/sites/classpass/removeFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"venueId":1}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.classpass.removeFavorite(1);
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/classpass/<function> - OpenAPI
/v1/sites/classpass/openapi.json