Vagaro MCP server for AI agents

Let Claude, ChatGPT or your own agent read Vagaro: 16 typed functions through one MCP server. No Vagaro API key needed.

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

Connect

Just Vagaro

An MCP server for Vagaro 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/vagaro
Every site

One MCP server for Vagaro 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
  • findBusinessFinds a Vagaro business from what a caller has: its vagaro.com/<slug> link, its booking or services link, an old schedulicity.com booking link, or…

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroBusinessRef

    interface VagaroBusinessRef {
      /** Pass as `business` to every other vagaro function. */
      slug: string;
      businessId: string;
      name: string | null;
      city: string | null;
      state: string | null;
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.findBusiness({ business: "<business>" });
  • getAvailableDatesReturns the dates a business has open appointment times for chosen services and staff, so a caller can pick a day before asking for times.

    Arguments

    NameTypeRequired
    argsAvailabilityArgsYes
    interface BusinessArgs {
      /** The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it. */
      business: string;
    }
    
    interface AvailabilityArgs extends BusinessArgs {
      /** serviceIds from listServices, at least one. */
      services: string[];
      /** staffIds from listStaff; omitted means every staff member who takes online bookings. */
      staff?: string[];
    }

    Returns VagaroAvailableDates

    interface VagaroAvailableDates {
      businessId: string;
      services: string[];
      staff: string[];
      /** YYYY-MM-DD days with at least one open time. */
      dates: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/getAvailableDates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.getAvailableDates({ business: "amazinaesthetics", services: ["23498372"] });
  • getBusinessReturns one business's profile: name, address, phone, opening hours by weekday, rating and review count, what it offers (services, classes, products…

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroBusiness

    interface VagaroBusinessRef {
      /** Pass as `business` to every other vagaro function. */
      slug: string;
      businessId: string;
      name: string | null;
      city: string | null;
      state: string | null;
      url: string;
    }
    
    interface VagaroBusiness extends VagaroBusinessRef {
      description: string | null;
      specialInstructions: string | null;
      address: { street: string | null; city: string | null; state: string | null; zip: string | null; country: string | null };
      latitude: number | null;
      longitude: number | null;
      phone: string | null;
      website: string | null;
      image: string | null;
      owner: string | null;
      /** The business's 1-5 star averages by review dimension. */
      ratings: { venue: number | null; punctuality: number | null; value: number | null; service: number | null };
      /** One row per weekday; open/close are "HH:MM:SS" local time, null when closed. */
      hours: { day: string; open: string | null; close: string | null }[];
      offers: { services: number | null; classes: boolean; products: boolean; memberships: boolean; packages: boolean; giftCards: boolean };
      onlineBooking: boolean;
      waitlist: boolean;
      currency: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.getBusiness({ business: "amazinaesthetics" });
  • getCancellationPolicyReturns a business's cancellation and no-show policy for appointments and classes.

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroCancellationPolicy

    interface VagaroCancellationPolicy {
      businessId: string;
      slug: string;
      /** The business's appointment cancellation / no-show text; null when none is set. */
      appointmentPolicy: string | null;
      /** The class cancellation text; null when none is set. */
      classPolicy: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/getCancellationPolicy

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.getCancellationPolicy({ business: "amazinaesthetics" });
  • getClassReturns one class by id: name, description, price (null when hidden online), duration, promotion discount, and which staff teach it at what price.

    Arguments

    NameTypeRequired
    argsGetClassArgsYes
    interface BusinessArgs {
      /** The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it. */
      business: string;
    }
    
    interface GetClassArgs extends BusinessArgs {
      /** classId from listClasses. */
      classId: string;
    }

    Returns VagaroClassDetail

    interface VagaroClass {
      classId: string;
      name: string;
      category: string | null;
      description: string | null;
      /** null when the business hides the price online. */
      price: number | null;
      durationMinutes: number | null;
      promotionDiscountPercent: number | null;
      /** Who teaches it, the staff ids listStaff returns. */
      staff: { staffId: string; name: string | null; price: number | null }[];
    }
    
    interface VagaroClassDetail extends VagaroClass {
      businessId: string;
      slug: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.getClass({ business: "themovementcoop", classId: "23120484" });
  • getOpenTimesReturns the open appointment times on one date for chosen services, per staff member or anyone available.

    Arguments

    NameTypeRequired
    argsOpenTimesArgsYes
    interface BusinessArgs {
      /** The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it. */
      business: string;
    }
    
    interface AvailabilityArgs extends BusinessArgs {
      /** serviceIds from listServices, at least one. */
      services: string[];
      /** staffIds from listStaff; omitted means every staff member who takes online bookings. */
      staff?: string[];
    }
    
    interface OpenTimesArgs extends AvailabilityArgs {
      /** YYYY-MM-DD, the business's local date. */
      date: string;
    }

    Returns VagaroOpenTimesResult

    interface VagaroOpenTimesResult {
      businessId: string;
      requestedDate: string | null;
      /** The day the times are for, Vagaro answers with the nearest open day when the requested one has none. */
      date: string | null;
      slots: {
        staffId: string;
        staffName: string | null;
        serviceId: string | null;
        serviceName: string | null;
        durationMinutes: number | null;
        price: number | null;
        promotionDiscountPercent: number | null;
        /** "12:00 PM"-style times in the business's local time zone. */
        times: string[];
      }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/getOpenTimes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.getOpenTimes({
      business: "amazinaesthetics",
      services: ["23498372"],
      date: { $daysFromNow: 7 }
    });
  • getServiceReturns one service by id: name, description, price (null when hidden online), duration, promotion discount, and which staff perform it at what price.

    Arguments

    NameTypeRequired
    argsGetServiceArgsYes
    interface BusinessArgs {
      /** The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it. */
      business: string;
    }
    
    interface GetServiceArgs extends BusinessArgs {
      /** serviceId from listServices. */
      serviceId: string;
    }

    Returns VagaroServiceDetail

    interface VagaroBusinessRef {
      /** Pass as `business` to every other vagaro function. */
      slug: string;
      businessId: string;
      name: string | null;
      city: string | null;
      state: string | null;
      url: string;
    }
    
    interface VagaroService {
      serviceId: string;
      name: string;
      category: string | null;
      description: string | null;
      /** null when the business hides the price online. */
      price: number | null;
      durationMinutes: number | null;
      promotionDiscountPercent: number | null;
      /** Who performs it, the staff ids getOpenTimes takes. */
      staff: { staffId: string; name: string | null; price: number | null }[];
    }
    
    interface VagaroServiceDetail extends VagaroService {
      business: VagaroBusinessRef;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/getService

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.getService({ business: "amazinaesthetics", serviceId: "23498372" });
  • getStaffMemberReturns one staff member's profile: photo, rating, review count, the services they perform at their own price, and their newest reviews.

    Arguments

    NameTypeRequired
    argsGetStaffMemberArgsYes
    interface BusinessArgs {
      /** The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it. */
      business: string;
    }
    
    interface GetStaffMemberArgs extends BusinessArgs {
      /** staffId from listStaff. */
      staffId: string;
    }

    Returns VagaroStaffProfile

    interface VagaroReview {
      reviewId: string;
      reviewer: string | null;
      /** YYYY-MM-DD. */
      date: string | null;
      /** 1-5 overall. */
      rating: number | null;
      staffName: string | null;
      text: string | null;
      ratings: { venue: number | null; punctuality: number | null; value: number | null; staff: number | null };
      businessResponse: string | null;
    }
    
    interface VagaroStaffProfile {
      businessId: string;
      slug: string;
      staffId: string;
      name: string | null;
      photo: string | null;
      rating: number | null;
      reviewCount: number | null;
      acceptsOnlineBooking: boolean;
      /** Services this person performs, at their own price (null when hidden online). */
      services: { serviceId: string; name: string; category: string | null; price: number | null; durationMinutes: number | null }[];
      reviewTotal: number | null;
      /** Their 10 newest reviews; page further with listReviews({ staffId }). */
      recentReviews: VagaroReview[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/getStaffMember

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.getStaffMember({ business: "amazinaesthetics", staffId: "134168560" });
  • listAddOnsLists the optional add-ons a business offers on top of its services, with category, price, duration and which services they attach to.

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroAddOnList

    interface VagaroAddOn {
      addOnId: string;
      name: string;
      category: string | null;
      description: string | null;
      /** null when the business hides the price online. */
      price: number | null;
      durationMinutes: number | null;
      /** serviceIds (from listServices) this add-on attaches to. */
      attachesToServiceIds: string[];
    }
    
    interface VagaroAddOnList {
      businessId: string;
      slug: string;
      addOns: VagaroAddOn[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/listAddOns

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.listAddOns({ business: "amazinaesthetics" });
  • listClassesLists a business's group classes and workshops by category: id, name, description, price (null when hidden online), duration, promotion discount, and…

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroClassList

    interface VagaroClass {
      classId: string;
      name: string;
      category: string | null;
      description: string | null;
      /** null when the business hides the price online. */
      price: number | null;
      durationMinutes: number | null;
      promotionDiscountPercent: number | null;
      /** Who teaches it, the staff ids listStaff returns. */
      staff: { staffId: string; name: string | null; price: number | null }[];
    }
    
    interface VagaroClassList {
      businessId: string;
      slug: string;
      categories: string[];
      classes: VagaroClass[];
      instructors: { staffId: string; name: string | null }[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.listClasses({ business: "themovementcoop" });
  • listPhotosLists a business's portfolio photos: title, description, image url, like count, and the service and staff member each one illustrates.

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroPhotoList

    interface VagaroPhoto {
      photoId: string;
      title: string | null;
      description: string | null;
      imageUrl: string | null;
      likeCount: number | null;
      /** serviceId from listServices, when this photo illustrates one. */
      serviceId: string | null;
      serviceName: string | null;
      /** staffId from listStaff, when this photo is attributed to one. */
      staffId: string | null;
      staffName: string | null;
    }
    
    interface VagaroPhotoList {
      businessId: string;
      slug: string;
      photos: VagaroPhoto[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/listPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.listPhotos({ business: "amazinaesthetics" });
  • listPromotionsLists a business's current deals and promotions: discount, the services it applies to, whether it is for new customers only, and its dates.

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroPromotionList

    interface VagaroPromotionList {
      businessId: string;
      slug: string;
      promotions: {
        promotionId: string;
        title: string | null;
        description: string | null;
        /** Percent off when discountType is "percent", currency amount otherwise. */
        discount: number | null;
        discountType: "percent" | "amount" | null;
        newCustomersOnly: boolean;
        /** YYYY-MM-DD; endDate null when open-ended. */
        startDate: string | null;
        endDate: string | null;
        /** serviceIds (from listServices) it applies to. */
        serviceIds: string[];
        /** staffIds (from listStaff) it applies to. */
        staffIds: string[];
      }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/listPromotions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.listPromotions({ business: "amazinaesthetics" });
  • listReviewsLists a business's customer reviews, newest first, with rating, text, the staff member reviewed, the business's reply, and the overall star breakdown.

    Arguments

    NameTypeRequired
    argsListReviewsArgsYes
    interface BusinessArgs {
      /** The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it. */
      business: string;
    }
    
    interface ListReviewsArgs extends BusinessArgs {
      /** staffId from listStaff, only that staff member's reviews. */
      staffId?: string;
      /** 1-based, 10 reviews a page. */
      page?: number;
    }

    Returns VagaroReviewList

    interface VagaroReview {
      reviewId: string;
      reviewer: string | null;
      /** YYYY-MM-DD. */
      date: string | null;
      /** 1-5 overall. */
      rating: number | null;
      staffName: string | null;
      text: string | null;
      ratings: { venue: number | null; punctuality: number | null; value: number | null; staff: number | null };
      businessResponse: string | null;
    }
    
    interface VagaroReviewList {
      businessId: string;
      slug: string;
      staffId: string | null;
      page: number;
      /** Total reviews matching (all pages). */
      total: number | null;
      hasMore: boolean;
      /** 5-to-1-star counts for the whole business; empty when filtered by staffId. */
      breakdown: { stars: number; count: number }[];
      reviews: VagaroReview[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.listReviews({ business: "amazinaesthetics" });
  • listServicesLists a business's bookable services by category: name, description, price (and whether it is shown online), duration, any promotion, and which staff…

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroServiceList

    interface VagaroBusinessRef {
      /** Pass as `business` to every other vagaro function. */
      slug: string;
      businessId: string;
      name: string | null;
      city: string | null;
      state: string | null;
      url: string;
    }
    
    interface VagaroService {
      serviceId: string;
      name: string;
      category: string | null;
      description: string | null;
      /** null when the business hides the price online. */
      price: number | null;
      durationMinutes: number | null;
      promotionDiscountPercent: number | null;
      /** Who performs it, the staff ids getOpenTimes takes. */
      staff: { staffId: string; name: string | null; price: number | null }[];
    }
    
    interface VagaroServiceList {
      business: VagaroBusinessRef;
      categories: string[];
      services: VagaroService[];
      staff: { staffId: string; name: string | null }[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.listServices({ business: "amazinaesthetics" });
  • listStaffLists the staff a customer can book at a business, with photo, title, rating and review count, and whether each accepts online bookings.

    Arguments

    NameTypeRequired
    businessstring
    The business's Vagaro slug ("amazinaesthetics") or any vagaro.com / old schedulicity.com link to it.
    Yes

    Returns VagaroStaffList

    interface VagaroStaffList {
      businessId: string;
      slug: string;
      staff: {
        /** The id getOpenTimes takes. */
        staffId: string;
        name: string | null;
        photo: string | null;
        /** 1-5 star average. */
        rating: number | null;
        reviewCount: number | null;
        acceptsOnlineBooking: boolean;
      }[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.listStaff({ business: "amazinaesthetics" });
  • searchBusinessesSearches Vagaro's marketplace for salons, spas, barbers and studios by service category and city, returning name, booking page, phone, price range…

    Arguments

    NameTypeRequired
    categorystring
    A category slug, e.g. "skin-care".
    Yes
    citystringYes
    statestring
    Two-letter state code, e.g. "CO".
    Yes

    Returns VagaroSearchResults

    interface VagaroSearchResult {
      name: string;
      url: string;
      phone: string | null;
      priceRange: string | null;
      address: { street: string | null; city: string | null; state: string | null; zip: string | null };
      /** 1-5 star average. */
      rating: number | null;
      reviewCount: number | null;
    }
    
    interface VagaroSearchResults {
      category: string;
      city: string;
      state: string;
      businesses: VagaroSearchResult[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/vagaro/searchBusinesses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.vagaro.searchBusinesses({ category: "skin-care", city: "Denver", state: "CO" });

Use it from code