Arketa MCP server for AI agents

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

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

Connect

Just Arketa

An MCP server for Arketa 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/arketa
Every site

One MCP server for Arketa 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
  • findStudioFinds an Arketa studio by its booking-page name ("thesilhouettemethod"), its app.arketa.co URL, or the studio's own website that embeds the Arketa…

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaStudio

    interface ArketaStudio {
      id: string;
      widgetName: string;
      currency: string | null;
      timezone: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.findStudio("thesilhouettemethod");
  • getClassReturns one scheduled class by id: description, start and end time, instructor, location and room, capacity, number booked, waitlist length, drop-in…

    Arguments

    NameTypeRequired
    studiostringYes
    classIdstringYes

    Returns ArketaClassDetail

    interface ArketaAddress {
      line1: string | null;
      line2: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      country: string | null;
      cityState: string | null;
      full: string | null;
      lat: number | null;
      lng: number | null;
      googlePlaceId: string | null;
    }
    
    interface ArketaClassDetail {
      id: string;
      name: string;
      description: string | null;
      startTime: string | null;
      endTime: string | null;
      durationMinutes: number | null;
      experienceType: string | null;
      locationType: string | null;
      canceled: boolean;
      instructorIds: string[];
      instructorName: string | null;
      location: (ArketaAddress & { id: string | null; name: string | null }) | null;
      roomId: string | null;
      classTypeId: string | null;
      capacity: number | null;
      totalBooked: number | null;
      waitlistLength: number | null;
      price: number | null;
      credits: number | null;
      intensity: string | null;
      bodyFocus: string | null;
      equipment: string[];
      workoutTypes: string[];
      preparationDirections: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.getClass({ studio: "<studio>", classId: "<classId>" });
  • getMyProfileReturns the signed-in client's own profile at a studio: name, email, phone, birthday, address, home location and ID-verification status.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaMyProfile

    interface ArketaMyProfile {
      id: string;
      firstName: string | null;
      lastName: string | null;
      name: string | null;
      email: string | null;
      phone: string | null;
      birthday: string | null;
      address: Record<string, unknown> | null;
      homeLocationId: string | null;
      idVerificationStatus: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.getMyProfile("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
  • getPrivateSessionReturns one private-session service by id, with the instructors who teach it, the locations and rooms it runs in, and its booking rules.

    Arguments

    NameTypeRequired
    studiostringYes
    serviceIdstringYes

    Returns ArketaPrivateSessionDetail

    interface ArketaAddress {
      line1: string | null;
      line2: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      country: string | null;
      cityState: string | null;
      full: string | null;
      lat: number | null;
      lng: number | null;
      googlePlaceId: string | null;
    }
    
    interface ArketaLocation {
      id: string;
      name: string;
      address: ArketaAddress;
    }
    
    interface ArketaPrivateSessionDetail {
      id: string;
      title: string;
      durationMinutes: number | null;
      price: number | null;
      credits: number | null;
      purchaseType: string | null;
      locationType: string | null;
      description: string | null;
      defaultLocationId: string | null;
      instructors: { id: string; name: string; imageUrl: string | null; bio: string | null }[];
      locations: ArketaLocation[];
      rooms: { id: string; name: string; locationId: string | null; capacity: number | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/arketa/getPrivateSession

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.getPrivateSession({ studio: "<studio>", serviceId: "<serviceId>" });
  • getPrivateSessionAvailabilityReturns which days a private session can be booked with one instructor at one location, from a date to the end of its month, and the open start times…

    Arguments

    NameTypeRequired
    studiostringYes
    serviceIdstringYes
    instructorIdstringYes
    locationIdstringYes
    datestringYes
    timezonestringNo

    Returns ArketaPrivateSessionAvailability

    interface ArketaPrivateSessionAvailability {
      days: { date: string; available: boolean }[];
      times: { startTime: string; label: string | null; instructorId: string | null; locationId: string | null }[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.getPrivateSessionAvailability({
      studio: "<studio>",
      serviceId: "<serviceId>",
      instructorId: "<instructorId>",
      locationId: "<locationId>",
      date: "<date>"
    });
  • listClassesLists a studio's class schedule for a date range, optionally narrowed to a location, class type or instructor: each class's id, name, start time…

    Arguments

    NameTypeRequired
    studiostringYes
    startDatestringYes
    endDatestringYes
    locationIdstringNo
    classTypeIdstringNo
    instructorIdstringNo
    timezonestringNo

    Returns ArketaClass[]

    interface ArketaClassInstructor {
      id: string;
      name: string;
      about: string | null;
      profileImageUrl: string | null;
    }
    
    interface ArketaClass {
      id: string;
      name: string;
      startTime: string | null;
      durationMinutes: number | null;
      experienceType: string | null;
      canceled: boolean;
      instructors: ArketaClassInstructor[];
      locationId: string | null;
      locationName: string | null;
      capacity: number | null;
      totalBooked: number | null;
      isBookable: boolean;
      unavailableReason: string | null;
      waitlistLength: number | null;
      isWaitlistFull: boolean;
      description: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listClasses({
      studio: "vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1",
      startDate: { $daysFromNow: 0 },
      endDate: { $daysFromNow: 14 }
    });
  • listInstructorsLists the instructors who teach at a studio, with id and name, plus photo and bio for those on the next two weeks' schedule.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaInstructor[]

    interface ArketaInstructor {
      id: string;
      name: string;
      about: string | null;
      profileImageUrl: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listInstructors("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
  • listLocationsLists a studio's physical locations: id, name, full address and coordinates.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaLocation[]

    interface ArketaAddress {
      line1: string | null;
      line2: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      country: string | null;
      cityState: string | null;
      full: string | null;
      lat: number | null;
      lng: number | null;
      googlePlaceId: string | null;
    }
    
    interface ArketaLocation {
      id: string;
      name: string;
      address: ArketaAddress;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listLocations("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
  • listMyBookingsLists the signed-in client's upcoming and past class and private-session bookings at a studio, including waitlist spots.

    Arguments

    NameTypeRequired
    widgetNamestringYes

    Returns ArketaBooking[]

    interface ArketaBooking {
      id: string;
      canceled: boolean;
      studioId: string | null;
      classId: string | null;
      className: string | null;
      class: Record<string, unknown> | null;
      objectSnapshot: Record<string, unknown> | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listMyBookings("thesilhouettemethod");
  • listMyPassesLists the signed-in client's class packs and memberships at a studio.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaPass[]

    interface ArketaPass {
      id: string;
      expiresAt: string | null;
      activatesAt: string | null;
      active: boolean;
      offeringId: string | null;
      offeringName: string | null;
      offering: Record<string, unknown> | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listMyPasses("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
  • listOnDemandVideosLists a studio's on-demand video library: its categories, or.

    Arguments

    NameTypeRequired
    studiostringYes
    categorystringNo

    Returns ArketaOnDemandLibrary

    interface ArketaVideoCategory {
      id: string;
      name: string;
      hidden: boolean;
      featured: boolean;
      itemCount: number | null;
      description: string | null;
      previewImageUrl: string | null;
    }
    
    interface ArketaOnDemandVideo {
      id: string;
      name: string;
      description: string | null;
      durationMinutes: number | null;
      instructorIds: string[];
      equipment: string[];
      workoutTypes: string[];
      bodyFocus: string | null;
      intensity: string | null;
      imageUrl: string | null;
      categoryIds: string[];
    }
    
    interface ArketaOnDemandLibrary {
      categories: ArketaVideoCategory[];
      videos: ArketaOnDemandVideo[] | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listOnDemandVideos("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
  • listPricingLists what a studio sells, drop-in classes, class packs, memberships and on-demand subscriptions, with each one's price, credit count, expiry, and…

    Arguments

    NameTypeRequired
    widgetNamestringYes

    Returns ArketaPricingOption[]

    interface ArketaPricingOption {
      id: string;
      name: string;
      type: string | null;
      price: number | null;
      credits: number | null;
      unlimited: boolean;
      subscriptionType: string | null;
      expiresIn: number | null;
      expiresInUnit: string | null;
      newStudentOnly: boolean;
      oneTimeOffer: boolean;
      locationTypes: string[];
      description: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listPricing("thesilhouettemethod");
  • listPrivateSessionsLists the private sessions (one-to-one appointments) a studio offers, with name, length, price and description.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaPrivateSession[]

    interface ArketaPrivateSession {
      id: string;
      title: string;
      durationMinutes: number | null;
      price: number | null;
      priceLabel: string | null;
      purchaseType: string | null;
      category: string | null;
      description: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listPrivateSessions("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
  • listProductsLists the retail products a studio sells through Arketa (apparel, equipment), with price and description.

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaProduct[]

    interface ArketaProduct {
      id: string;
      name: string;
      description: string | null;
      price: number | null;
      isAddon: boolean;
      imageUrls: string[];
      variants: { id: string; label: string | null; price: number | null; quantity: number | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/arketa/listProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listProducts("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
  • listReviewsLists a studio's public client reviews.

    Arguments

    NameTypeRequired
    studiostringYes
    limitnumberNo
    offsetnumberNo

    Returns ArketaReviews

    interface ArketaReviews {
      total: number | null;
      averageRating: number | null;
      reviews: { id: string; authorFirstName: string | null; rating: number | null; text: string | null; createdAt: string | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/arketa/listReviews

    Call it

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

    Arguments

    NameTypeRequired
    studiostringYes

    Returns ArketaScheduleFilters

    interface ArketaNamedRef {
      id: string;
      name: string;
    }
    
    interface ArketaScheduleFilters {
      locations: ArketaNamedRef[];
      classTypes: ArketaNamedRef[];
      instructors: ArketaNamedRef[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.listScheduleFilters("vC7FbNvZ8KQ7YPx3NLcOHgrZzSj1");
Act 5
  • bookClassBooks the signed-in client into a scheduled class using a pack or membership they already own.

    Arguments

    NameTypeRequired
    studiostringYes
    classIdstringYes
    offeringIdstringNo

    Returns ArketaBookingResult

    interface ArketaBookingResult {
      booked: boolean;
      reservationId: string | null;
      orderId: string | null;
      totalCents: number;
      waitlisted: boolean;
      message: string | null;
    }

    HTTP endpoint

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

    Call it

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

    Arguments

    NameTypeRequired
    studiostringYes
    serviceIdstringYes
    isoTimestringYes
    instructorIdstringNo
    locationIdstringNo
    roomIdstringNo
    offeringIdstringNo

    Returns ArketaBookingResult

    interface ArketaBookingResult {
      booked: boolean;
      reservationId: string | null;
      orderId: string | null;
      totalCents: number;
      waitlisted: boolean;
      message: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.bookPrivateSession({
      studio: "<studio>",
      serviceId: "<serviceId>",
      isoTime: "<isoTime>"
    });
  • cancelBookingCancels one of the signed-in caller's class reservations or waitlist spots.

    Arguments

    NameTypeRequired
    reservationIdstringYes

    Returns ArketaActionResult

    interface ArketaActionResult {
      success: boolean;
      message: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.cancelBooking({ reservationId: "<reservationId>" });
  • joinWaitlistPuts the signed-in caller on the waitlist for a full class, optionally with named guests.

    Arguments

    NameTypeRequired
    classIdstringYes
    guestNamesstring[]No

    Returns ArketaActionResult

    interface ArketaActionResult {
      success: boolean;
      message: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.arketa.joinWaitlist({ classId: "<classId>" });
  • updateMyProfileUpdates the signed-in client's studio-specific client fields and marketing email / SMS opt-ins at a studio.

    Arguments

    NameTypeRequired
    studiostringYes
    customFieldsRecord<string, unknown>No
    marketingOptInbooleanNo
    smsOptInbooleanNo

    Returns ArketaProfileUpdateResult

    interface ArketaProfileUpdateResult {
      updated: Array<"customFields" | "communications">;
    }

    HTTP endpoint

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

    Call it

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

Use it from code