Punchpass MCP server for AI agents

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

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

Connect

Just Punchpass

An MCP server for Punchpass 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/punchpass
Every site

One MCP server for Punchpass 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 16
  • getCalendarFeedReturns a studio's subscribable iCal feed url and its parsed events.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassCalendarFeed

    interface PunchpassCalendarEvent {
      /** The class or series id, for getClass / getSeries. */
      id: string | null;
      kind: "class" | "series" | null;
      name: string;
      /** Local wall-clock "YYYY-MM-DDTHH:MM" in the feed's timeZone. */
      start: string;
      end: string | null;
      location: string | null;
      /** Livestream join links are removed. */
      description: string | null;
      url: string | null;
    }
    
    interface PunchpassCalendarFeed {
      orgId: string;
      subdomain: string;
      /** Subscribable in any calendar app. */
      feedUrl: string;
      timeZone: string | null;
      events: PunchpassCalendarEvent[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/getCalendarFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getCalendarFeed("myyogacc");
  • getClassGets one class by the id getSchedule returned.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    classIdstring | numberYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassClass

    interface PunchpassClass {
      id: string;
      name: string;
      instructor: string | null;
      date: string;
      /** Local 24h start, "HH:MM"; null when the page's wording did not parse. */
      start: string | null;
      durationMinutes: number | null;
      location: string | null;
      online: boolean;
      description: string | null;
      spotsLeft: number | null;
      full: boolean;
      waitlist: boolean;
      canceled: boolean;
      /** "openForm" and "closed" are declared but unmeasured, every class sampled
       * so far required a sign-in. */
      booking: "signInRequired" | "openForm" | "closed";
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getClass("<studio>", "<classId>");
  • getMyClassHistoryLists the classes and series the signed-in caller has attended at a studio, with dates.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassMemberList

    interface PunchpassScheduledClass {
      /** The class id getClass and bookClass take; null for a canceled class. */
      id: string | null;
      name: string;
      date: string;
      /** Local wall-clock start, "YYYY-MM-DDTHH:MM". */
      start: string;
      /** With the studio's UTC offset, when the page names it. */
      startsAt: string | null;
      durationMinutes: number | null;
      instructor: string | null;
      location: string | null;
      online: boolean;
      canceled: boolean;
      free: boolean;
      spotsLeft: number | null;
      waitlist: boolean;
      badges: string[];
      url: string | null;
    }
    
    interface PunchpassMemberList {
      orgId: string;
      subdomain: string;
      /** Rows as the studio's calendar list renders them (same shape as getSchedule's). */
      classes: PunchpassScheduledClass[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/getMyClassHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getMyClassHistory("myyogacc");
  • getMyProfileGets the signed-in caller's own Punchpass account (needs the caller signed in): email and every visible field of the app.punchpass.com account form…

    Arguments

    None.

    Returns PunchpassProfile

    interface PunchpassProfile {
      /** The account's email, when the form shows it. */
      email: string | null;
      /** Every visible account-form field, keyed by the site's own name (first_name, …). Never a password or token. */
      fields: Record<string, string>;
      /** The form's resource name, e.g. "account". */
      resource: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getMyProfile();
  • getPassGets one pass or membership's full terms by the id listPasses returned (kind is found when omitted).

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    passIdstring | numberYes
    kind"pass" | "membership"No
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassPassDetail

    interface PunchpassPassDetail {
      id: string;
      kind: "pass" | "membership";
      name: string;
      description: string | null;
      /** Dollars, no currency symbol; a membership's per-payment amount. */
      price: string | null;
      /** A pass's expiry, e.g. "1 year". */
      expiresAfter: string | null;
      /** A membership's charge interval, e.g. "Every 4 weeks". */
      billingPeriod: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/getPass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getPass("<studio>", "<passId>");
  • getScheduleLists a studio's upcoming classes from a start date.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    options.fromstring
    First day, YYYY-MM-DD.
    No
    options.tostring
    Last day, YYYY-MM-DD, inclusive.
    No
    options.coursesstring[]
    Ids from listScheduleFilters.
    No
    options.locationsstring[]No
    options.instructorsstring[]No
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassSchedule

    interface PunchpassScheduledClass {
      /** The class id getClass and bookClass take; null for a canceled class. */
      id: string | null;
      name: string;
      date: string;
      /** Local wall-clock start, "YYYY-MM-DDTHH:MM". */
      start: string;
      /** With the studio's UTC offset, when the page names it. */
      startsAt: string | null;
      durationMinutes: number | null;
      instructor: string | null;
      location: string | null;
      online: boolean;
      canceled: boolean;
      free: boolean;
      spotsLeft: number | null;
      waitlist: boolean;
      badges: string[];
      url: string | null;
    }
    
    interface PunchpassSchedule {
      orgId: string;
      subdomain: string;
      classes: PunchpassScheduledClass[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getSchedule("myyogacc");
  • getSeriesGets one series by id, title, instructor, date range, full description, price, spots left and the class id of every session (GET…

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    seriesIdstring | numberYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassSeries

    interface PunchpassSeriesSession {
      index: number;
      classId: string;
      date: string;
      start: string | null;
      durationMinutes: number | null;
    }
    
    interface PunchpassSeries {
      id: string;
      title: string;
      instructor: string | null;
      startDate: string | null;
      endDate: string | null;
      description: string | null;
      price: string | null;
      spotsLeft: number | null;
      sessions: PunchpassSeriesSession[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/getSeries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getSeries("<studio>", "<seriesId>");
  • getStudioGets one studio's public profile.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassStudio

    interface PunchpassAddress {
      street: string | null;
      locality: string | null;
      region: string | null;
      postalCode: string | null;
      country: string | null;
    }
    
    interface PunchpassStudio {
      orgId: string;
      subdomain: string;
      name: string;
      website: string | null;
      scheduleUrl: string;
      logoUrl: string | null;
      welcome: string | null;
      address: PunchpassAddress | null;
      sections: { passes: boolean; instructors: boolean; appointments: boolean; series: boolean };
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.getStudio("myyogacc");
  • listAppointmentSlotsLists a studio's bookable private-session and appointment times.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassAppointmentSlots

    interface PunchpassScheduledClass {
      /** The class id getClass and bookClass take; null for a canceled class. */
      id: string | null;
      name: string;
      date: string;
      /** Local wall-clock start, "YYYY-MM-DDTHH:MM". */
      start: string;
      /** With the studio's UTC offset, when the page names it. */
      startsAt: string | null;
      durationMinutes: number | null;
      instructor: string | null;
      location: string | null;
      online: boolean;
      canceled: boolean;
      free: boolean;
      spotsLeft: number | null;
      waitlist: boolean;
      badges: string[];
      url: string | null;
    }
    
    interface PunchpassAppointmentSlots {
      orgId: string;
      subdomain: string;
      /** false when the studio does not publish a timeslot page. */
      published: boolean;
      /** Each slot's id is a class id: getClass reads it, bookClass books it. */
      slots: PunchpassScheduledClass[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/listAppointmentSlots

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listAppointmentSlots("myyogacc");
  • listInstructorsLists a studio's instructors.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassInstructors

    interface PunchpassInstructor {
      name: string;
      /** The card's short text, credentials and styles, one line per block. */
      headline: string | null;
      bio: string | null;
      photoUrl: string | null;
    }
    
    interface PunchpassInstructors {
      orgId: string;
      subdomain: string;
      /** false when the studio does not publish an instructors page. */
      published: boolean;
      instructors: PunchpassInstructor[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listInstructors("myyogacc");
  • listMyChildrenLists the children on the signed-in caller's family account at one studio (needs the caller signed in) from the studio's member children page, as…

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassMemberRows

    interface PunchpassMemberRow {
      /** Visible text of each cell (a table row) or of the item (a list). */
      cells: string[];
      /** Absolute hrefs inside the row; pass, class or child ids live in them. */
      links: string[];
    }
    
    interface PunchpassMemberRows {
      orgId: string;
      subdomain: string;
      /** The page's rows as rendered; the signed-in markup is unmeasured, so no field names are guessed. */
      rows: PunchpassMemberRow[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/listMyChildren

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listMyChildren("myyogacc");
  • listMyPassesLists the signed-in caller's passes and memberships at one studio (needs the caller signed in) from the studio's member memberships page, as rows of…

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassMemberRows

    interface PunchpassMemberRow {
      /** Visible text of each cell (a table row) or of the item (a list). */
      cells: string[];
      /** Absolute hrefs inside the row; pass, class or child ids live in them. */
      links: string[];
    }
    
    interface PunchpassMemberRows {
      orgId: string;
      subdomain: string;
      /** The page's rows as rendered; the signed-in markup is unmeasured, so no field names are guessed. */
      rows: PunchpassMemberRow[];
      warnings: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listMyPasses("myyogacc");
  • listMyReservationsLists the signed-in caller's upcoming reservations and waitlist entries at a studio.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassMemberList

    interface PunchpassScheduledClass {
      /** The class id getClass and bookClass take; null for a canceled class. */
      id: string | null;
      name: string;
      date: string;
      /** Local wall-clock start, "YYYY-MM-DDTHH:MM". */
      start: string;
      /** With the studio's UTC offset, when the page names it. */
      startsAt: string | null;
      durationMinutes: number | null;
      instructor: string | null;
      location: string | null;
      online: boolean;
      canceled: boolean;
      free: boolean;
      spotsLeft: number | null;
      waitlist: boolean;
      badges: string[];
      url: string | null;
    }
    
    interface PunchpassMemberList {
      orgId: string;
      subdomain: string;
      /** Rows as the studio's calendar list renders them (same shape as getSchedule's). */
      classes: PunchpassScheduledClass[];
      warnings: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listMyReservations("myyogacc");
  • listPassesLists the passes, class packs and memberships a studio sells.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassPasses

    interface PunchpassPass {
      id: string;
      kind: "pass" | "membership";
      name: string;
      /** Dollars, no currency symbol, e.g. "24". */
      price: string;
      /** e.g. "every 4 weeks"; null for a one-time pass. */
      billingPeriod: string | null;
      purchaseUrl: string;
    }
    
    interface PunchpassPasses {
      orgId: string;
      subdomain: string;
      passes: PunchpassPass[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/listPasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listPasses("myyogacc");
  • listScheduleFiltersLists what a studio's schedule can be filtered by.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassScheduleFilters

    interface PunchpassFilterOption {
      id: string;
      name: string;
    }
    
    interface PunchpassScheduleFilters {
      orgId: string;
      subdomain: string;
      courses: PunchpassFilterOption[];
      locations: PunchpassFilterOption[];
      instructors: PunchpassFilterOption[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/punchpass/listScheduleFilters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listScheduleFilters(15280);
  • listSeriesLists a studio's upcoming multi-session series and workshops.

    Arguments

    NameTypeRequired
    studioPunchpassStudioArgYes
    /** A studio: its <studio>.punchpass.com subdomain ("myyogacc"), any punchpass url of it, or its numeric org id (15280). */
    type PunchpassStudioArg = string | number;

    Returns PunchpassSeriesSummary[]

    interface PunchpassSeriesSummary {
      id: string;
      title: string;
      instructor: string | null;
      startDate: string | null;
      endDate: string | null;
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.punchpass.listSeries("myyogacc");

Use it from code