TeamUp MCP server for AI agents

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

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

Connect

Just TeamUp

An MCP server for TeamUp 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/goteamup_classes
Every site

One MCP server for TeamUp 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 12
  • checkBookingEligibilitySays whether the signed-in caller can book a class and why not.

    Arguments

    NameTypeRequired
    studiostring | numberYes
    classIdstring | numberYes

    Returns GoteamupEligibility

    interface GoteamupEligibility {
      eligible: boolean;
      /** Why not, in the site's own words, null when eligible or when the site gave no reason. */
      reason: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goteamup_classes/checkBookingEligibility

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.checkBookingEligibility("<studio>", "<classId>");
  • findStudioFinds TeamUp studios by name (and town) and returns each one's provider id, slug and name.

    Arguments

    NameTypeRequired
    namestringYes

    Returns GoteamupStudio[]

    interface GoteamupStudio {
      providerId: string;
      name: string;
      description: string;
      country: string;
      currencyCode: string;
      currencySymbol: string;
      address: {
        street: string | null;
        city: string | null;
        region: string | null;
        postalCode: string | null;
        country: string;
        timezone: string;
      };
      contactEmail: string | null;
      contactPhone: string | null;
      urlSlug: string;
      /** This studio's own page, e.g. "https://goteamup.com/p/3707700-kb-fitness-studio/". */
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.findStudio("KB Fitness");
  • getClassGets one class by the event id listSchedule returned.

    Arguments

    NameTypeRequired
    studiostring | numberYes
    classIdstring | numberYes

    Returns GoteamupClass

    interface GoteamupPrice {
      decimal: number;
      currencyCode: string;
      symbol: string;
    }
    
    interface GoteamupVenue {
      id: string;
      name: string;
      address: string;
      timezone: string;
    }
    
    interface GoteamupInstructor {
      id: string;
      name: string;
    }
    
    interface GoteamupOfferingType {
      id: string;
      name: string;
      description: string;
      scheduleType: string;
      allowsDropins: boolean;
      dropinPrice: GoteamupPrice | null;
      cancellationNoticeMinutes: number;
    }
    
    interface GoteamupClass {
      id: string;
      name: string;
      description: string;
      startsAt: string;
      endsAt: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      attendingCount: number;
      maxOccupancy: number;
      isFull: boolean;
      waitingCount: number;
      registrationsOpenAt: string | null;
      registrationsCloseAt: string | null;
      lateCancelDeadline: string | null;
      venue: GoteamupVenue | null;
      instructors: GoteamupInstructor[];
      offeringType: GoteamupOfferingType | null;
      /** This class's own page, e.g. "https://goteamup.com/p/3707700-kb-fitness-studio/e/109904116-…/". */
      url: string;
    
      checkout: GoteamupCheckout | null;
    }
    
    interface GoteamupCheckout {
      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/goteamup_classes/getClass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.getClass("<studio>", "<classId>");
  • getMembershipGets one membership's full terms by the id listMemberships returned (GET /api/v2/memberships/<id>).

    Arguments

    NameTypeRequired
    studiostring | numberYes
    membershipIdstring | numberYes

    Returns GoteamupMembership

    interface GoteamupPrice {
      decimal: number;
      currencyCode: string;
      symbol: string;
    }
    
    interface GoteamupMembership {
      id: string;
      name: string;
      /** "recurring_plan" | "pack", the site's own membership type. */
      type: string;
      description: string;
      isDropin: boolean;
      forSale: boolean;
      allowRepeatPurchases: boolean;
      newCustomersOnly: boolean;
      price: GoteamupPrice | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goteamup_classes/getMembership

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.getMembership("<studio>", "<membershipId>");
  • getMyProfileGets the signed-in caller's own customer record at a studio (GET /api/v2/customers/me).

    Arguments

    NameTypeRequired
    studiostring | numberYes

    Returns GoteamupMyProfile

    interface GoteamupMyProfile {
      id: string;
      firstName: string | null;
      lastName: string | null;
      name: string | null;
      email: string | null;
      phone: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.getMyProfile(3707700);
  • getStudioGets one studio's profile, name, address, timezone, currency and default booking windows, from GET…

    Arguments

    NameTypeRequired
    studiostring | numberYes

    Returns GoteamupStudio

    interface GoteamupStudio {
      providerId: string;
      name: string;
      description: string;
      country: string;
      currencyCode: string;
      currencySymbol: string;
      address: {
        street: string | null;
        city: string | null;
        region: string | null;
        postalCode: string | null;
        country: string;
        timezone: string;
      };
      contactEmail: string | null;
      contactPhone: string | null;
      urlSlug: string;
      /** This studio's own page, e.g. "https://goteamup.com/p/3707700-kb-fitness-studio/". */
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.getStudio(3707700);
  • listClassTypesLists a studio's class types (offering types) with description, whether drop-ins are allowed, drop-in price and cancellation notice (GET…

    Arguments

    NameTypeRequired
    studiostring | numberYes

    Returns GoteamupOfferingType[]

    interface GoteamupPrice {
      decimal: number;
      currencyCode: string;
      symbol: string;
    }
    
    interface GoteamupOfferingType {
      id: string;
      name: string;
      description: string;
      scheduleType: string;
      allowsDropins: boolean;
      dropinPrice: GoteamupPrice | null;
      cancellationNoticeMinutes: number;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.listClassTypes(3707700);
  • listInstructorsLists a studio's instructors with name, picture and bio (GET /api/v2/instructors).

    Arguments

    NameTypeRequired
    studiostring | numberYes

    Returns GoteamupInstructor[]

    interface GoteamupInstructor {
      id: string;
      name: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.listInstructors(3707700);
  • listMembershipsLists the memberships and class packs a studio sells, with type, price and terms (GET /api/v2/memberships).

    Arguments

    NameTypeRequired
    studiostring | numberYes

    Returns GoteamupMembership[]

    interface GoteamupPrice {
      decimal: number;
      currencyCode: string;
      symbol: string;
    }
    
    interface GoteamupMembership {
      id: string;
      name: string;
      /** "recurring_plan" | "pack", the site's own membership type. */
      type: string;
      description: string;
      isDropin: boolean;
      forSale: boolean;
      allowRepeatPurchases: boolean;
      newCustomersOnly: boolean;
      price: GoteamupPrice | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.listMemberships(3707700);
  • listMyBookingsLists the signed-in caller's bookings (TeamUp attendances) at a studio, each with its status and the booked class.

    Arguments

    NameTypeRequired
    studiostring | numberYes

    Returns { bookings: GoteamupBooking[]; warnings: string[] }

    interface GoteamupPrice {
      decimal: number;
      currencyCode: string;
      symbol: string;
    }
    
    interface GoteamupVenue {
      id: string;
      name: string;
      address: string;
      timezone: string;
    }
    
    interface GoteamupInstructor {
      id: string;
      name: string;
    }
    
    interface GoteamupOfferingType {
      id: string;
      name: string;
      description: string;
      scheduleType: string;
      allowsDropins: boolean;
      dropinPrice: GoteamupPrice | null;
      cancellationNoticeMinutes: number;
    }
    
    interface GoteamupClass {
      id: string;
      name: string;
      description: string;
      startsAt: string;
      endsAt: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      attendingCount: number;
      maxOccupancy: number;
      isFull: boolean;
      waitingCount: number;
      registrationsOpenAt: string | null;
      registrationsCloseAt: string | null;
      lateCancelDeadline: string | null;
      venue: GoteamupVenue | null;
      instructors: GoteamupInstructor[];
      offeringType: GoteamupOfferingType | null;
      /** This class's own page, e.g. "https://goteamup.com/p/3707700-kb-fitness-studio/e/109904116-…/". */
      url: string;
    
      checkout: GoteamupCheckout | null;
    }
    
    interface GoteamupCheckout {
      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[];
    }
    
    interface GoteamupBooking {
      id: string;
      /** The site's own attendance status label, verbatim. */
      status: string;
      /** The booked class. */
      class: GoteamupClass | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.listMyBookings(3707700);
  • listScheduleLists a studio's classes over a date range (defaults to the next 14 days).

    Arguments

    NameTypeRequired
    studiostring | numberYes
    range.fromstring
    ISO date/time, inclusive.
    No
    range.tostring
    ISO date/time, inclusive.
    No

    Returns { classes: GoteamupClass[]; warnings: string[] }

    interface GoteamupPrice {
      decimal: number;
      currencyCode: string;
      symbol: string;
    }
    
    interface GoteamupVenue {
      id: string;
      name: string;
      address: string;
      timezone: string;
    }
    
    interface GoteamupInstructor {
      id: string;
      name: string;
    }
    
    interface GoteamupOfferingType {
      id: string;
      name: string;
      description: string;
      scheduleType: string;
      allowsDropins: boolean;
      dropinPrice: GoteamupPrice | null;
      cancellationNoticeMinutes: number;
    }
    
    interface GoteamupClass {
      id: string;
      name: string;
      description: string;
      startsAt: string;
      endsAt: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      attendingCount: number;
      maxOccupancy: number;
      isFull: boolean;
      waitingCount: number;
      registrationsOpenAt: string | null;
      registrationsCloseAt: string | null;
      lateCancelDeadline: string | null;
      venue: GoteamupVenue | null;
      instructors: GoteamupInstructor[];
      offeringType: GoteamupOfferingType | null;
      /** This class's own page, e.g. "https://goteamup.com/p/3707700-kb-fitness-studio/e/109904116-…/". */
      url: string;
    
      checkout: GoteamupCheckout | null;
    }
    
    interface GoteamupCheckout {
      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/goteamup_classes/listSchedule

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.listSchedule(3707700);
  • listVenuesLists a studio's venues with address (GET /api/v2/venues).

    Arguments

    NameTypeRequired
    studiostring | numberYes

    Returns GoteamupVenue[]

    interface GoteamupVenue {
      id: string;
      name: string;
      address: string;
      timezone: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goteamup_classes/listVenues

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.listVenues(3707700);
Act 3
  • bookClassBooks the signed-in caller into a free or membership-covered class (POST /api/v2/events/<id>/register).

    Arguments

    NameTypeRequired
    studiostring | numberYes
    classIdstring | numberYes

    Returns GoteamupBooking

    interface GoteamupPrice {
      decimal: number;
      currencyCode: string;
      symbol: string;
    }
    
    interface GoteamupVenue {
      id: string;
      name: string;
      address: string;
      timezone: string;
    }
    
    interface GoteamupInstructor {
      id: string;
      name: string;
    }
    
    interface GoteamupOfferingType {
      id: string;
      name: string;
      description: string;
      scheduleType: string;
      allowsDropins: boolean;
      dropinPrice: GoteamupPrice | null;
      cancellationNoticeMinutes: number;
    }
    
    interface GoteamupClass {
      id: string;
      name: string;
      description: string;
      startsAt: string;
      endsAt: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      attendingCount: number;
      maxOccupancy: number;
      isFull: boolean;
      waitingCount: number;
      registrationsOpenAt: string | null;
      registrationsCloseAt: string | null;
      lateCancelDeadline: string | null;
      venue: GoteamupVenue | null;
      instructors: GoteamupInstructor[];
      offeringType: GoteamupOfferingType | null;
      /** This class's own page, e.g. "https://goteamup.com/p/3707700-kb-fitness-studio/e/109904116-…/". */
      url: string;
    
      checkout: GoteamupCheckout | null;
    }
    
    interface GoteamupCheckout {
      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[];
    }
    
    interface GoteamupBooking {
      id: string;
      /** The site's own attendance status label, verbatim. */
      status: string;
      /** The booked class. */
      class: GoteamupClass | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.bookClass("<studio>", "<classId>");
  • cancelClassCancels the signed-in caller's booking for a class, reporting the late-cancel deadline (POST /api/v2/events/<id>/unregister).

    Arguments

    NameTypeRequired
    studiostring | numberYes
    classIdstring | numberYes

    Returns GoteamupCancelResult

    interface GoteamupCancelResult {
      cancelled: true;
      lateCancelDeadline: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goteamup_classes/cancelClass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.cancelClass("<studio>", "<classId>");
  • joinWaitlistPuts the signed-in caller on a full class's waitlist (POST /api/v2/events/<id>/join_waitlist).

    Arguments

    NameTypeRequired
    studiostring | numberYes
    classIdstring | numberYes

    Returns GoteamupWaitlistResult

    interface GoteamupWaitlistResult {
      onWaitlist: boolean;
      waitingCount: number | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goteamup_classes.joinWaitlist("<studio>", "<classId>");

Use it from code