FitDegree MCP server for AI agents

Let Claude, ChatGPT or your own agent read FitDegree: 20 typed functions through one MCP server. No FitDegree API key needed.

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

Connect

Just FitDegree

An MCP server for FitDegree 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/fitdegree
Every site

One MCP server for FitDegree 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 20
  • findStudioFinds a FitDegree studio by name, city or website, or from the URL of a page that embeds the FitDegree schedule, returning the fitspot id every other…

    Arguments

    NameTypeRequired
    querystring | FitdegreeFindStudioArgsYes
    interface FitdegreeFindStudioArgs {
      query: string;              // name, city, website, or a page URL embedding the FitDegree schedule
      includeInactive?: boolean;  // include retired/deleted fitspots (default false)
    }

    Returns FitdegreeStudio[]

    interface FitdegreeStudio {
      fitspotId: string;      // what every other fitdegree function takes
      name: string;           // the fitspot's own name, often just the location ("Miami, FL")
      companyId: string;
      companyName?: string;   // the brand ("Pilathon")
      address?: string; city?: string; state?: string; zip?: string;
      timeZone?: string;      // IANA, e.g. "America/New_York"
      phone?: string; email?: string; websiteUrl?: string; logoUrl?: string;
      active: boolean;        // false for a retired or deleted fitspot
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.findStudio("Pilathon");
  • getCancellationPolicyReturns a studio's cancellation policy for a class.

    Arguments

    NameTypeRequired
    cancellationPolicyIdstring
    From a class's cancellationPolicyId (getClass / listClasses).
    Yes
    companyIdstring
    From the studio's companyId (getStudio).
    Yes

    Returns FitdegreeCancellationPolicy

    interface FitdegreeCancellationPolicy {
      cancellationPolicyId: string; companyId: string;
      description: string;  // the studio's own HTML text, early/late windows, the no-show fee
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/getCancellationPolicy

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.getCancellationPolicy({
      cancellationPolicyId: "<cancellationPolicyId>",
      companyId: "<companyId>"
    });
  • getClassReturns one scheduled class by id: description, start and end time, instructor, room, capacity, number booked, whether it is open, full or closed and…

    Arguments

    NameTypeRequired
    classIdstringYes

    Returns FitdegreeClassDetail

    interface FitdegreeClass {
      classId: string;        // what getClass takes
      title: string; type?: string; description?: string;
      start: string; end: string;   // studio-local "YYYY-MM-DD HH:MM:SS"
      durationMinutes?: number;
      instructorId?: string; instructorName?: string;
      locationId?: string; locationName?: string;
      capacity?: number; booked: number; spotsLeft?: number; waitlistCount: number;
      cancelled: boolean;
      bookingOpensAt?: string; bookingClosesAt?: string;  // studio-local
      requiresPayment: boolean; payAtStudio: boolean;
      waiverIds: string[]; cancellationPolicyId?: string;
      isVirtual: boolean; shareUrl?: string; imageUrl?: string;
    }
    
    interface FitdegreeClassDetail extends FitdegreeClass {
      status?: string;          // "open", "full", "closed" as the site reports it
      waitlistAvailable: boolean;
      recurringClassId?: string;
      fitspotId: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.getClass("<classId>");
  • getInstructorReturns one instructor's profile by id: name, photo, bio and certifications.

    Arguments

    NameTypeRequired
    instructorIdstringYes

    Returns FitdegreeInstructor

    interface FitdegreeInstructor {
      instructorId: string; name: string; username?: string; bio?: string; photoUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/getInstructor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.getInstructor("<instructorId>");
  • getMembershipPricingReturns the prices and billing terms of a studio's memberships and packs as the signed-in member would pay them.

    Arguments

    NameTypeRequired
    args{ fitspotId: string; membershipId: string }Yes

    Returns FitdegreeMembershipPricing

    interface FitdegreeMembershipPricing {
      membershipId: string;
      upfrontDueToday?: number;    // dollars, paying up front
      recurringDueToday?: number;  // dollars, on recurring payments
      options: { pricingOptionId: string; description?: string; price?: number; discounts: string[]; tax?: string }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/getMembershipPricing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.getMembershipPricing({});
  • getMyProfileReturns the signed-in member's own fitDEGREE profile at a studio's company: name, username, photo, emails, phones, active passes, upcoming bookings…

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeMyProfile

    interface FitdegreeMyProfile {
      userId?: string; identityId?: string;
      firstName?: string; lastName?: string; username?: string; aboutMe?: string; photoUrl?: string;
      emails: string[]; phones: string[];
      activePasses: { memberships: number; classPacks: number; privatePacks: number; offers: number; guestPasses: number };
      upcomingBookings: number;
      waiversToSign: number;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.getMyProfile("961");
  • getStudioReturns one studio by fitspot id: name, address, time zone, contact details, logo, its company (brand) with app links and settings, and the other…

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeStudioDetail

    interface FitdegreeStudio {
      fitspotId: string;      // what every other fitdegree function takes
      name: string;           // the fitspot's own name, often just the location ("Miami, FL")
      companyId: string;
      companyName?: string;   // the brand ("Pilathon")
      address?: string; city?: string; state?: string; zip?: string;
      timeZone?: string;      // IANA, e.g. "America/New_York"
      phone?: string; email?: string; websiteUrl?: string; logoUrl?: string;
      active: boolean;        // false for a retired or deleted fitspot
    }
    
    interface FitdegreeCompany {
      id: string; name: string; iosAppUrl?: string; androidAppUrl?: string;
      primaryColor?: string; hasBrandedApp: boolean;
      fitspotIds: string[];   // every studio this company runs
    }
    
    interface FitdegreeStudioDetail extends FitdegreeStudio {
      company?: FitdegreeCompany;
      enableSpotBooking: boolean; classpassEnabled: boolean; acceptsPayment: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.getStudio("961");
  • listAnnouncementsLists a studio's announcements to members (new schedule, closures, promotions) with title, body and date.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeAnnouncement[]

    interface FitdegreeAnnouncement {
      postId: string; title: string; body: string;
      postedAt?: string;  // UTC, "YYYY-MM-DD HH:MM:SS"
      likes: number; views?: number;
      imageUrls: string[]; attachmentUrls: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listAnnouncements

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listAnnouncements("961");
  • listClassesLists a studio's class schedule for a date range, optionally narrowed to an instructor or room: each class's id, title, start and end time in studio…

    Arguments

    NameTypeRequired
    fitspotIdstring
    From findStudio.
    Yes
    fromstring
    Studio-local "YYYY-MM-DD", default today.
    No
    tostring
    Inclusive, default from + 6 days, at most 31 days.
    No
    instructorIdstring
    From listInstructors or a class's instructorId.
    No
    locationIdstring
    A room id from a class's locationId.
    No

    Returns FitdegreeClass[]

    interface FitdegreeClass {
      classId: string;        // what getClass takes
      title: string; type?: string; description?: string;
      start: string; end: string;   // studio-local "YYYY-MM-DD HH:MM:SS"
      durationMinutes?: number;
      instructorId?: string; instructorName?: string;
      locationId?: string; locationName?: string;
      capacity?: number; booked: number; spotsLeft?: number; waitlistCount: number;
      cancelled: boolean;
      bookingOpensAt?: string; bookingClosesAt?: string;  // studio-local
      requiresPayment: boolean; payAtStudio: boolean;
      waiverIds: string[]; cancellationPolicyId?: string;
      isVirtual: boolean; shareUrl?: string; imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listClasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listClasses({ fitspotId: "961" });
  • listEventsLists a studio's one-off events and challenges with dates, room, instructor, capacity and price.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeEvent[]

    interface FitdegreeEvent {
      eventId: string;
      registrableId: string;  // what registerForEvent and cancelBooking take
      purchasableId?: string; title: string; description?: string;
      start: string; end?: string;  // studio-local "YYYY-MM-DD HH:MM:SS"
      instructorId?: string; locationId?: string; locationName?: string;
      capacity?: number; booked: number;
      requiresPayment: boolean; payAtStudio: boolean;
      priceCents: number; pricingOptionId?: string;
      cancelled: boolean; waiverIds: string[]; isVirtual: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listEvents("961");
  • listInstructorsLists the instructors at a studio with id, name, photo and bio.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeInstructor[]

    interface FitdegreeInstructor {
      instructorId: string; name: string; username?: string; bio?: string; photoUrl?: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listInstructors("961");
  • listIntroOffersLists a studio's intro and promotional offers ("Second Group Class On Us") with title, description, price and how long they last once bought.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeIntroOffer[]

    interface FitdegreeIntroOffer {
      offerId: string; purchasableId?: string; title: string; subtitle?: string; description?: string;
      priceCents: number; pricingOptionId?: string;
      expiresInDays?: number;  // how long the offer is usable for once bought
      perkTemplateIds: string[]; imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listIntroOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listIntroOffers("961");
  • listLocationsLists the rooms or locations inside a studio ("Reformer Room", "Private Room") with their ids, which listClasses results and private-session types…

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeLocation[]

    interface FitdegreeLocation {
      locationId: string;  // a room/location, what listClasses and listScheduleDates filter on
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listLocations("961");
  • listMembershipsLists the memberships and class packs a studio sells with name, description, terms and who can buy them.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeMembership[]

    interface FitdegreeMembership {
      membershipId: string; name: string; description?: string;  // the site's own HTML terms
      audience: number[];     // the site's own numeric audience codes, uninterpreted
      perkTemplateIds: string[]; purchasableId?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listMemberships

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listMemberships("961");
  • listMyBookingsLists the signed-in member's upcoming and past bookings at a studio.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeMyBooking[]

    interface FitdegreeClass {
      classId: string;        // what getClass takes
      title: string; type?: string; description?: string;
      start: string; end: string;   // studio-local "YYYY-MM-DD HH:MM:SS"
      durationMinutes?: number;
      instructorId?: string; instructorName?: string;
      locationId?: string; locationName?: string;
      capacity?: number; booked: number; spotsLeft?: number; waitlistCount: number;
      cancelled: boolean;
      bookingOpensAt?: string; bookingClosesAt?: string;  // studio-local
      requiresPayment: boolean; payAtStudio: boolean;
      waiverIds: string[]; cancellationPolicyId?: string;
      isVirtual: boolean; shareUrl?: string; imageUrl?: string;
    }
    
    interface FitdegreeMyBooking {
      registrationId?: string;
      classId: string;             // getClass / cancelBooking take this
      status?: string;             // the site's own word: "registered", "waitlisted", …
      bookedAt?: string; checkedIn: boolean;
      class?: FitdegreeClass;      // when the site sent the class row alongside
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listMyBookings("961");
  • listMyPassesLists the signed-in member's memberships, class packs and credits at a studio.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeMyPass[]

    type FitdegreePassKind = "membership" | "classPack" | "privatePack" | "offer" | "guestPass";
    
    interface FitdegreeMyPass {
      passId?: string; kind: FitdegreePassKind; name?: string;
      startsAt?: string; expiresAt?: string; purchasedAt?: string;
      remaining: number | null;    // uses left; null = unlimited
      total?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listMyPasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listMyPasses("961");
  • listPrivateSessionTypesLists the private sessions (one-on-ones) a studio offers.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreePrivateSessionType[]

    interface FitdegreePrivateSessionType {
      serviceId: string;  // what getPrivateSessionAvailability and bookPrivateSession take
      name: string; description?: string;
      durations: Array<{ durationId: string; minutes: number; priceCents: number }>;
      locationIds: string[];
      requiresPayment: boolean; payAtStudio: boolean;
      taxPercent?: number; cancellationPolicyId?: string;
      waiverIds: string[];
      bookableUpToWeeks?: number;  // how far ahead a session can be booked
      isVirtual: boolean; imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listPrivateSessionTypes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listPrivateSessionTypes("961");
  • listScheduleDatesReturns which days in a range have classes at a studio, and how many.

    Arguments

    NameTypeRequired
    fitspotIdstringYes
    fromstring
    Studio-local "YYYY-MM-DD", default today.
    No
    tostring
    Inclusive, default from + 30 days, at most 31 days.
    No

    Returns FitdegreeScheduleDate[]

    interface FitdegreeScheduleDate {
      date: string;       // studio-local "YYYY-MM-DD"
      classCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listScheduleDates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listScheduleDates({ fitspotId: "961" });
  • listSeriesLists a studio's multi-week series and courses with their sessions, dates and price.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeSeries[]

    interface FitdegreeSeriesSession {
      sessionId: string;
      registrableId: string;  // what registerForEvent and cancelBooking take for this one session
      start: string; end?: string;  // studio-local "YYYY-MM-DD HH:MM:SS"
      instructorId?: string; locationId?: string; locationName?: string;
      capacity?: number; booked: number; priceCents: number;
      past: boolean; cancelled: boolean;
    }
    
    interface FitdegreeSeries {
      seriesId: string;
      registrableId: string;  // what registerForEvent takes to register for the whole series
      purchasableId?: string; title: string; description?: string;
      start?: string; end?: string;  // studio-local first-session start and last-session end
      requiresPayment: boolean; payAtStudio: boolean;
      perSessionRegistration: boolean;  // whether a member can register for one session rather than the whole series
      priceCents?: number; pricingOptionId?: string;
      capacity?: number; booked: number; cancelled: boolean;
      waiverIds: string[];
      sessions: FitdegreeSeriesSession[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listSeries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listSeries("21");
  • listWaiversToSignLists the waivers the signed-in member still has to sign before booking at a studio, with their text.

    Arguments

    NameTypeRequired
    fitspotIdstringYes

    Returns FitdegreeWaiverToSign[]

    interface FitdegreeWaiverToSign {
      requestedSignatureId?: string;
      waiverId: string; title?: string;
      content?: string;            // the waiver text as the studio wrote it (may carry HTML)
      requestedAt?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fitdegree/listWaiversToSign

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fitdegree.listWaiversToSign("961");

Use it from code