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.

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

Connect

Just Zen Planner

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_planner
Every site

One 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/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 10
  • findStudioFinds a studio by name or by its own sites.zenplanner.com URL, and returns the slug every other function needs.

    Arguments

    NameTypeRequired
    querystring
    The studio's name, or its own sites.zenplanner.com URL/hostname, e.g. "10th Planet San Antonio" or "10psanantonio.sites.zenplanner.com".
    Yes

    Returns ZenPlannerStudio

    interface 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/findStudio

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.zen_planner.findStudio({ query: "10psanantonio.sites.zenplanner.com" });
  • getClassDetailsReturns one class occurrence's own detail page.

    Arguments

    NameTypeRequired
    slugstring
    The studio's subdomain label.
    Yes
    appointmentIdstring
    An appointmentId GUID, read off listScheduleSlots or listClasses.
    Yes

    Returns ZenPlannerClassDetail

    interface 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/getClassDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    personIdstring
    The member's own Zen Planner person id.
    Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/zen_planner/getMemberInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.zen_planner.getMemberInfo({ personId: "<personId>" });
  • getMembershipStatusReturns details about the caller's current membership, credits remaining and renewal date.

    Arguments

    NameTypeRequired
    personIdstring
    The member's own Zen Planner person id.
    Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/zen_planner/getMembershipStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    slugstring
    The studio's subdomain label.
    Yes
    querystring
    A membership or drop-in option's name or category, e.g. "drop in", "monthly unlimited".
    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/getPrice

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.zen_planner.getPrice({ slug: "10psanantonio", query: "drop in" });
  • listClassesLists the distinct classes a studio currently offers.

    Arguments

    NameTypeRequired
    slugstring
    The 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/listClasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listMyBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    slugstring
    The 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/listPackages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.zen_planner.listPackages({ slug: "10psanantonio" });
  • listScheduleSlotsLists a studio's publicly-viewable class calendar.

    Arguments

    NameTypeRequired
    slugstring
    The 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/listScheduleSlots

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    slugstring
    The studio's subdomain label. findStudio returns this.
    Yes
    classTypestring
    Case-insensitive substring match against the class's own name, e.g. "jiu jitsu".
    No
    dayOfWeekstring | number
    A day name ("Monday") or its 0-6 index (Sunday = 0).
    No
    datestring
    An 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/searchSchedule

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.zen_planner.searchSchedule({ slug: "10psanantonio", classType: "jiu jitsu" });
Act 3
  • bookClassReserves one class occurrence for the signed-in member (an appointmentId from listScheduleSlots, their personId, optionally a membershipId they…

    Arguments

    NameTypeRequired
    appointmentIdstring
    The class occurrence, from listScheduleSlots' appointmentId.
    Yes
    personIdstring
    The member's own Zen Planner person id.
    Yes
    membershipIdstring
    A membership the member already holds to spend; omitted lets the site pick.
    No

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    reservationIdstring
    The reservation id, from listMyBookings.
    Yes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/zen_planner/cancelBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.zen_planner.cancelBooking({ reservationId: "<reservationId>" });
  • updateMemberInfoUpdates the signed-in member's profile information including name, email and preferences.

    Arguments

    NameTypeRequired
    personIdstring
    The 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/updateMemberInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.zen_planner.updateMemberInfo({ personId: "<personId>", fields: "<fields>" });

Use it from code