Walla MCP server for AI agents

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

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

Connect

Just Walla

An MCP server for Walla 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/walla
Every site

One MCP server for Walla 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
  • enrollWorkshopEnrolls the signed-in client in a workshop or series from listWorkshops using a pass they already own.

    Arguments

    NameTypeRequired
    studiostringYes
    workshopIdnumberYes
    priceIdnumberNo
    spotType"in_person" | "livestream"No
    locationIdnumberNo

    Returns WallaBooking

    interface WallaBooking {
      // UNMEASURED, a paid booking is never completed, so only the reached-and-refused
      // path is proven; no signed-in capture of a real booking exists.
      [field: string]: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/enrollWorkshop

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.enrollWorkshop({
      studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a",
      workshopId: 1
    });
  • findStudioFinds a Walla studio from its own website (the page that embeds the Walla schedule) or its Walla integration id, returning the integration id every…

    Arguments

    NameTypeRequired
    studioRefstringYes

    Returns WallaStudio

    interface WallaStudio {
      integrationId: string;
      name: string;
      slug: string;
      timezone: string;
      currency: string;
      bookingRules: {
        phoneRequired: boolean;
        allowWaitlist: boolean;
        allowLivestream: boolean;
        bookingWindowDays: number;
      };
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.findStudio("<studioRef>");
  • getClassReturns one scheduled class by id: everything listClasses carries, plus its description, assistant instructors, category, waitlist capacity and how…

    Arguments

    NameTypeRequired
    studiostringYes
    classIdnumberYes

    Returns WallaClassDetail

    interface WallaClass {
      id: number;
      name: string;
      start: string;
      end: string;
      durationMins: number;
      instructor: { id: number; name: string } | null;
      location: { id: number; name: string } | null;
      room: string | null;
      capacity: number | null;
      booked: number;
      spotsLeft: number | null;
      waitlisted: number;
      waitlistable: boolean;
      inPerson: boolean;
      livestream: boolean;
      dropInPrice: number | null;
      memberPrice: number | null;
      creditCost: number | null;
      currency: string | null;
    }
    
    interface WallaClassDetail extends WallaClass {
      description: string | null;
      assistants: { id: number; name: string }[];
      waitlistCapacity: number | null;
      bookingWindowOpensPriorDays: number | null;
      category: { id: number; key: string; name: string } | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.getClass({ studio: "<studio>", classId: 1 });
  • getMyProfileReturns the signed-in client's own profile at a studio, passed through verbatim.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaProfile

    interface WallaProfile {
      // The site's own /client fields, passed through verbatim. UNMEASURED, no
      // signed-in capture exists yet (survey ran logged out), so field names are
      // not verified against a real account.
      [field: string]: unknown;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.getMyProfile({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • getPrivateSessionAvailabilityReturns the bookable dates, and the bookable start times on each, for one private session from listPrivateSessions.

    Arguments

    NameTypeRequired
    studiostringYes
    sessionIdnumberYes
    instructorIdnumberNo
    fromDatestringNo

    Returns WallaPrivateSessionAvailability

    interface WallaBookableEntry {
      // One bookable date or slot off bookable_dates|bookable_slots, passed through
      // verbatim. UNMEASURED, no studio tried has had an open slot.
      [field: string]: unknown;
    }
    
    interface WallaPrivateSessionAvailability {
      bookableDates: WallaBookableEntry[];
      bookableSlots: WallaBookableEntry[];
      dateCount: number;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/getPrivateSessionAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.getPrivateSessionAvailability({ studio: "<studio>", sessionId: 1 });
  • listClassCategoriesLists the class categories a studio's schedule can be filtered by (yoga style, sound bath, workshop), each with an id and key.

    Arguments

    NameTypeRequired
    studiostringYes
    windowDaysnumberNo

    Returns WallaCategoryList

    interface WallaCategory {
      id: number;
      key: string;
      name: string;
    }
    
    interface WallaCategoryList {
      categories: WallaCategory[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listClassCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listClassCategories({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listClassesLists a studio's class schedule for a date range (default 7 days), optionally narrowed to locations, instructors or a search term: each class's id…

    Arguments

    NameTypeRequired
    studiostringYes
    fromstringYes
    tostringNo
    locationIdsnumber[]No
    instructorIdsnumber[]No
    searchstringNo

    Returns WallaClassList

    interface WallaClass {
      id: number;
      name: string;
      start: string;
      end: string;
      durationMins: number;
      instructor: { id: number; name: string } | null;
      location: { id: number; name: string } | null;
      room: string | null;
      capacity: number | null;
      booked: number;
      spotsLeft: number | null;
      waitlisted: number;
      waitlistable: boolean;
      inPerson: boolean;
      livestream: boolean;
      dropInPrice: number | null;
      memberPrice: number | null;
      creditCost: number | null;
      currency: string | null;
    }
    
    interface WallaClassList {
      classes: WallaClass[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listClasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listClasses({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listInstructorsLists the instructors at a studio with id, name, photo and bio.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaInstructorList

    interface WallaInstructor {
      id: number;
      name: string;
      bio: string | null;
      photoUrl: string | null;
    }
    
    interface WallaInstructorList {
      instructors: WallaInstructor[];
      warnings: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listInstructors({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listLocationsLists a studio's locations: id, name, street address, coordinates, phone, email, opening hours, rooms and time zone.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaLocationList

    interface WallaLocation {
      id: number;
      name: string;
      slug: string;
      isDefault: boolean;
      timezone: string;
      email: string | null;
      phone: string | null;
      websiteUrl: string | null;
      address: {
        line1: string | null;
        line2: string | null;
        city: string | null;
        region: string | null;
        postalCode: string | null;
        country: string | null;
        latitude: number | null;
        longitude: number | null;
      };
      hours: { day: string; opens: string; closes: string }[];
      rooms: { id: number; name: string; capacity: number | null }[];
      amenities: string[];
    }
    
    interface WallaLocationList {
      locations: WallaLocation[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listLocations({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listMyBookingsLists the signed-in client's class bookings at a studio, passed through verbatim.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaMyBookingList

    interface WallaProfile {
      // The site's own /client fields, passed through verbatim. UNMEASURED, no
      // signed-in capture exists yet (survey ran logged out), so field names are
      // not verified against a real account.
      [field: string]: unknown;
    }
    
    interface WallaMyBookingList {
      bookings: WallaRawRecord[];
      warnings: string[];
    }
    
    interface WallaRawRecord {
      // The site's own /class_instance_bookings or /package_subscriptions fields,
      // passed through verbatim. UNMEASURED for the same reason as WallaProfile.
      [field: string]: unknown;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listMyBookings({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listMyPassesLists the signed-in client's packs, memberships and credits at a studio, passed through verbatim.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaMyPassList

    interface WallaProfile {
      // The site's own /client fields, passed through verbatim. UNMEASURED, no
      // signed-in capture exists yet (survey ran logged out), so field names are
      // not verified against a real account.
      [field: string]: unknown;
    }
    
    interface WallaMyPassList {
      passes: WallaRawRecord[];
      warnings: string[];
    }
    
    interface WallaRawRecord {
      // The site's own /class_instance_bookings or /package_subscriptions fields,
      // passed through verbatim. UNMEASURED for the same reason as WallaProfile.
      [field: string]: unknown;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listMyPasses({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listMyPurchasesLists the signed-in client's purchase history at a studio (the site's /transaction_logs), passed through verbatim.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaMyPurchaseList

    interface WallaProfile {
      // The site's own /client fields, passed through verbatim. UNMEASURED, no
      // signed-in capture exists yet (survey ran logged out), so field names are
      // not verified against a real account.
      [field: string]: unknown;
    }
    
    interface WallaMyPurchaseList {
      purchases: WallaRawRecord[];
      warnings: string[];
    }
    
    interface WallaRawRecord {
      // The site's own /class_instance_bookings or /package_subscriptions fields,
      // passed through verbatim. UNMEASURED for the same reason as WallaProfile.
      [field: string]: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listMyPurchases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listMyPurchases({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listOnDemandVideosLists a studio's on-demand video offerings (the widget's video-on-demand tab).

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaOnDemandVideoList

    interface WallaOnDemandVideo {
      // One /video_offerings record, passed through verbatim. UNMEASURED, no
      // studio tried sells any on-demand videos.
      [field: string]: unknown;
    }
    
    interface WallaOnDemandVideoList {
      videos: WallaOnDemandVideo[];
      videoCount: number;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listOnDemandVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listOnDemandVideos({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listPricingLists what a studio sells, drop-ins, class packs, intro offers and memberships, with each one's price, credit count, expiry, auto-renew terms and who…

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaPricingList

    interface WallaPricingOption {
      id: number;
      name: string;
      description: string | null;
      type: string;
      price: number | null;
      currency: string | null;
      creditCount: number | null;
      paymentType: string | null;
      autoRenew: boolean;
      expiresAfter: { count: number; period: string } | null;
      commitment: { count: number; period: string } | null;
      purchasableBy: string;
      listedOnline: boolean;
      allowOnlineCancellationRequest: boolean;
    }
    
    interface WallaPricingList {
      pricing: WallaPricingOption[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listPricing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listPricing({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listPrivateSessionsLists the private sessions (appointments) a studio offers.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaPrivateSessionList

    interface WallaCategory {
      id: number;
      key: string;
      name: string;
    }
    
    interface WallaPrivateSession {
      id: number;
      name: string;
      description: string | null;
      durationMins: number;
      location: { id: number; name: string } | null;
      category: WallaCategory | null;
      memberPrice: number | null;
      nonMemberPrice: number | null;
      creditCost: number | null;
      currency: string | null;
      instructors: { id: number; name: string }[];
      maxAttendees: number | null;
      bookingWindowOpensPriorDays: number | null;
    }
    
    interface WallaPrivateSessionList {
      sessions: WallaPrivateSession[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listPrivateSessions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listPrivateSessions({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
  • listWorkshopsLists a studio's workshops, series and trainings (multi-session enrollments): name, dates, sessions, instructor, location, capacity, enrolled count…

    Arguments

    NameTypeRequired
    studiostringYes

    Returns WallaWorkshopList

    interface WallaCategory {
      id: number;
      key: string;
      name: string;
    }
    
    interface WallaWorkshop {
      id: number;
      name: string;
      category: WallaCategory | null;
      instructor: { id: number; name: string } | null;
      location: { id: number; name: string } | null;
      startDate: string | null;
      endDate: string | null;
      capacity: number | null;
      booked: number;
      waitlisted: number;
      prices: {
        id: number;
        type: string;
        subtype: string;
        amount: number | null;
        currency: string | null;
      }[];
    }
    
    interface WallaWorkshopList {
      workshops: WallaWorkshop[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/listWorkshops

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.listWorkshops({ studio: "20bbf46e-9f1c-46aa-bcec-431e3b491d7a" });
Act 6
  • bookClassBooks the signed-in client into a class (in person or livestream) via the site's cart, spending whatever pass or credits the site applies…

    Arguments

    NameTypeRequired
    studiostringYes
    classIdnumberYes
    spotType"in_person" | "livestream"No
    locationIdnumberNo

    Returns WallaBooking

    interface WallaBooking {
      // UNMEASURED, a paid booking is never completed, so only the reached-and-refused
      // path is proven; no signed-in capture of a real booking exists.
      [field: string]: unknown;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.bookClass({ studio: "<studio>", classId: 1 });
  • bookPrivateSessionBooks the signed-in client into a private session at a time getPrivateSessionAvailability returned, using a pass they already own.

    Arguments

    NameTypeRequired
    studiostringYes
    sessionIdnumberYes
    instructorIdnumberYes
    startTimestringYes
    spotType"in_person" | "livestream"No
    locationIdnumberNo
    passIdnumberNo

    Returns WallaBooking

    interface WallaBooking {
      // UNMEASURED, a paid booking is never completed, so only the reached-and-refused
      // path is proven; no signed-in capture of a real booking exists.
      [field: string]: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/bookPrivateSession

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.bookPrivateSession({
      studio: "<studio>",
      sessionId: 1,
      instructorId: 1,
      startTime: "<startTime>"
    });
  • cancelBookingCancels one of the signed-in client's class bookings.

    Arguments

    NameTypeRequired
    studiostringYes
    bookingIdnumberYes
    classInstanceIdnumberNo
    acceptLateCancelFeebooleanNo

    Returns WallaCancelResult

    interface WallaProfile {
      // The site's own /client fields, passed through verbatim. UNMEASURED, no
      // signed-in capture exists yet (survey ran logged out), so field names are
      // not verified against a real account.
      [field: string]: unknown;
    }
    
    interface WallaRawRecord {
      // The site's own /class_instance_bookings or /package_subscriptions fields,
      // passed through verbatim. UNMEASURED for the same reason as WallaProfile.
      [field: string]: unknown;
    }
    
    interface WallaCancelResult {
      cancellation: WallaRawRecord;
      feeWarning: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.cancelBooking({ studio: "<studio>", bookingId: 1 });
  • joinWaitlistPuts the signed-in client on the waitlist for a full class.

    Arguments

    NameTypeRequired
    studiostringYes
    classIdnumberYes
    spotType"in_person" | "livestream"No
    locationIdnumberNo

    Returns WallaBooking

    interface WallaBooking {
      // UNMEASURED, a paid booking is never completed, so only the reached-and-refused
      // path is proven; no signed-in capture of a real booking exists.
      [field: string]: unknown;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.joinWaitlist({ studio: "<studio>", classId: 1 });
  • requestMembershipCancellationSends the studio the signed-in client's request to cancel one of their memberships, with a reason.

    Arguments

    NameTypeRequired
    studiostringYes
    passIdnumberYes
    reason| "bad_experience" | "class_times_don't_work_for_my_schedule" | "classes_aren't_for_me" | "financial" | "injury" | "maternity_leave" | "membership_change" | "moving" | "other" | "vacation"Yes
    reasonOtherstringNo

    Returns WallaCancellationRequest

    interface WallaProfile {
      // The site's own /client fields, passed through verbatim. UNMEASURED, no
      // signed-in capture exists yet (survey ran logged out), so field names are
      // not verified against a real account.
      [field: string]: unknown;
    }
    
    interface WallaRawRecord {
      // The site's own /class_instance_bookings or /package_subscriptions fields,
      // passed through verbatim. UNMEASURED for the same reason as WallaProfile.
      [field: string]: unknown;
    }
    
    interface WallaCancellationRequest {
      request: WallaRawRecord;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/requestMembershipCancellation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.requestMembershipCancellation({ studio: "<studio>", passId: 1, reason: "<reason>" });
  • updateMyProfileEdits the signed-in client's own profile at a studio (name, phone, address, emergency contact), the way the widget's account screen does.

    Arguments

    NameTypeRequired
    studiostringYes
    firstNamestringNo
    lastNamestringNo
    phoneNumberstringNo
    phoneNumberTypestringNo
    address{ address1: string; address2?: string; city: string; province: string; postalCode: string; countryCode: string; }No

    Returns WallaProfile

    interface WallaProfile {
      // The site's own /client fields, passed through verbatim. UNMEASURED, no
      // signed-in capture exists yet (survey ran logged out), so field names are
      // not verified against a real account.
      [field: string]: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walla/updateMyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walla.updateMyProfile({ studio: "<studio>" });

Use it from code