GlossGenius MCP server for AI agents

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

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

Connect

Just GlossGenius

An MCP server for GlossGenius 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/glossgenius
Every site

One MCP server for GlossGenius 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 14
  • findBusinessFinds a GlossGenius business from what a caller actually holds -- its booking-site slug ("sweettouchskin"), a <slug>.glossgenius.com link, or the…

    Arguments

    NameTypeRequired
    businessstring
    A booking-site slug ("sweettouchskin"), a <slug>.glossgenius.com link, or the business's own website / Instagram link that points at one.
    Yes

    Returns GlossGeniusBusinessRef

    interface GlossGeniusBusinessRef {
      slug: string;
      bookingUrl: string;
      name: string;
      businessToken: string;
      address: string | null;
      phone: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.findBusiness({ business: "sweettouchskin" });
  • getAvailabilityReturns the open appointment times for one or more services at a business over a date range, optionally with a chosen team member or location: each…

    Arguments

    NameTypeRequired
    businessstringYes
    servicesstring[]
    One or more service tokens from listServices().services[].token.
    Yes
    fromstring
    YYYY-MM-DD, inclusive.
    Yes
    tostring
    YYYY-MM-DD, inclusive.
    Yes
    locationstring
    A location token from getBusiness().locations; defaults to the first location.
    No
    teamMembersstring[]
    Space member tokens from listTeam().team[].spaceMemberToken; omitted means any team member.
    No

    Returns GlossGeniusAvailability

    interface GlossGeniusSlot {
      /** ISO instant, UTC */
      startsAt: string;
      /** ISO instant, UTC */
      endsAt: string;
      /** space member tokens free for this slot */
      spaceMemberTokens: string[];
    }
    
    interface GlossGeniusAvailability {
      business: string;
      location: string;
      slots: GlossGeniusSlot[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.getAvailability({
      business: "<business>",
      services: [],
      from: "<from>",
      to: "<to>"
    });
  • getBookingRequirementsSays what a business will ask a given client for before it books given services at a given time: whether a card on file is required, the deposit and…

    Arguments

    NameTypeRequired
    businessstringYes
    servicesstring[]
    Service guids from listServices().services[].guid.
    Yes
    startsAtstring
    A slot's startsAt from getAvailability.
    Yes
    namestring
    The client's name.
    Yes
    emailstring
    The client's email, this or phone; a returning client may owe no deposit.
    No
    phonestringNo

    Returns GlossGeniusBookingRequirements

    interface GlossGeniusBookingRequirements {
      business: string;
      cardRequired: boolean;
      depositRequired: boolean;
      /** dollars due now, null when no deposit */
      depositAmount: number | null;
      /** dollars added to the deposit */
      depositProcessingFee: number | null;
      cancellationPolicy: string | null;
      cancellationWindowHours: number | null;
      cancellationFee: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/getBookingRequirements

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.getBookingRequirements({
      business: "<business>",
      services: [],
      startsAt: "<startsAt>",
      name: "<name>"
    });
  • getBusinessReturns one business's public profile: name, about text, address and coordinates, phone, timezone, opening hours per weekday, booking policies…

    Arguments

    NameTypeRequired
    businessstring
    A booking-site slug ("sweettouchskin"), a <slug>.glossgenius.com link, or the business's own website / Instagram link that points at one.
    Yes

    Returns GlossGeniusBusiness

    interface GlossGeniusBusinessRef {
      slug: string;
      bookingUrl: string;
      name: string;
      businessToken: string;
      address: string | null;
      phone: string | null;
    }
    
    interface GlossGeniusLocation {
      /** pass as `location` to listServices */
      token: string;
      name: string;
      phone: string | null;
      address: string | null;
      /** per weekday, "HH:MM-HH:MM" ranges; empty means closed */
      hours: Record<string, string[]>;
      engagementTypes: string[];
    }
    
    interface GlossGeniusTeamMember {
      guid: string;
      name: string;
      about: string | null;
      availableForBooking: boolean;
      /** service guids this member performs */
      serviceGuids: string[];
    }
    
    interface GlossGeniusBusiness extends GlossGeniusBusinessRef {
      about: string | null;
      email: string | null;
      latitude: number | null;
      longitude: number | null;
      timezone: string | null;
      instagram: string | null;
      website: string | null;
      coverImage: string | null;
      /** weekday -> { start, end } in decimal hours, from the business's own hours setting */
      businessHours: Record<string, { open: boolean; start: number; end: number }>;
      policies: {
        cancellationPolicy: string | null;
        cancellationWindowHours: number | null;
        cancellationFee: number | null;
        /** "always_require" | "never_require" | … as the site sends it */
        cardRequired: string | null;
        onlineBookingDisabled: boolean;
        allowOnlineCancellations: boolean;
        futureBookingsLimit: number | null;
        requireFormCompletion: boolean;
        waitlistEnabled: boolean;
        giftCardsEnabled: boolean;
      };
      team: GlossGeniusTeamMember[];
      locations: GlossGeniusLocation[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.getBusiness({ business: "sweettouchskin" });
  • getGiftCardOptionsReturns whether a business sells gift cards online, the preset amounts it offers and the card designs.

    Arguments

    NameTypeRequired
    businessstringYes

    Returns GlossGeniusGiftCardOptions

    interface GlossGeniusMoney {
      /** cents */
      value: number;
      currency: string;
    }
    
    interface GlossGeniusGiftCardOptions {
      business: string;
      /** false when the business does not sell gift cards online */
      onSale: boolean;
      presetAmounts: GlossGeniusMoney[];
      /** card design image URLs */
      designs: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/getGiftCardOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.getGiftCardOptions({ business: "sweettouchskin" });
  • getMyProfileSigned in: returns the caller's own client profile at one GlossGenius business -- name, email, phone, the client token, and the user record as…

    Arguments

    NameTypeRequired
    businessstring
    The business the caller signed in to: its slug ("sweettouchskin") or booking-site link -- a GlossGenius sign-in belongs to one business.
    Yes

    Returns GlossGeniusMyProfile

    interface GlossGeniusMyProfile {
      business: string;
      /** the client's token at this business, when the sign-in recorded one */
      clientToken: string | null;
      name: string | null;
      email: string | null;
      phone: string | null;
      /** the user record exactly as GlossGenius returns it (its field list is not yet observed signed in) */
      user: Record<string, unknown>;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.getMyProfile({ business: "sweettouchskin" });
  • listLocationsLists the locations of a multi-location business with address, hours and phone, and the location token the service and availability calls take.

    Arguments

    NameTypeRequired
    businessstringYes

    Returns GlossGeniusLocationList

    interface GlossGeniusLocation {
      /** pass as `location` to listServices */
      token: string;
      name: string;
      phone: string | null;
      address: string | null;
      /** per weekday, "HH:MM-HH:MM" ranges; empty means closed */
      hours: Record<string, string[]>;
      engagementTypes: string[];
    }
    
    interface GlossGeniusLocationList {
      business: string;
      locations: GlossGeniusLocation[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/listLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listLocations({ business: "sweettouchskin" });
  • listMembershipsLists the memberships a business sells: name, description, monthly price, renewal period, taxes and the benefits each includes.

    Arguments

    NameTypeRequired
    businessstringYes

    Returns GlossGeniusMembershipList

    interface GlossGeniusMoney {
      /** cents */
      value: number;
      currency: string;
    }
    
    interface GlossGeniusPackageItem {
      /** a service token, as listServices returns it */
      serviceToken: string;
      name: string;
      quantity: number;
      /** what the package charges for this line */
      price: GlossGeniusMoney | null;
      /** what the same sessions cost booked one at a time */
      originalPrice: GlossGeniusMoney | null;
    }
    
    interface GlossGeniusMembership {
      token: string;
      name: string;
      description: string;
      price: GlossGeniusMoney | null;
      /** ISO 8601 duration such as "P1M" */
      renewsEvery: string | null;
      taxes: { name: string; percentage: string }[];
      /** the sessions each renewal includes */
      includes: GlossGeniusPackageItem[];
      image: string | null;
    }
    
    interface GlossGeniusMembershipList {
      business: string;
      memberships: GlossGeniusMembership[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/listMemberships

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listMemberships({ business: "sweettouchskin" });
  • listMyMembershipsSigned in: lists the memberships the caller holds at one GlossGenius business, as GlossGenius returns them.

    Arguments

    NameTypeRequired
    businessstring
    The business the caller signed in to (slug or booking-site link).
    Yes
    statesstring[]
    Optional client-membership states to keep, as GlossGenius names them.
    No

    Returns GlossGeniusMyMemberships

    interface GlossGeniusMyMemberships {
      business: string;
      /** client_memberships as GlossGenius returns them (field list not yet observed signed in) */
      memberships: Record<string, unknown>[];
      count: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/listMyMemberships

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listMyMemberships({ business: "sweettouchskin" });
  • listMyOrdersSigned in: lists the caller's orders at one GlossGenius business, OPEN by default, or PAID, VOID or CANCELED.

    Arguments

    NameTypeRequired
    businessstring
    The business the caller signed in to (slug or booking-site link).
    Yes
    statestring
    "OPEN" (default), "PAID", "VOID" or "CANCELED".
    No

    Returns GlossGeniusMyOrders

    interface GlossGeniusMyOrders {
      business: string;
      /** orders as GlossGenius returns them, with payment account and pay-later methods (field list not yet observed signed in) */
      orders: Record<string, unknown>[];
      count: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/listMyOrders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listMyOrders({ business: "sweettouchskin" });
  • listPackagesLists the service packages a business sells (a bundle of sessions at one price): name, description, price, what it includes, how long it is valid and…

    Arguments

    NameTypeRequired
    businessstringYes

    Returns GlossGeniusPackageList

    interface GlossGeniusMoney {
      /** cents */
      value: number;
      currency: string;
    }
    
    interface GlossGeniusPackageItem {
      /** a service token, as listServices returns it */
      serviceToken: string;
      name: string;
      quantity: number;
      /** what the package charges for this line */
      price: GlossGeniusMoney | null;
      /** what the same sessions cost booked one at a time */
      originalPrice: GlossGeniusMoney | null;
    }
    
    interface GlossGeniusPackage {
      token: string;
      name: string;
      description: string;
      price: GlossGeniusMoney | null;
      /** ISO 8601 duration such as "P2M"; null when it never expires */
      expiresAfter: string | null;
      items: GlossGeniusPackageItem[];
      terms: string | null;
      image: string | null;
    }
    
    interface GlossGeniusPackageList {
      business: string;
      packages: GlossGeniusPackage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/listPackages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listPackages({ business: "sweettouchskin" });
  • listReviewsLists a business's client reviews: rating, text, reviewer first name, date, the services reviewed and any photo.

    Arguments

    NameTypeRequired
    businessstringYes
    limitnumber
    Default 50, max 200.
    No

    Returns GlossGeniusReviewList

    interface GlossGeniusReview {
      id: number;
      rating: number;
      /** the reviewer's own text; "" when they left none */
      message: string;
      /** first name only, as the site shows it */
      reviewerName: string;
      createdAt: string;
      /** names of the services reviewed, when the site attaches them */
      servicesNames: string[] | null;
      image: string | null;
    }
    
    interface GlossGeniusReviewList {
      business: string;
      reviews: GlossGeniusReview[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listReviews({ business: "sweettouchskin" });
  • listServicesLists a business's bookable services with category, price (or 'varies'/hidden), duration including processing time, description, image, deposit…

    Arguments

    NameTypeRequired
    businessstringYes
    locationstring
    A location token from getBusiness().locations; defaults to the first location.
    No

    Returns GlossGeniusServiceList

    interface GlossGeniusService {
      guid: string;
      /** the token getAvailability takes */
      token: string;
      name: string;
      category: string | null;
      description: string | null;
      /** dollars as the site sends them, e.g. "180.00"; null when hidden */
      price: string | null;
      priceVaries: boolean;
      durationMinutes: number;
      processingMinutes: number;
      depositAmount: string | null;
      depositForNewClientsOnly: boolean;
      image: string | null;
      options: unknown[];
      modifierGroups: unknown[];
      /** team member guids that perform it */
      teamGuids: string[];
    }
    
    interface GlossGeniusServiceList {
      business: string;
      location: string;
      services: GlossGeniusService[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listServices({ business: "sweettouchskin" });
  • listTeamLists the team members a client can book with at a business: name, bio, avatar, Instagram and the services each performs, with the space member token…

    Arguments

    NameTypeRequired
    businessstringYes

    Returns GlossGeniusTeamList

    interface GlossGeniusTeamMemberFull {
      guid: string;
      name: string;
      about: string | null;
      avatar: string | null;
      instagram: string | null;
      availableForBooking: boolean;
      /** pass as a member of `teamMembers` to getAvailability */
      spaceMemberToken: string | null;
      /** service guids this member performs */
      serviceGuids: string[];
    }
    
    interface GlossGeniusTeamList {
      business: string;
      team: GlossGeniusTeamMemberFull[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/listTeam

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.listTeam({ business: "sweettouchskin" });
Act 3
  • cancelMyMembershipSigned in: cancels one of the caller's memberships at a GlossGenius business, under the business's membership terms.

    Arguments

    NameTypeRequired
    businessstring
    The business the caller signed in to (slug or booking-site link).
    Yes
    membershipstring
    The client-membership token from listMyMemberships.
    Yes

    Returns GlossGeniusMembershipCancel

    interface GlossGeniusMembershipCancel {
      business: string;
      membership: string;
      cancelled: true;
      /** GlossGenius's answer as sent */
      response: Record<string, unknown>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/glossgenius/cancelMyMembership

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.cancelMyMembership({ business: "<business>", membership: "<membership>" });
  • joinWaitlistPuts a client on a business's waitlist for one or more services and a preferred team member, as a guest, when no open time suits.

    Arguments

    NameTypeRequired
    businessstringYes
    servicesstring[]
    Service guids from listServices().services[].guid.
    Yes
    providerstring
    A team member guid from listTeam().team[].guid -- GlossGenius's waitlist form always asks for one, there is no "any professional" option.
    Yes
    namestringYes
    emailstringYes
    phonestringYes
    daysnumber
    How many days out the client will take an opening: one of 1, 3, 7, 14, 30 or 90; default 7.
    No
    notesstringNo
    agreeToSmsConsentboolean
    True to let the business text the client about this entry.
    No
    locationstring
    A location token from getBusiness().locations, for a multi-location business.
    No
    acknowledgeCancellationPolicytrue
    Must be true -- the client is agreeing to the business's cancellation policy, the same checkbox the waitlist form requires.
    Yes

    Returns GlossGeniusWaitlistJoinResult

    interface GlossGeniusWaitlistJoinResult {
      business: string;
      joined: true;
      /** GlossGenius emails or texts the client a link to track or cancel the entry; the create call itself returns no id to read back */
      note: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.joinWaitlist({
      business: "<business>",
      services: [],
      provider: "<provider>",
      name: "<name>",
      email: "<email>",
      phone: "<phone>",
      acknowledgeCancellationPolicy: "<acknowledgeCancellationPolicy>"
    });
  • updateMyProfileSigned in: changes the caller's first and last name at one GlossGenius business, and sets an email when none is on file (GlossGenius will not change…

    Arguments

    NameTypeRequired
    businessstring
    The business the caller signed in to (slug or booking-site link).
    Yes
    firstNamestring
    Both names are required, as on the booking site's Contact information form.
    Yes
    lastNamestringYes
    emailstring
    Only when no email is on file -- GlossGenius refuses changing an existing one.
    No

    Returns GlossGeniusProfileUpdate

    interface GlossGeniusProfileUpdate {
      business: string;
      updated: true;
      /** the user record as GlossGenius returns it after the change */
      user: Record<string, unknown>;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.glossgenius.updateMyProfile({
      business: "<business>",
      firstName: "<firstName>",
      lastName: "<lastName>"
    });

Use it from code