StyleSeat MCP server for AI agents

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

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

Connect

Just StyleSeat

An MCP server for StyleSeat 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/styleseat
Every site

One MCP server for StyleSeat 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 17
  • getAvailabilityLists a pro's open start times for one or more of their services over a date range, as real clock times per day, with any time-of-day surcharge the…

    Arguments

    NameTypeRequired
    prostring
    A pro's vanity, numeric id or profile url.
    Yes
    serviceIdsnumber[]
    Service ids to check availability for, from getProfessional's serviceGroups.
    Yes
    startDatestring
    First date to check, YYYY-MM-DD (default: today).
    No
    daysnumber
    How many days to look ahead, 1-14 (default 7).
    No

    Returns StyleseatAvailability

    interface StyleseatAvailabilitySlot { time: string; surcharge: number | null; }
    
    interface StyleseatAvailabilityDay { date: string; slots: StyleseatAvailabilitySlot[]; }
    
    interface StyleseatAvailability { providerId: number; days: StyleseatAvailabilityDay[]; availabilityPercentage: number | null; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getAvailability({ pro: "1872400", serviceIds: [8186709] });
  • getBookingQuotePrices a prospective appointment before booking -- services at a date and start time -- and returns StyleSeat's booking fee, the deposit due now and…

    Arguments

    NameTypeRequired
    prostring
    A pro's vanity, numeric id or profile url.
    Yes
    serviceIdsnumber[]
    Service ids being booked, from getProfessional.
    Yes
    datestring
    The appointment date, YYYY-MM-DD.
    Yes
    startTimestring
    The appointment start time, HH:MM 24-hour.
    Yes

    Returns StyleseatBookingQuote

    interface StyleseatBookingQuote {
      providerId: number; bookingFee: number | null; depositDue: number | null; depositPaid: number | null;
      classPrepayDue: number | null; balanceRemaining: number | null; depositRequired: boolean; bookingFeeRequired: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/getBookingQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getBookingQuote({
      pro: "1872400",
      serviceIds: [8186709],
      date: { $daysFromNow: 7 },
      startTime: "10:00"
    });
  • getGalleryLists the photos of a pro's portfolio, or every pro's photos at a salon, paged 20 per page.

    Arguments

    NameTypeRequired
    prostring
    A pro's vanity, numeric id or profile url.
    No
    salonIdstring | number
    A salon id or vanity, from getSalon or a search result's matched_salon.
    No
    pagenumber
    1-based page number (default 1; the site pages 20 per page).
    No

    Returns StyleseatGallery

    interface StyleseatGalleryImage { id: number; url: string; pinned: boolean; serviceId: number | null; blurb: string | null; }
    
    interface StyleseatGallery { count: number; images: StyleseatGalleryImage[]; hasMore: boolean; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/getGallery

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getGallery({ pro: "1872400" });
  • getMyAppointmentGets one of the signed-in caller's appointments in full, with its status details (confirmed, pending pro approval, cancelled).

    Arguments

    NameTypeRequired
    args{ id: number }Yes

    Returns StyleseatAppointmentSummary

    interface StyleseatAppointmentSummary { id: number; providerId: number; providerName: string | null; date: string | null; startTime: string | null; status: string | null; totalCost: number | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/getMyAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getMyAppointment({ id: 1 });
  • getMyProfileReads the signed-in caller's StyleSeat client profile: name, email, phone, photo and the user id the account routes take.

    Arguments

    None.

    Returns StyleseatMyProfile

    interface StyleseatMyProfile { userId: number; firstName: string | null; lastName: string | null; email: string | null; phone: string | null; photoUrl: string | null; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getMyProfile();
  • getOffersLists what a pro is offering on top of list prices: active promotions, their loyalty-program reward (e.g. 20% off after 6 visits) when one is on, and…

    Arguments

    NameTypeRequired
    prostringYes

    Returns StyleseatOffers

    interface StyleseatPromotion { serviceId: number; name: string; description: string | null; discountType: string; discountQuantity: number | null; }
    
    interface StyleseatLoyaltyReward { discountPercent: number | null; discountAmount: number | null; appointmentsRequired: number | null; }
    
    interface StyleseatServicePackageOffer {
      id: number; serviceId: number; serviceName: string; numVisits: number | null;
      discountPercent: number | null; serviceCost: number | null; bookingFee: number | null;
    }
    
    interface StyleseatOffers {
      providerId: number; promotions: StyleseatPromotion[]; loyaltyReward: StyleseatLoyaltyReward | null;
      servicePackages: StyleseatServicePackageOffer[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/getOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getOffers("1309899");
  • getProfessionalGets one StyleSeat pro's public profile from a vanity name, profile URL or id: name, business name, address and coordinates, phone where shown, bio…

    Arguments

    NameTypeRequired
    prostringYes

    Returns StyleseatProfessional

    
    interface StyleseatCheckout {
      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[];
    }
    
    interface StyleseatService { id: number; name: string; durationMinutes: number | null; cost: number | null; costAndUp: boolean; blurb: string | null; }
    
    interface StyleseatServiceGroup { name: string | null; services: StyleseatService[]; }
    
    interface StyleseatProfessional {
    
      checkout: StyleseatCheckout | null;
      id: number; name: string; vanityUrl: string; profileUrl: string; businessName: string | null;
      profession: string | null; bio: string | null; phoneNumber: string | null;
      address: { street1: string | null; street2: string | null; city: string | null; state: string | null; zip: string | null };
      latitude: number | null; longitude: number | null; ratingStars: number | null; photoUrl: string | null;
      socialLinks: { instagram: string | null; twitter: string | null; facebook: string | null; website: string | null; yelp: string | null };
      canProcessPayments: boolean; cancellationPolicyText: string | null; depositPolicyText: string | null;
      serviceGroups: StyleseatServiceGroup[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/getProfessional

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getProfessional("gdarling");
  • getReviewsLists a pro's client reviews, newest first and paged, with stars, review text, photos, the service reviewed and the pinned reviews, plus the…

    Arguments

    NameTypeRequired
    prostring
    A pro's vanity, numeric id or profile url.
    Yes
    pinnedOnlyboolean
    Only the pro's pinned reviews, if true.
    No

    Returns StyleseatReviewsResult

    interface StyleseatReview {
      id: number; numStars: number | null; pinned: boolean; reviewText: string | null; reviewImages: string[];
      serviceName: string | null; clientFirstName: string | null; clientLastName: string | null; createdAt: string | null;
    }
    
    interface StyleseatRatingSummaryRow { serviceId: number; numberOfReviews: number | null; average: number | null; }
    
    interface StyleseatReviewsResult {
      providerId: number; total: number; reviews: StyleseatReview[]; ratingSummary: StyleseatRatingSummaryRow[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getReviews("gdarling");
  • getSalonGets a salon's details plus every pro who works there, each with their services, prices and durations -- from the salon id or vanity a search…

    Arguments

    NameTypeRequired
    salonIdstring | numberYes

    Returns StyleseatSalon

    interface StyleseatService { id: number; name: string; durationMinutes: number | null; cost: number | null; costAndUp: boolean; blurb: string | null; }
    
    interface StyleseatSalonProvider {
      id: number; name: string; vanityUrl: string; profileUrl: string; profession: string | null;
      ratingStars: number | null; numRatings: number | null; photoUrl: string | null; onlineBookable: boolean;
      services: StyleseatService[];
    }
    
    interface StyleseatSalon {
      id: number; name: string; vanityUrl: string; phoneNumber: string | null;
      address: { street1: string | null; street2: string | null; city: string | null; state: string | null; zip: string | null };
      latitude: number | null; longitude: number | null; cancellationPolicyText: string | null;
      providers: StyleseatSalonProvider[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/getSalon

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.getSalon("1872406");
  • listClassTimesLists a pro's upcoming group classes (workshops, braiding classes, makeup lessons): each time's start, end, class service, spots left and whether it…

    Arguments

    NameTypeRequired
    prostringYes
    serviceIdstring | numberNo
    offsetnumberNo

    Returns StyleseatClassTimes

    interface StyleseatClassTime { id: number; start: string | null; end: string | null; serviceId: number | null; serviceName: string | null; spotsLeft: number | null; isFull: boolean; bookedByMe: boolean; }
    
    interface StyleseatClassTimes { classTimes: StyleseatClassTime[]; count: number; nextOffset: number | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/listClassTimes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.listClassTimes({ pro: "1872400" });
  • listFavoritesLists the pros the signed-in caller has saved as favorites.

    Arguments

    NameTypeRequired
    args{ page?: number; size?: number }No

    Returns StyleseatFavorites

    interface StyleseatFavorite { providerId: number; name: string | null; vanity: string | null; profession: string | null; }
    
    interface StyleseatFavorites { favorites: StyleseatFavorite[]; next: boolean; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/listFavorites

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.listFavorites();
  • listMyAppointmentsLists the signed-in caller's upcoming and past StyleSeat appointments: pro, services, time, price, status and the appointment id the other account…

    Arguments

    NameTypeRequired
    completedOnlyboolean
    Only completed (past) appointments when true, only upcoming when false, both when omitted.
    No
    pagenumber
    1-based page number (default 1).
    No
    sizenumber
    Rows per page (default 20).
    No

    Returns StyleseatMyAppointments

    interface StyleseatAppointmentSummary { id: number; providerId: number; providerName: string | null; date: string | null; startTime: string | null; status: string | null; totalCost: number | null; }
    
    interface StyleseatMyAppointments { userId: number; appointments: StyleseatAppointmentSummary[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/listMyAppointments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.listMyAppointments();
  • listMyDiscountsLists the discount codes saved on the signed-in caller's account.

    Arguments

    None.

    Returns StyleseatMyDiscounts

    interface StyleseatDiscount { code: string | null; description: string | null; amount: string | null; expires: string | null; }
    
    interface StyleseatMyDiscounts { discounts: StyleseatDiscount[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/listMyDiscounts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.listMyDiscounts();
  • listServiceCategoriesLists StyleSeat's service categories and the services under each (Braids > Knotless, Boho; Women's Haircut > Bang Trim...), with the search phrase…

    Arguments

    None.

    Returns StyleseatServiceCategories

    interface StyleseatPopularService { name: string; displayName: string; searchQuery: string; }
    
    interface StyleseatPopularCategory { title: string; services: StyleseatPopularService[]; }
    
    interface StyleseatStandardService { id: number; name: string; searchQuery: string; }
    
    interface StyleseatStandardCategory { id: number; name: string; services: StyleseatStandardService[]; }
    
    interface StyleseatServiceCategories { popular: StyleseatPopularCategory[]; standard: StyleseatStandardCategory[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/listServiceCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.listServiceCategories();
  • resolveLocationTurns a place a caller typed ("Brooklyn, NY", a ZIP code, an address) into the coordinates and formatted place name searchProfessionals searches…

    Arguments

    NameTypeRequired
    placestringYes

    Returns StyleseatPlace

    interface StyleseatPlace { formattedAddress: string; latitude: number; longitude: number; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/resolveLocation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.resolveLocation("Brooklyn, NY");
  • searchProfessionalsSearches StyleSeat for hair stylists, barbers, braiders, nail techs, lash and brow artists and other beauty pros near a place, by what the caller…

    Arguments

    NameTypeRequired
    querystring
    What the caller wants done, e.g. "box braids", "skin fade".
    Yes
    nearstring
    A place a person would type ("Brooklyn, NY", a ZIP).
    Yes
    limitnumber
    Max rows returned (default 20, max 50).
    No

    Returns StyleseatSearchResult

    interface StyleseatSearchService { id: number; name: string; price: number | null; duration: number | null; }
    
    interface StyleseatProfessionalSummary {
      id: number; name: string; vanityUrl: string; profileUrl: string; businessName: string | null;
      averageRating: number | null; numRatings: number | null; photoUrl: string | null;
      onlineBookable: boolean; matchedServices: StyleseatSearchService[];
    
      checkout: StyleseatCheckout | null;
    }
    
    interface StyleseatCheckout {
      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[];
    }
    
    interface StyleseatSearchResult { query: string; total: number; results: StyleseatProfessionalSummary[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/searchProfessionals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.searchProfessionals({ query: "haircut", near: "San Francisco, CA" });
Act 10
  • addFavoriteSaves a pro to the signed-in caller's favorites.

    Arguments

    NameTypeRequired
    args{ pro: string }Yes

    Returns StyleseatFavoriteChange

    interface StyleseatFavoriteChange { providerId: number; favorite: boolean; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/addFavorite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.addFavorite({});
  • bookAppointmentBooks an appointment with a pro for the signed-in caller: services at a date and start time, with a note to the pro.

    Arguments

    NameTypeRequired
    prostring
    A pro's vanity, numeric id or profile url.
    Yes
    serviceIdsnumber[]
    Service ids being booked, from getProfessional.
    Yes
    datestring
    The appointment date, YYYY-MM-DD.
    Yes
    startTimestring
    The appointment start time, HH:MM 24-hour.
    Yes
    notestring
    A note to the pro, e.g. what look the caller wants.
    No

    Returns StyleseatBookedAppointment

    interface StyleseatBookingQuote {
      providerId: number; bookingFee: number | null; depositDue: number | null; depositPaid: number | null;
      classPrepayDue: number | null; balanceRemaining: number | null; depositRequired: boolean; bookingFeeRequired: boolean;
    }
    
    interface StyleseatBookedAppointment { id: number; providerId: number; status: string | null; quote: StyleseatBookingQuote; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.bookAppointment({
      pro: "<pro>",
      serviceIds: [],
      date: "<date>",
      startTime: "<startTime>"
    });
  • cancelAppointmentCancels one of the signed-in caller's upcoming appointments.

    Arguments

    NameTypeRequired
    args{ id: number }Yes

    Returns StyleseatCancelledAppointment

    interface StyleseatCancelledAppointment { id: number; cancelled: boolean; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.cancelAppointment({});
  • joinWaitlistPuts the signed-in caller on a pro's waitlist for chosen services, with a note, when no time suits.

    Arguments

    NameTypeRequired
    prostringYes
    serviceIdsnumber[]Yes
    notestringNo

    Returns StyleseatWaitlistEntry

    interface StyleseatWaitlistEntry { providerId: number; joined: boolean; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.joinWaitlist({ pro: "<pro>", serviceIds: [] });
  • leaveReviewLeaves a star rating and review for a pro, from the feedback token in StyleSeat's review-request email or text.

    Arguments

    NameTypeRequired
    prostring
    A pro's vanity, numeric id or profile url.
    Yes
    feedbackTokenstring
    The feedback token from StyleSeat's "leave a review" email/text link.
    Yes
    numStarsnumber
    1-5.
    Yes
    reviewTextstring
    The review text.
    Yes
    firstNamestringNo
    lastNamestringNo

    Returns StyleseatLeftReview

    interface StyleseatLeftReview { providerId: number; submitted: boolean; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/leaveReview

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.leaveReview({
      pro: "<pro>",
      feedbackToken: "<feedbackToken>",
      numStars: 1,
      reviewText: "<reviewText>"
    });
  • removeFavoriteRemoves a pro from the signed-in caller's favorites.

    Arguments

    NameTypeRequired
    args{ pro: string }Yes

    Returns StyleseatFavoriteChange

    interface StyleseatFavoriteChange { providerId: number; favorite: boolean; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/removeFavorite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.removeFavorite({});
  • rescheduleAppointmentMoves one of the signed-in caller's appointments to a new date and start time with the same pro.

    Arguments

    NameTypeRequired
    idnumberYes
    prostringYes
    serviceIdsnumber[]Yes
    datestringYes
    startTimestringYes

    Returns StyleseatRescheduledAppointment

    interface StyleseatRescheduledAppointment { id: number; providerId: number; status: string | null; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.rescheduleAppointment({
      id: 1,
      pro: "<pro>",
      serviceIds: [],
      date: "<date>",
      startTime: "<startTime>"
    });
  • sendMessageToProfessionalOpens a chat conversation with a pro (the door StyleSeat's own messaging goes through).

    Arguments

    NameTypeRequired
    args{ pro: string; message: string }Yes

    Returns StyleseatConversation

    interface StyleseatConversation { providerId: number; opened: boolean; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/styleseat/sendMessageToProfessional

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.sendMessageToProfessional({});
  • updateMyProfileChanges the signed-in caller's profile details: first name, last name, phone.

    Arguments

    NameTypeRequired
    firstNamestringNo
    lastNamestringNo
    phonestringNo

    Returns StyleseatMyProfile

    interface StyleseatMyProfile { userId: number; firstName: string | null; lastName: string | null; email: string | null; phone: string | null; photoUrl: string | null; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.styleseat.updateMyProfile({});

Use it from code