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.
- Site
- styleseat.com
- Functions
- 27
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/styleseatOne MCP server for StyleSeat and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
getAppointmentByLinkReads an appointment from the manage link StyleSeat sends in its confirmation email or text, with no sign-in -- the link's token is the key.Arguments
Name Type Required args{ token: string }Yes Returns
StyleseatAppointmentByLinkinterface StyleseatAppointmentByLink { id: number | null; status: string | null; start: string | null; providerId: number | null; raw: Record<string, unknown>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/getAppointmentByLinkCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getAppointmentByLink({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getAppointmentByLink({}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getAppointmentByLink \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.getAppointmentByLink({});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
Name Type Required prostringA pro's vanity, numeric id or profile url.Yes serviceIdsnumber[]Service ids to check availability for, from getProfessional's serviceGroups.Yes startDatestringFirst date to check, YYYY-MM-DD (default: today).No daysnumberHow many days to look ahead, 1-14 (default 7).No Returns
StyleseatAvailabilityinterface 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/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getAvailability({ pro: "1872400", serviceIds: [8186709] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getAvailability({"pro": "1872400", "serviceIds": [8186709]}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pro":"1872400","serviceIds":[8186709]}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringA pro's vanity, numeric id or profile url.Yes serviceIdsnumber[]Service ids being booked, from getProfessional.Yes datestringThe appointment date, YYYY-MM-DD.Yes startTimestringThe appointment start time, HH:MM 24-hour.Yes Returns
StyleseatBookingQuoteinterface 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/getBookingQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getBookingQuote({ pro: "1872400", serviceIds: [8186709], date: { $daysFromNow: 7 }, startTime: "10:00" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getBookingQuote({ "pro": "1872400", "serviceIds": [8186709], "date": {"$daysFromNow": 7}, "startTime": "10:00" }))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getBookingQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pro":"1872400","serviceIds":[8186709],"date":{"$daysFromNow":7},"startTime":"10:00"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringA pro's vanity, numeric id or profile url.No salonIdstring | numberA salon id or vanity, from getSalon or a search result's matched_salon.No pagenumber1-based page number (default 1; the site pages 20 per page).No Returns
StyleseatGalleryinterface 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/getGalleryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getGallery({ pro: "1872400" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getGallery({"pro": "1872400"}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getGallery \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pro":"1872400"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ id: number }Yes Returns
StyleseatAppointmentSummaryinterface 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/getMyAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getMyAppointment({ id: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getMyAppointment({"id": 1}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getMyAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":1}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
StyleseatMyProfileinterface 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/getMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getMyProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getMyProfile())curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getMyProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringYes Returns
StyleseatOffersinterface 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/getOffersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getOffers("1309899");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getOffers("1309899"))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getOffers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pro":"1309899"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringYes Returns
StyleseatProfessionalinterface 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/getProfessionalCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getProfessional("gdarling");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getProfessional("gdarling"))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getProfessional \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pro":"gdarling"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringA pro's vanity, numeric id or profile url.Yes pinnedOnlybooleanOnly the pro's pinned reviews, if true.No Returns
StyleseatReviewsResultinterface 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/getReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getReviews("gdarling");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getReviews("gdarling"))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"gdarling"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required salonIdstring | numberYes Returns
StyleseatSaloninterface 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/getSalonCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.getSalon("1872406");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.getSalon("1872406"))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/getSalon \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"salonId":"1872406"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringYes serviceIdstring | numberNo offsetnumberNo Returns
StyleseatClassTimesinterface 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/listClassTimesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.listClassTimes({ pro: "1872400" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.listClassTimes({"pro": "1872400"}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/listClassTimes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pro":"1872400"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.listClassTimes({ pro: "1872400" });listFavoritesLists the pros the signed-in caller has saved as favorites.Arguments
Name Type Required args{ page?: number; size?: number }No Returns
StyleseatFavoritesinterface 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/listFavoritesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.listFavorites();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.listFavorites())curl -X POST https://api.bowmark.ai/v1/sites/styleseat/listFavorites \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required completedOnlybooleanOnly completed (past) appointments when true, only upcoming when false, both when omitted.No pagenumber1-based page number (default 1).No sizenumberRows per page (default 20).No Returns
StyleseatMyAppointmentsinterface 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/listMyAppointmentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.listMyAppointments();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.listMyAppointments())curl -X POST https://api.bowmark.ai/v1/sites/styleseat/listMyAppointments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.listMyAppointments();listMyDiscountsLists the discount codes saved on the signed-in caller's account.Arguments
None.
Returns
StyleseatMyDiscountsinterface 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/listMyDiscountsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.listMyDiscounts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.listMyDiscounts())curl -X POST https://api.bowmark.ai/v1/sites/styleseat/listMyDiscounts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
StyleseatServiceCategoriesinterface 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/listServiceCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.listServiceCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.listServiceCategories())curl -X POST https://api.bowmark.ai/v1/sites/styleseat/listServiceCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required placestringYes Returns
StyleseatPlaceinterface StyleseatPlace { formattedAddress: string; latitude: number; longitude: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/resolveLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.resolveLocation("Brooklyn, NY");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.resolveLocation("Brooklyn, NY"))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/resolveLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"place":"Brooklyn, NY"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringWhat the caller wants done, e.g. "box braids", "skin fade".Yes nearstringA place a person would type ("Brooklyn, NY", a ZIP).Yes limitnumberMax rows returned (default 20, max 50).No Returns
StyleseatSearchResultinterface 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/searchProfessionalsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.searchProfessionals({ query: "haircut", near: "San Francisco, CA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.searchProfessionals({"query": "haircut", "near": "San Francisco, CA"}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/searchProfessionals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"haircut","near":"San Francisco, CA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.searchProfessionals({ query: "haircut", near: "San Francisco, CA" });
addFavoriteSaves a pro to the signed-in caller's favorites.Arguments
Name Type Required args{ pro: string }Yes Returns
StyleseatFavoriteChangeinterface StyleseatFavoriteChange { providerId: number; favorite: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/addFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.addFavorite({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.addFavorite({}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/addFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringA pro's vanity, numeric id or profile url.Yes serviceIdsnumber[]Service ids being booked, from getProfessional.Yes datestringThe appointment date, YYYY-MM-DD.Yes startTimestringThe appointment start time, HH:MM 24-hour.Yes notestringA note to the pro, e.g. what look the caller wants.No Returns
StyleseatBookedAppointmentinterface 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/bookAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.bookAppointment({ pro: "<pro>", serviceIds: [], date: "<date>", startTime: "<startTime>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.bookAppointment({ "pro": "<pro>", "serviceIds": [], "date": "<date>", "startTime": "<startTime>" }))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/bookAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pro":"<pro>","serviceIds":[],"date":"<date>","startTime":"<startTime>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.bookAppointment({ pro: "<pro>", serviceIds: [], date: "<date>", startTime: "<startTime>" });cancelAppointmentCancels one of the signed-in caller's upcoming appointments.Arguments
Name Type Required args{ id: number }Yes Returns
StyleseatCancelledAppointmentinterface StyleseatCancelledAppointment { id: number; cancelled: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/cancelAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.cancelAppointment({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.cancelAppointment({}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/cancelAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.cancelAppointment({});cancelAppointmentByLinkCancels an appointment from the manage link in StyleSeat's confirmation message, with no sign-in -- for a guest booking a pro made on the client's…Arguments
Name Type Required args{ token: string }Yes Returns
StyleseatCancelledByLinkinterface StyleseatCancelledByLink { token: string; cancelled: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/cancelAppointmentByLinkCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.cancelAppointmentByLink({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.cancelAppointmentByLink({}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/cancelAppointmentByLink \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.cancelAppointmentByLink({});joinWaitlistPuts the signed-in caller on a pro's waitlist for chosen services, with a note, when no time suits.Arguments
Name Type Required prostringYes serviceIdsnumber[]Yes notestringNo Returns
StyleseatWaitlistEntryinterface StyleseatWaitlistEntry { providerId: number; joined: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/joinWaitlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.joinWaitlist({ pro: "<pro>", serviceIds: [] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.joinWaitlist({"pro": "<pro>", "serviceIds": []}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/joinWaitlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pro":"<pro>","serviceIds":[]}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required prostringA pro's vanity, numeric id or profile url.Yes feedbackTokenstringThe feedback token from StyleSeat's "leave a review" email/text link.Yes numStarsnumber1-5.Yes reviewTextstringThe review text.Yes firstNamestringNo lastNamestringNo Returns
StyleseatLeftReviewinterface StyleseatLeftReview { providerId: number; submitted: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/leaveReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.leaveReview({ pro: "<pro>", feedbackToken: "<feedbackToken>", numStars: 1, reviewText: "<reviewText>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.leaveReview({ "pro": "<pro>", "feedbackToken": "<feedbackToken>", "numStars": 1, "reviewText": "<reviewText>" }))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/leaveReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pro":"<pro>","feedbackToken":"<feedbackToken>","numStars":1,"reviewText":"<reviewText>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.leaveReview({ pro: "<pro>", feedbackToken: "<feedbackToken>", numStars: 1, reviewText: "<reviewText>" });removeFavoriteRemoves a pro from the signed-in caller's favorites.Arguments
Name Type Required args{ pro: string }Yes Returns
StyleseatFavoriteChangeinterface StyleseatFavoriteChange { providerId: number; favorite: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/removeFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.removeFavorite({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.removeFavorite({}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/removeFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idnumberYes prostringYes serviceIdsnumber[]Yes datestringYes startTimestringYes Returns
StyleseatRescheduledAppointmentinterface StyleseatRescheduledAppointment { id: number; providerId: number; status: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/rescheduleAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.rescheduleAppointment({ id: 1, pro: "<pro>", serviceIds: [], date: "<date>", startTime: "<startTime>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.rescheduleAppointment({ "id": 1, "pro": "<pro>", "serviceIds": [], "date": "<date>", "startTime": "<startTime>" }))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/rescheduleAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":1,"pro":"<pro>","serviceIds":[],"date":"<date>","startTime":"<startTime>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ pro: string; message: string }Yes Returns
StyleseatConversationinterface StyleseatConversation { providerId: number; opened: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/styleseat/sendMessageToProfessionalCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.sendMessageToProfessional({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.sendMessageToProfessional({}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/sendMessageToProfessional \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.sendMessageToProfessional({});updateMyProfileChanges the signed-in caller's profile details: first name, last name, phone.Arguments
Name Type Required firstNamestringNo lastNamestringNo phonestringNo Returns
StyleseatMyProfileinterface 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/updateMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.styleseat.updateMyProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.styleseat.updateMyProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/styleseat/updateMyProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.styleseat.updateMyProfile({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/styleseat/<function> - OpenAPI
/v1/sites/styleseat/openapi.json