Setmore MCP server for AI agents

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

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

Connect

Just Setmore

An MCP server for Setmore 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/setmore
Every site

One MCP server for Setmore 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 13
  • checkPromoCodeChecks whether a promo code is valid at a business for a given order amount and returns the discount it would give (type, value and the calculated…

    Arguments

    NameTypeRequired
    businessstringYes
    codestringYes
    subAmountnumber
    The order amount before the discount, in the business's currency.
    Yes

    Returns SetmorePromoCode

    interface SetmorePromoCode {
      valid: boolean;
      promoCodeId: string | null; // set when valid
      name: string | null;
      discountType: string | null;
      discountValue: number | null;
      calculatedDiscount: number | null;
      errorCode: string | null; // set when !valid, e.g. "PROMO_CODE_NOT_FOUND"
      message: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/checkPromoCode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.checkPromoCode({
      business: "onboarding",
      code: "BOGUSCODE123",
      subAmount: 100
    });
  • findBusinessFinds a Setmore business from what a caller actually holds -- its booking-page link (<slug>.setmore.com…

    Arguments

    NameTypeRequired
    businessstringYes

    Returns SetmoreBusiness

    interface SetmoreBusiness {
      id: string;
      slug: string;
      name: string;
      businessType: string | null;
      aboutUs: string | null;
      timeZone: string | null;
      displayPhoneNumber: string | null;
      email: string | null;
      currencyCode: string | null;
      website: string | null;
      city: string | null;
      state: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/findBusiness

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.findBusiness("onboarding");
  • getAvailabilityReturns the open appointment times for one or more services (ids from listServices) at a business between from and to (default the next 14 days), in…

    Arguments

    NameTypeRequired
    businessstringYes
    serviceIdstringNo
    serviceIdsstring[]No
    fromstring
    ISO date or instant; default now.
    No
    tostring
    Default from + 14 days.
    No
    timeZonestring
    IANA; default the business's own.
    No
    staffIdstringNo

    Returns SetmoreAvailability

    interface SetmoreSlot {
      startsAt: string; // ISO instant, UTC
      displayDateTime: string | null; // the site's label, in the business's time zone
      staffId: string | null;
    }
    
    interface SetmoreAvailability {
      companyId: string;
      durationMins: number;
      from: string;
      to: string;
      timeZone: string;
      slots: SetmoreSlot[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/getAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.getAvailability({ business: "<business>" });
  • getBookingReads a guest's booking back from the confirmation id in its confirmation email: appointment, class or event, service, staff member, start and end…

    Arguments

    NameTypeRequired
    businessstringYes
    confirmationIdstring
    The confirmation id in the guest's confirmation email.
    Yes

    Returns SetmoreBookingLookup

    interface SetmoreBooking {
      kind: "service" | "class" | "event";
      id: string;
      confirmationId: string | null;
      serviceId: string | null;
      serviceTitle: string | null;
      classId: string | null; // a class booking's class, in place of a service
      classTitle: string | null;
      staffId: string | null;
      staffName: string | null;
      startsAt: string | null; // ISO instant, UTC
      endsAt: string | null;
      timeZone: string | null;
      cost: number | null;
      transactionId: string | null;
      notes: string | null;
      isDeleted: boolean; // true once cancelled
    }
    
    interface SetmoreBookingLookup {
      companyId: string;
      confirmationId: string;
      bookings: SetmoreBooking[]; // empty when the business has no booking under that id
      count: number; // bookings.length
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/getBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.getBooking({
      business: "<business>",
      confirmationId: "<confirmationId>"
    });
  • getBookingFormReturns what a business asks a guest for at checkout -- whether email, phone and address are required or shown, its own custom questions, and its…

    Arguments

    NameTypeRequired
    businessstringYes
    serviceIdstring
    A service id from listServices.
    No

    Returns SetmoreBookingForm

    interface SetmoreCheckoutField {
      isRequired: boolean;
      isVisible: boolean;
    }
    
    interface SetmoreCustomField {
      name: string;
      isRequired: boolean;
      isVisible: boolean;
      fieldId: string;
    }
    
    interface SetmoreTermsAndConditions {
      label: string | null;
      url: string | null;
      showCheckbox: boolean;
    }
    
    interface SetmoreFormField {
      id: string;
      title: string;
      type: string;
      required: boolean;
      order: number | null;
      options: string[];
    }
    
    interface SetmoreIntakeForm {
      id: string;
      title: string;
      fields: SetmoreFormField[];
    }
    
    interface SetmoreBookingForm {
      email: SetmoreCheckoutField | null;
      phone: SetmoreCheckoutField | null;
      address: SetmoreCheckoutField | null;
      customFields: SetmoreCustomField[];
      termsAndConditions: SetmoreTermsAndConditions | null;
      forms: SetmoreIntakeForm[]; // the named service's intake form, if it has one
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/getBookingForm

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.getBookingForm("onboarding");
  • getBusinessReturns a business's own profile from its booking page: name, about text, business type, address, phone, email, website, time zone, opening hours by…

    Arguments

    NameTypeRequired
    businessstringYes

    Returns SetmoreBusinessDetail

    interface SetmoreBusiness {
      id: string;
      slug: string;
      name: string;
      businessType: string | null;
      aboutUs: string | null;
      timeZone: string | null;
      displayPhoneNumber: string | null;
      email: string | null;
      currencyCode: string | null;
      website: string | null;
      city: string | null;
      state: string | null;
    }
    
    interface SetmoreOpeningHours {
      day: number; // 0 = Sunday
      isOpen: boolean;
      startDisplayTime: string;
      endDisplayTime: string;
    }
    
    interface SetmoreBookingConfig {
      allowCancellation: boolean;
      allowRescheduling: boolean;
      slotIntervalMins: number | null;
    }
    
    interface SetmoreBusinessDetail extends SetmoreBusiness {
      openingHours: SetmoreOpeningHours[];
      bookingConfig: SetmoreBookingConfig | null;
      paymentsConfig: { isEnabled: boolean; isRequired: boolean; currency: string | null } | null;
      customerAccountsEnabled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/getBusiness

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.getBusiness("onboarding");
  • getClassSessionReturns one class session in full: title, start and end time, time zone, cost, seats left, staff member, and whether it is a video call.

    Arguments

    NameTypeRequired
    businessstringYes
    sessionIdstringYes

    Returns SetmoreClassSession

    interface SetmoreClassSession {
      id: string;
      classId: string | null;
      title: string;
      startsAt: string | null; // ISO instant, UTC
      endsAt: string | null;
      timeZone: string | null;
      cost: number | null;
      availableSeats: number | null;
      staffId: string | null;
      isVideoCall: boolean;
      isDeleted: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/getClassSession

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.getClassSession({ business: "<business>", sessionId: "<sessionId>" });
  • getMyBookingsSigned in as the caller (their customer account at one business), lists their own upcoming or past bookings there -- appointment, class or event…

    Arguments

    NameTypeRequired
    businessstring
    A business with customer accounts on (getBusiness → customerAuth).
    Yes
    when"upcoming" | "past"
    Default "upcoming".
    No
    afterstring
    NextCursor from the previous page.
    No

    Returns SetmoreMyBookings

    interface SetmoreBooking {
      kind: "service" | "class" | "event";
      id: string;
      confirmationId: string | null;
      serviceId: string | null;
      serviceTitle: string | null;
      classId: string | null; // a class booking's class, in place of a service
      classTitle: string | null;
      staffId: string | null;
      staffName: string | null;
      startsAt: string | null; // ISO instant, UTC
      endsAt: string | null;
      timeZone: string | null;
      cost: number | null;
      transactionId: string | null;
      notes: string | null;
      isDeleted: boolean; // true once cancelled
    }
    
    interface SetmoreMyBookings {
      companyId: string;
      when: "upcoming" | "past";
      bookings: SetmoreBooking[];
      nextCursor: string | null; // pass back as after for the next page
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/getMyBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.getMyBookings({ business: "barbershop" });
  • getReviewsReturns a business's customer reviews -- author, date, star rating, text and where it came from (Setmore or Google) -- with the average rating and…

    Arguments

    NameTypeRequired
    businessstringYes
    pagestring
    A page number as a string, e.g. "2".
    No

    Returns SetmoreReviews

    interface SetmoreReview {
      id: string;
      author: string;
      date: string | null; // ISO instant, UTC
      rating: number | null;
      review: string | null;
      source: string | null; // "google" | ...
    }
    
    interface SetmoreReviews {
      reviews: SetmoreReview[];
      averageRating: number | null;
      reviewCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/getReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.getReviews({ business: "onboarding" });
  • listClassesLists the group classes a business runs and every upcoming session across them: each class's id, title, description, duration, price and staff, and…

    Arguments

    NameTypeRequired
    businessstringYes

    Returns SetmoreClassList

    interface SetmoreClassSessionRef {
      sessionId: string; // pass to getClassSession
      classId: string;
      startsAt: string; // ISO instant, UTC
      staffId: string | null;
    }
    
    interface SetmoreClass {
      id: string;
      title: string;
      description: string | null;
      durationMins: number | null;
      beforeBufferMins: number | null;
      afterBufferMins: number | null;
      price: number | null;
      imageUrl: string | null;
      isVideoCall: boolean;
      isPrivate: boolean;
      staffIds: string[];
    }
    
    interface SetmoreClassList {
      companyId: string;
      classes: SetmoreClass[];
      sessions: SetmoreClassSessionRef[]; // every upcoming session, in start order
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.listClasses("yogaflow");
  • listGalleryImagesLists the photos a business shows on its own gallery: each image's id, src, width and height.

    Arguments

    NameTypeRequired
    businessstringYes

    Returns SetmoreGallery

    interface SetmoreGalleryImage {
      id: string;
      src: string;
      width: number | null;
      height: number | null;
    }
    
    interface SetmoreGallery {
      images: SetmoreGalleryImage[];
      hasMore: boolean;
      endCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/listGalleryImages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.listGalleryImages("onboarding");
  • listServicesLists the appointments a business offers -- each service's id, title, description, duration, buffer times, price, image, whether it is a video call…

    Arguments

    NameTypeRequired
    businessstringYes

    Returns SetmoreServiceList

    interface SetmoreService {
      id: string;
      title: string;
      description: string | null;
      durationMins: number | null;
      beforeBufferMins: number | null;
      afterBufferMins: number | null;
      price: number | null;
      imageUrl: string | null;
      isVideoCall: boolean;
      isPrivate: boolean;
      staffIds: string[];
    }
    
    interface SetmoreServiceCategory {
      id: string;
      title: string;
      type: string;
      productIds: string[];
    }
    
    interface SetmoreServiceList {
      services: SetmoreService[];
      categories: SetmoreServiceCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/listServices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.listServices("onboarding");
  • listStaffLists the people a customer can book with at a business: staff id, display name, role, bio, photo, booking-page slug and the service ids each one…

    Arguments

    NameTypeRequired
    businessstringYes

    Returns SetmoreStaffList

    interface SetmoreStaff {
      id: string;
      displayName: string;
      role: string | null;
      bio: string | null;
      avatarUrl: string | null;
      slug: string | null;
      serviceIds: string[];
    }
    
    interface SetmoreStaffList {
      staff: SetmoreStaff[];
      staffSelection: string | null; // "REQUIRED" | "SKIP" | ...
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/listStaff

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.listStaff("onboarding");
Act 5
  • bookAppointmentBooks a service at a business for a guest -- the service, a slot time and staff member from getAvailability, and the guest's name, email or phone --…

    Arguments

    NameTypeRequired
    businessstringYes
    serviceIdstringNo
    serviceIdsstring[]No
    staffIdstring
    From a getAvailability slot.
    Yes
    startDateTimestring
    ISO instant from a getAvailability slot.
    Yes
    timeZonestringNo
    guestSetmoreBookAppointmentGuestYes
    notesstringNo

    Returns SetmoreBookingConfirmation | SetmorePaymentRequired

    interface SetmoreBooking {
      kind: "service" | "class" | "event";
      id: string;
      confirmationId: string | null;
      serviceId: string | null;
      serviceTitle: string | null;
      classId: string | null; // a class booking's class, in place of a service
      classTitle: string | null;
      staffId: string | null;
      staffName: string | null;
      startsAt: string | null; // ISO instant, UTC
      endsAt: string | null;
      timeZone: string | null;
      cost: number | null;
      transactionId: string | null;
      notes: string | null;
      isDeleted: boolean; // true once cancelled
    }
    
    interface SetmoreBookingConfirmation {
      companyId: string;
      confirmationId: string | null;
      bookings: SetmoreBooking[];
    }
    
    interface SetmorePaymentRequired {
      requiresPayment: true; // the business takes payment at booking; nothing was created
      companyId: string;
      amountDue: number;
      currency: string | null;
      message: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/bookAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.bookAppointment({
      business: "<business>",
      staffId: "<staffId>",
      startDateTime: "<startDateTime>",
      guest: {}
    });
  • bookClassBooks a guest into a class session at a business -- only the sessionId from listClasses and the guest's name are needed, since the class, staff…

    Arguments

    NameTypeRequired
    businessstringYes
    sessionIdstring
    From listClasses, the class, staff and time all come off it.
    Yes
    guestSetmoreBookAppointmentGuestYes
    notesstringNo

    Returns SetmoreBookingConfirmation | SetmorePaymentRequired

    interface SetmoreBooking {
      kind: "service" | "class" | "event";
      id: string;
      confirmationId: string | null;
      serviceId: string | null;
      serviceTitle: string | null;
      classId: string | null; // a class booking's class, in place of a service
      classTitle: string | null;
      staffId: string | null;
      staffName: string | null;
      startsAt: string | null; // ISO instant, UTC
      endsAt: string | null;
      timeZone: string | null;
      cost: number | null;
      transactionId: string | null;
      notes: string | null;
      isDeleted: boolean; // true once cancelled
    }
    
    interface SetmoreBookingConfirmation {
      companyId: string;
      confirmationId: string | null;
      bookings: SetmoreBooking[];
    }
    
    interface SetmorePaymentRequired {
      requiresPayment: true; // the business takes payment at booking; nothing was created
      companyId: string;
      amountDue: number;
      currency: string | null;
      message: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.bookClass({
      business: "<business>",
      sessionId: "<sessionId>",
      guest: {}
    });
  • cancelAppointmentCancels a booking (appointment, class or event) at a business, from the booking id bookAppointment, bookClass or getBooking returned.

    Arguments

    NameTypeRequired
    businessstringYes
    bookingIdstring
    The id field from bookAppointment, bookClass or getBooking's bookings[].
    Yes

    Returns { cancelled: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/cancelAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.cancelAppointment({ business: "<business>", bookingId: "<bookingId>" });
  • rescheduleAppointmentMoves a booking to a new start time, keeping its original duration, staff member and service, from the confirmation id and booking id…

    Arguments

    NameTypeRequired
    businessstringYes
    confirmationIdstring
    From bookAppointment, bookClass or getBooking.
    Yes
    bookingIdstring
    Disambiguates when one confirmation covers more than one booking.
    Yes
    startDateTimestring
    ISO instant, the new slot; duration is kept from the original.
    Yes

    Returns SetmoreBooking

    interface SetmoreBooking {
      kind: "service" | "class" | "event";
      id: string;
      confirmationId: string | null;
      serviceId: string | null;
      serviceTitle: string | null;
      classId: string | null; // a class booking's class, in place of a service
      classTitle: string | null;
      staffId: string | null;
      staffName: string | null;
      startsAt: string | null; // ISO instant, UTC
      endsAt: string | null;
      timeZone: string | null;
      cost: number | null;
      transactionId: string | null;
      notes: string | null;
      isDeleted: boolean; // true once cancelled
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/rescheduleAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.rescheduleAppointment({
      business: "<business>",
      confirmationId: "<confirmationId>",
      bookingId: "<bookingId>",
      startDateTime: "<startDateTime>"
    });
  • updateMyDetailsSigned in as the caller (their customer account at one business), changes their own name, email, phone number or address there -- only the fields…

    Arguments

    NameTypeRequired
    businessstring
    A business with customer accounts on, where the caller is signed in.
    Yes
    firstNamestringNo
    lastNamestringNo
    emailstringNo
    phoneNumberstringNo
    address{ street?: string; city?: string; state?: string; postalCode?: string; country?: string }No

    Returns SetmoreCustomer

    interface SetmoreAddress {
      street: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      country: string | null;
    }
    
    interface SetmoreCustomer {
      id: string;
      firstName: string | null;
      lastName: string | null;
      email: string | null;
      phoneNumber: string | null;
      address: SetmoreAddress | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/setmore/updateMyDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.setmore.updateMyDetails({ business: "<business>" });

Use it from code