Zen Planner MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Zen Planner: 13 typed functions through one MCP server. No Zen Planner API key needed.
- Site
- zenplanner.com
- Functions
- 13
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Zen Planner 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/zen_plannerOne MCP server for Zen Planner 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.
findStudioFinds a studio by name or by its own sites.zenplanner.com URL, and returns the slug every other function needs.Arguments
Name Type Required querystringThe studio's name, or its own sites.zenplanner.com URL/hostname, e.g. "10th Planet San Antonio" or "10psanantonio.sites.zenplanner.com".Yes Returns
ZenPlannerStudiointerface ZenPlannerStudio { /** The studio's subdomain label, e.g. "10psanantonio". Pass this as `slug` to every other function. */ slug: string; /** The studio's real name, read off its own calendar page. */ name: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/findStudioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.findStudio({ query: "10psanantonio.sites.zenplanner.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.findStudio({"query": "10psanantonio.sites.zenplanner.com"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/findStudio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"10psanantonio.sites.zenplanner.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.findStudio({ query: "10psanantonio.sites.zenplanner.com" });getClassDetailsReturns one class occurrence's own detail page.Arguments
Name Type Required slugstringThe studio's subdomain label.Yes appointmentIdstringAn appointmentId GUID, read off listScheduleSlots or listClasses.Yes Returns
ZenPlannerClassDetailinterface ZenPlannerClassDetail { className: string; description: string | null; /** "YYYY-MM-DD" */ date: string; startTime: string; endTime: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/getClassDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.getClassDetails({ slug: "<slug>", appointmentId: "<appointmentId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.getClassDetails({"slug": "<slug>", "appointmentId": "<appointmentId>"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/getClassDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"<slug>","appointmentId":"<appointmentId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.getClassDetails({ slug: "<slug>", appointmentId: "<appointmentId>" });getMemberInfoReturns the signed-in member's profile including name, email, membership status and credits.Arguments
Name Type Required personIdstringThe member's own Zen Planner person id.Yes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/getMemberInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.getMemberInfo({ personId: "<personId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.getMemberInfo({"personId": "<personId>"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/getMemberInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"personId":"<personId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.getMemberInfo({ personId: "<personId>" });getMembershipStatusReturns details about the caller's current membership, credits remaining and renewal date.Arguments
Name Type Required personIdstringThe member's own Zen Planner person id.Yes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/getMembershipStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.getMembershipStatus({ personId: "<personId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.getMembershipStatus({"personId": "<personId>"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/getMembershipStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"personId":"<personId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.getMembershipStatus({ personId: "<personId>" });getPriceFinds one membership or drop-in pricing option by name or category, e.g. a drop-in rate or a monthly package.Arguments
Name Type Required slugstringThe studio's subdomain label.Yes querystringA membership or drop-in option's name or category, e.g. "drop in", "monthly unlimited".Yes Returns
ZenPlannerMembershipOptioninterface ZenPlannerMembershipOption { /** The option's own display name, price stripped, e.g. "Monthly Unlimited Jiu Jitsu". */ name: string; /** The category heading above it, e.g. "Adult Jiu Jitsu Memberships", "Day Passes". */ category: string; /** Dollars. */ price: number; /** The site's own one-line description, e.g. "Unlimited classes", "10 classes". */ unitsDescription: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/getPriceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.getPrice({ slug: "10psanantonio", query: "drop in" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.getPrice({"slug": "10psanantonio", "query": "drop in"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/getPrice \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"10psanantonio","query":"drop in"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.getPrice({ slug: "10psanantonio", query: "drop in" });listClassesLists the distinct classes a studio currently offers.Arguments
Name Type Required slugstringThe studio's subdomain label. findStudio returns this.Yes Returns
ZenPlannerClassOffering[]interface ZenPlannerClassOffering { className: string; /** The site's own description text, or null when the class has none. */ description: string | null; /** Computed from one occurrence's start/end time; null when unparseable. */ durationMinutes: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/listClassesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.listClasses({ slug: "10psanantonio" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.listClasses({"slug": "10psanantonio"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/listClasses \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"10psanantonio"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.listClasses({ slug: "10psanantonio" });listMyBookingsLists the signed-in member's own appointments and class reservations, returned raw from the member app's API.Arguments
None.
HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/listMyBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.listMyBookings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.listMyBookings())curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/listMyBookings \ -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.zen_planner.listMyBookings();listPackagesLists a studio's membership and drop-in pricing options, grouped by category, from its public sign-up page.Arguments
Name Type Required slugstringThe studio's subdomain label.Yes Returns
ZenPlannerMembershipOption[]interface ZenPlannerMembershipOption { /** The option's own display name, price stripped, e.g. "Monthly Unlimited Jiu Jitsu". */ name: string; /** The category heading above it, e.g. "Adult Jiu Jitsu Memberships", "Day Passes". */ category: string; /** Dollars. */ price: number; /** The site's own one-line description, e.g. "Unlimited classes", "10 classes". */ unitsDescription: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/listPackagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.listPackages({ slug: "10psanantonio" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.listPackages({"slug": "10psanantonio"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/listPackages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"10psanantonio"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.listPackages({ slug: "10psanantonio" });listScheduleSlotsLists a studio's publicly-viewable class calendar.Arguments
Name Type Required slugstringThe studio's subdomain label, e.g. "10psanantonio" (the part before ".sites.zenplanner.com"). findStudio returns this.Yes Returns
ZenPlannerScheduleSlot[]interface ZenPlannerScheduleSlot { appointmentId: string; /** "YYYY-MM-DD" */ date: string; /** The site's own time string, e.g. "6:00 AM". */ time: string; className: string; checkout?: ZenPlannerCheckout | null; } interface ZenPlannerCheckout { 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/zen_planner/listScheduleSlotsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.listScheduleSlots({ slug: "10psanantonio" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.listScheduleSlots({"slug": "10psanantonio"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/listScheduleSlots \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"10psanantonio"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.listScheduleSlots({ slug: "10psanantonio" });searchScheduleSearches a studio's public calendar by class name, day of week or an exact date.Arguments
Name Type Required slugstringThe studio's subdomain label. findStudio returns this.Yes classTypestringCase-insensitive substring match against the class's own name, e.g. "jiu jitsu".No dayOfWeekstring | numberA day name ("Monday") or its 0-6 index (Sunday = 0).No datestringAn exact "YYYY-MM-DD" date.No Returns
ZenPlannerScheduleSlot[]interface ZenPlannerScheduleSlot { appointmentId: string; /** "YYYY-MM-DD" */ date: string; /** The site's own time string, e.g. "6:00 AM". */ time: string; className: string; checkout?: ZenPlannerCheckout | null; } interface ZenPlannerCheckout { 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/zen_planner/searchScheduleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.searchSchedule({ slug: "10psanantonio", classType: "jiu jitsu" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.searchSchedule({"slug": "10psanantonio", "classType": "jiu jitsu"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/searchSchedule \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"10psanantonio","classType":"jiu jitsu"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.searchSchedule({ slug: "10psanantonio", classType: "jiu jitsu" });
bookClassReserves one class occurrence for the signed-in member (an appointmentId from listScheduleSlots, their personId, optionally a membershipId they…Arguments
Name Type Required appointmentIdstringThe class occurrence, from listScheduleSlots' appointmentId.Yes personIdstringThe member's own Zen Planner person id.Yes membershipIdstringA membership the member already holds to spend; omitted lets the site pick.No HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/bookClassCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.bookClass({ appointmentId: "<appointmentId>", personId: "<personId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.bookClass({ "appointmentId": "<appointmentId>", "personId": "<personId>" }))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/bookClass \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"appointmentId":"<appointmentId>","personId":"<personId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.bookClass({ appointmentId: "<appointmentId>", personId: "<personId>" });cancelBookingCancels one of the signed-in member's reservations by its reservation id; returned raw.Arguments
Name Type Required reservationIdstringThe reservation id, from listMyBookings.Yes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/cancelBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.cancelBooking({ reservationId: "<reservationId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.cancelBooking({"reservationId": "<reservationId>"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/cancelBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"reservationId":"<reservationId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.cancelBooking({ reservationId: "<reservationId>" });updateMemberInfoUpdates the signed-in member's profile information including name, email and preferences.Arguments
Name Type Required personIdstringThe member's own Zen Planner person id.Yes fieldsRecord<string, unknown>The fields to change, in the site's own person shape (e.g. { email, phone, address1 }).Yes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zen_planner/updateMemberInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zen_planner.updateMemberInfo({ personId: "<personId>", fields: "<fields>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zen_planner.updateMemberInfo({"personId": "<personId>", "fields": "<fields>"}))curl -X POST https://api.bowmark.ai/v1/sites/zen_planner/updateMemberInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"personId":"<personId>","fields":"<fields>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zen_planner.updateMemberInfo({ personId: "<personId>", fields: "<fields>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/zen_planner/<function> - OpenAPI
/v1/sites/zen_planner/openapi.json