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.

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

Connect

Just Fresha

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/fresha
Every site

One MCP server for Fresha 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 7
  • 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

    NameTypeRequired
    venuestring
    Venue slug from searchVenues, or its fresha.com/a/...
    Yes
    serviceVariantIdsstring[]
    Variant ids from getVenue: serviceCategories[].services[].variants[].id.
    Yes
    employeeIdstring
    A professional from getVenue's team[].employeeId; omit for anyone.
    No
    datestring
    "YYYY-MM-DD"; omit for the first open day.
    No

    Returns FreshaAvailability

    interface 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/getAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    venuestringYes
    serviceVariantIdsstring[]Yes
    employeeIdstringNo
    datestring
    "YYYY-MM-DD", a day getAvailability reported available.
    Yes
    timestring | number
    A start time from getAvailability: "9:00 AM", "14:30", or its startSeconds.
    Yes

    Returns FreshaBookingQuote

    interface 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/getBookingQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    querystringYes

    Returns FreshaSearchSuggestions

    interface 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/getSearchSuggestions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fresha.getSearchSuggestions("brooklyn");
  • getVenueReturns one venue from its slug or its fresha.com/a/...

    Arguments

    NameTypeRequired
    slugOrUrlstringYes

    Returns FreshaVenue

    interface 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/getVenue

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    venuestring
    A venue slug or its fresha.com/a/...
    Yes

    Returns FreshaVenuePhotos

    interface 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/getVenuePhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    venuestring
    Venue slug from searchVenues, or its fresha.com/a/...
    Yes
    cursorstring
    Cursor 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
    searchstring
    Words the review text must match.
    No
    withReplyOnlyboolean
    Only reviews the venue replied to.
    No

    Returns FreshaVenueReviews

    interface 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/getVenueReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    nearstring
    A city, neighborhood or address, e.g. "Brooklyn, NY".
    No
    latnumberNo
    lngnumberNo
    limitnumber
    Page size. Fresha's own default when omitted.
    No
    cursorstring
    EndCursor from a previous call's result, to fetch the next page.
    No

    Returns FreshaSearchVenuesResult

    interface 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/searchVenues

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fresha.searchVenues({ lat: 40.68, lng: -73.94 });

Use it from code