Fresha MCP server for AI agents
Let Claude, ChatGPT or your own agent read Fresha: 7 typed functions through one MCP server. No Fresha API key needed.
- Site
- fresha.com
- Functions
- 7
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Fresha 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/freshaOne MCP server for Fresha 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.
getAvailabilityReturns the open appointment times at one venue for one or more services, optionally with a chosen professional: which days in the coming weeks have…Arguments
Name Type Required venuestringVenue slug from searchVenues, or its fresha.com/a/...Yes serviceVariantIdsstring[]Variant ids from getVenue: serviceCategories[].services[].variants[].id.Yes employeeIdstringA professional from getVenue's team[].employeeId; omit for anyone.No datestring"YYYY-MM-DD"; omit for the first open day.No Returns
FreshaAvailabilityinterface FreshaTimeslot { time: string; /** Seconds after midnight, venue-local. */ startSeconds: number | null; /** Shown only when the price varies by time. */ price: string | null; } interface FreshaAvailability { venueSlug: string; serviceVariantIds: string[]; employeeId: string | null; dates: { date: string; available: boolean }[]; /** The day timeslots belong to. */ date: string | null; timeslots: FreshaTimeslot[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fresha/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fresha.getAvailability({ venue: "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5", serviceVariantIds: ["2452566"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fresha.getAvailability({ "venue": "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5", "serviceVariantIds": ["2452566"] }))curl -X POST https://api.bowmark.ai/v1/sites/fresha/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"venue":"h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5","serviceVariantIds":["2452566"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fresha.getAvailability({ venue: "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5", serviceVariantIds: ["2452566"] });getBookingQuotePrices an appointment before booking it: the services, the date and time range, the professional, the total, and whether anything is due up front --…Arguments
Name Type Required venuestringYes serviceVariantIdsstring[]Yes employeeIdstringNo datestring"YYYY-MM-DD", a day getAvailability reported available.Yes timestring | numberA start time from getAvailability: "9:00 AM", "14:30", or its startSeconds.Yes Returns
FreshaBookingQuoteinterface FreshaBookingQuote { venueSlug: string; venueName: string | null; address: string | null; date: string; startSeconds: number; dateFormatted: string | null; /** e.g. "4:45-5:00 PM (15 min duration)" */ timeRangeFormatted: string | null; items: { name: string; price: string | null; detail: string | null }[]; total: string | null; /** "FIXED", or "FROM" when the total is a starting price. */ priceType: string | null; tax: string | null; /** Set when the venue takes money up front (deposit or prepayment). */ payNow: string | null; payAtVenue: string | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fresha/getBookingQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fresha.getBookingQuote({ venue: "<venue>", serviceVariantIds: [], date: "<date>", time: "<time>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fresha.getBookingQuote({ "venue": "<venue>", "serviceVariantIds": [], "date": "<date>", "time": "<time>" }))curl -X POST https://api.bowmark.ai/v1/sites/fresha/getBookingQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"venue":"<venue>","serviceVariantIds":[],"date":"<date>","time":"<time>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fresha.getBookingQuote({ venue: "<venue>", serviceVariantIds: [], date: "<date>", time: "<time>" });getSearchSuggestionsTurns what a caller typed ("balayage", a venue name, a stylist's name) into Fresha's own suggestions: matching venues with their slugs, professionals…Arguments
Name Type Required querystringYes Returns
FreshaSearchSuggestionsinterface FreshaVenueSuggestion { id: string; slug: string; name: string; description: string | null; } interface FreshaProfessionalSuggestion { id: string; slug: string; name: string; description: string | null; } interface FreshaTreatmentCategorySuggestion { id: string; name: string; } interface FreshaSearchSuggestions { venues: FreshaVenueSuggestion[]; professionals: FreshaProfessionalSuggestion[]; treatmentCategories: FreshaTreatmentCategorySuggestion[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fresha/getSearchSuggestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fresha.getSearchSuggestions("brooklyn");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fresha.getSearchSuggestions("brooklyn"))curl -X POST https://api.bowmark.ai/v1/sites/fresha/getSearchSuggestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"brooklyn"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fresha.getSearchSuggestions("brooklyn");getVenueReturns one venue from its slug or its fresha.com/a/...Arguments
Name Type Required slugOrUrlstringYes Returns
FreshaVenueinterface FreshaServiceVariant { /** The id getAvailability / getBookingQuote take. */ id: string; name: string; caption: string | null; formattedRetailPrice: string | null; } interface FreshaService { id: string; serviceId: string | null; name: string; description: string | null; caption: string | null; formattedRetailPrice: string | null; price: { currency: string; value: number } | null; priceType: string | null; minMinutes: number | null; maxMinutes: number | null; variants: FreshaServiceVariant[]; } interface FreshaServiceCategory { id: string; name: string; services: FreshaService[]; } interface FreshaTeamMember { employeeId: string; displayName: string; jobTitle: string | null; rating: number | null; avatarUrl: string | null; } interface FreshaVenue { id: string; slug: string; name: string; description: string | null; businessType: string | null; contactNumber: string | null; address: { formatted: string | null; street: string | null; city: string | null; region: string | null; postalCode: string | null; countryCode: string | null; latitude: number | null; longitude: number | null; }; openNow: { state: string | null; label: string | null }; hours: { day: string; isClosed: boolean; isToday: boolean; ranges: string[] }[]; rating: number | null; reviewCount: number | null; ratingSummary: string | null; priceRange: { currency: string; min: number | null; max: number | null } | null; isBookable: boolean; serviceCategories: FreshaServiceCategory[]; team: FreshaTeamMember[]; features: { id: string; label: string }[]; links: { website: string | null; instagram: string | null; facebook: string | null }; otherLocations: { slug: string; name: string }[]; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fresha/getVenueCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fresha.getVenue("h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fresha.getVenue("h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5"))curl -X POST https://api.bowmark.ai/v1/sites/fresha/getVenue \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slugOrUrl":"h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fresha.getVenue("h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5");getVenuePhotosReturns a venue's own photos with descriptions and the first page of its work portfolio, with the portfolio total.Arguments
Name Type Required venuestringA venue slug or its fresha.com/a/...Yes Returns
FreshaVenuePhotosinterface FreshaPhoto { url: string; width: number | null; height: number | null; title: string | null; description: string | null; } interface FreshaPortfolioPhoto extends FreshaPhoto { id: string; section: string | null; service: { id: string; name: string | null; displayPrice: string | null } | null; } interface FreshaVenuePhotos { venueSlug: string; venuePhotos: FreshaPhoto[]; portfolioTotal: number | null; portfolio: FreshaPortfolioPhoto[]; portfolioHasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fresha/getVenuePhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fresha.getVenuePhotos({ venue: "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fresha.getVenuePhotos({ "venue": "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5" }))curl -X POST https://api.bowmark.ai/v1/sites/fresha/getVenuePhotos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"venue":"h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fresha.getVenuePhotos({ venue: "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5" });getVenueReviewsLists a Fresha venue's verified customer reviews, 5 a page by cursor: rating, text, date, the service and team member reviewed, the venue's reply and…Arguments
Name Type Required venuestringVenue slug from searchVenues, or its fresha.com/a/...Yes cursorstringCursor from a previous call's result, for the next 5 reviews.No sort"relevance" | "latest" | "best" | "worst"Fresha's own orders; its default is "relevance".No ratingsnumber[]Only these star ratings, e.g. [1, 2].No searchstringWords the review text must match.No withReplyOnlybooleanOnly reviews the venue replied to.No Returns
FreshaVenueReviewsinterface FreshaReview { id: string; rating: number | null; text: string | null; authorName: string | null; /** ISO when Fresha gives one, else its own label ("Today at 7:07 PM"). */ date: string | null; /** e.g. "1 day ago • Haircut • with Katelyn" */ summary: string | null; /** Team members the review names, getVenue's team[].employeeId. */ employeeIds: string[]; reply: { author: string | null; text: string | null; date: string | null } | null; photoUrls: string[]; } interface FreshaVenueReviews { venueSlug: string; /** Reviews matching the filters. */ total: number | null; ratingCounts: { 1: number | null; 2: number | null; 3: number | null; 4: number | null; 5: number | null }; reviews: FreshaReview[]; cursor: string | null; hasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fresha/getVenueReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fresha.getVenueReviews({ venue: "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fresha.getVenueReviews({ "venue": "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5" }))curl -X POST https://api.bowmark.ai/v1/sites/fresha/getVenueReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"venue":"h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fresha.getVenueReviews({ venue: "h2-salon-brooklyn-brooklyn-1407-fulton-street-au5f9sm5" });searchVenuesSearches Fresha's marketplace for salons, barbers, spas, nail, lash and wellness venues near a place or coordinates: id, slug, name, address…Arguments
Name Type Required nearstringA city, neighborhood or address, e.g. "Brooklyn, NY".No latnumberNo lngnumberNo limitnumberPage size. Fresha's own default when omitted.No cursorstringEndCursor from a previous call's result, to fetch the next page.No Returns
FreshaSearchVenuesResultinterface FreshaVenueServicePreview { name: string; caption: string; formattedRetailPrice: string | null; } interface FreshaVenueSummary { id: string; slug: string; name: string; distanceMiles: string | null; rating: number | null; reviewCount: number | null; businessType: string | null; address: string | null; topServices: FreshaVenueServicePreview[]; } interface FreshaSearchVenuesResult { venues: FreshaVenueSummary[]; totalCount: number; endCursor: string | null; hasMore: boolean; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fresha/searchVenuesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fresha.searchVenues({ lat: 40.68, lng: -73.94 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fresha.searchVenues({"lat": 40.68, "lng": -73.94}))curl -X POST https://api.bowmark.ai/v1/sites/fresha/searchVenues \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"lat":40.68,"lng":-73.94}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fresha.searchVenues({ lat: 40.68, lng: -73.94 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/fresha/<function> - OpenAPI
/v1/sites/fresha/openapi.json