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.
- Site
- punchpass.com
- Functions
- 16
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/punchpassOne MCP server for Punchpass 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.
getCalendarFeedReturns a studio's subscribable iCal feed url and its parsed events.Arguments
Name Type Required 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
PunchpassCalendarFeedinterface 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/getCalendarFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getCalendarFeed("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getCalendarFeed("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/getCalendarFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.getCalendarFeed("myyogacc");getClassGets one class by the id getSchedule returned.Arguments
Name Type Required 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
PunchpassClassinterface 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/getClassCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getClass("<studio>", "<classId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getClass("<studio>", "<classId>"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/getClass \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"<studio>","classId":"<classId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.getClass("<studio>", "<classId>");getMyClassHistoryLists the classes and series the signed-in caller has attended at a studio, with dates.Arguments
Name Type Required 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
PunchpassMemberListinterface 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/getMyClassHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getMyClassHistory("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getMyClassHistory("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/getMyClassHistory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
PunchpassProfileinterface 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/getMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getMyProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getMyProfile())curl -X POST https://api.bowmark.ai/v1/sites/punchpass/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.punchpass.getMyProfile();getPassGets one pass or membership's full terms by the id listPasses returned (kind is found when omitted).Arguments
Name Type Required 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
PunchpassPassDetailinterface 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/getPassCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getPass("<studio>", "<passId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getPass("<studio>", "<passId>"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/getPass \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"<studio>","passId":"<passId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.getPass("<studio>", "<passId>");getScheduleLists a studio's upcoming classes from a start date.Arguments
Name Type Required studioPunchpassStudioArgYes options.fromstringFirst day, YYYY-MM-DD.No options.tostringLast 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
PunchpassScheduleinterface 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/getScheduleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getSchedule("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getSchedule("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/getSchedule \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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
PunchpassSeriesinterface 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/getSeriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getSeries("<studio>", "<seriesId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getSeries("<studio>", "<seriesId>"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/getSeries \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"<studio>","seriesId":"<seriesId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.getSeries("<studio>", "<seriesId>");getStudioGets one studio's public profile.Arguments
Name Type Required 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
PunchpassStudiointerface 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/getStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.getStudio("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.getStudio("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/getStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.getStudio("myyogacc");listAppointmentSlotsLists a studio's bookable private-session and appointment times.Arguments
Name Type Required 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
PunchpassAppointmentSlotsinterface 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/listAppointmentSlotsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listAppointmentSlots("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listAppointmentSlots("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listAppointmentSlots \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.listAppointmentSlots("myyogacc");listInstructorsLists a studio's instructors.Arguments
Name Type Required 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
PunchpassInstructorsinterface 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/listInstructorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listInstructors("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listInstructors("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listInstructors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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
PunchpassMemberRowsinterface 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/listMyChildrenCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listMyChildren("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listMyChildren("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listMyChildren \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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
PunchpassMemberRowsinterface 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/listMyPassesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listMyPasses("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listMyPasses("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listMyPasses \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.listMyPasses("myyogacc");listMyReservationsLists the signed-in caller's upcoming reservations and waitlist entries at a studio.Arguments
Name Type Required 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
PunchpassMemberListinterface 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/listMyReservationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listMyReservations("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listMyReservations("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listMyReservations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.listMyReservations("myyogacc");listPassesLists the passes, class packs and memberships a studio sells.Arguments
Name Type Required 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
PunchpassPassesinterface 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/listPassesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listPasses("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listPasses("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listPasses \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.listPasses("myyogacc");listScheduleFiltersLists what a studio's schedule can be filtered by.Arguments
Name Type Required 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
PunchpassScheduleFiltersinterface 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/listScheduleFiltersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listScheduleFilters(15280);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listScheduleFilters(15280))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listScheduleFilters \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":15280}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.listScheduleFilters(15280);listSeriesLists a studio's upcoming multi-session series and workshops.Arguments
Name Type Required 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/listSeriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.punchpass.listSeries("myyogacc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.punchpass.listSeries("myyogacc"))curl -X POST https://api.bowmark.ai/v1/sites/punchpass/listSeries \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"studio":"myyogacc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.punchpass.listSeries("myyogacc");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/punchpass/<function> - OpenAPI
/v1/sites/punchpass/openapi.json