Squire MCP server for AI agents

Let Claude, ChatGPT or your own agent read Squire: 12 typed functions through one MCP server. No Squire API key needed.

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

Connect

Just Squire

An MCP server for Squire 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/squire
Every site

One MCP server for Squire 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 12
  • findShopsNearLists Squire barbershops near a place or a latitude/longitude, nearest first: name, route, address, coordinates, rating, photos and whether each…

    Arguments

    NameTypeRequired
    nearstring
    A place name, geocoded first.
    No
    latnumberNo
    lngnumberNo
    limitnumber
    Default 20.
    No

    Returns SquireShopSummary[]

    interface SquireAddress { street: string | null; city: string | null; state: string | null; zip: string | null; country: string | null; }
    
    interface SquireShopSummary {
      id: string; name: string; route: string; address: SquireAddress | null;
      lat: number | null; lng: number | null; distanceMiles: number | null;
      phone: string | null; timezone: string | null; barberCount: number | null;
      photos: string[]; bookingUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/findShopsNear

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.findShopsNear({ lat: 38.03, lng: -78.48, limit: 5 });
  • getAvailabilityReturns the open appointment times for a service at a shop over a date range -- per day, each start time and the barbers free for it -- or, given a…

    Arguments

    NameTypeRequired
    shopstringYes
    servicestring
    An id from listServices, required unless barber is given.
    No
    barberstring
    An id from listBarbers, that barber's own open times.
    No
    durationMinsnumber
    Only with barber; default 30.
    No
    fromstringNo
    tostring
    ISO dates; default today .. +4 days.
    No

    Returns SquireDayAvailability[]

    interface SquireOpenSlot {
      time: string; // ISO instant
      available: boolean;
      barberIds: string[] | null;    // only when asked by service, barbers free for this slot
      barberRoutes: string[] | null;
    }
    
    interface SquireDayAvailability {
      day: string; // ISO day
      morning: SquireOpenSlot[]; afternoon: SquireOpenSlot[]; evening: SquireOpenSlot[];
      availability: number | null; // Squire's own 0-1 fullness fraction
      suggestedTimes: SquireOpenSlot[];
      waitingListAvailable: boolean | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.getAvailability({
      shop: "house-of-cuts-barber-studio-charlottesville",
      service: "7d7f0fa4-bfa2-4046-9c32-7570cf5e045d"
    });
  • getBarberReturns one barber's profile: name, photos and portfolio, rating, the shop they work at, their weekly schedule and their next available time.

    Arguments

    NameTypeRequired
    barberstringYes

    Returns SquireBarber

    interface SquireOpeningHours { weekDay: number; open: boolean; opens: string; closes: string; } // weekDay 1 = Monday
    
    interface SquireBarberSummary {
      id: string; name: string; route: string | null; shopId: string | null; photo: string | null; instagram: string | null;
      nextAvailableTime: string | null; // ISO instant
      nextAvailableText: string | null; // e.g. "Available today"
      defaultServiceName: string | null;
      hours: SquireOpeningHours[];
      daysOff: { day: string; wholeDay: boolean; from: string | null; to: string | null }[];
    }
    
    interface SquireBarber extends SquireBarberSummary {
      photos: string[];
      portfolio: string[]; // portfolio = image/video URLs
      averageRating: number | null;
      ratingCount: number | null;
      shop: { id: string; name: string | null; route: string | null } | null;
      advanceBookDays: number | null;
      canCustomerCancel: boolean | null;
      bookingUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/getBarber

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.getBarber("e69b0d9d-a7ab-4fd6-926b-b38c38989148");
  • getBookingQuotePrices an appointment before booking it -- service, barber, time and add-ons -- returning the subtotal, tax, the customer booking fee and the total…

    Arguments

    NameTypeRequired
    shopstring
    Id, route or getsquire.com URL.
    Yes
    barberstring
    Id from listBarbers, or a slot's barberIds.
    Yes
    servicestring
    Id from listServices.
    No
    servicesstring[]
    Service ids from listServices, e.g. "7d7f0fa4-bfa2-4046-9c32-7570cf5e045d".
    No
    timestring
    ISO instant from getAvailability.
    Yes

    Returns SquireBookingQuote

    interface SquireBookingQuote {
      shopId: string; currency: string | null;
      lines: { serviceId: string | null; name: string; barberId: string | null; priceCents: number | null; durationMins: number | null; requiresPrepaid: boolean; depositCents: number | null }[];
      subtotalCents: number | null; taxCents: number | null; discountCents: number | null;
      bookingFeeCents: number | null; // Squire's customer booking fee
      totalCents: number | null;      // what the customer is charged, fee included
      requiresPrepayment: boolean | null; requiresDeposit: boolean; canBookWithoutPaying: boolean | null;
      tipSuggestionsCents: number[]; errors: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.getBookingQuote({ shop: "<shop>", barber: "<barber>", time: "<time>" });
  • getBrandReturns a multi-location brand and its shops, so a caller can pick the branch nearest them: brand name, website, Instagram and each location with its…

    Arguments

    NameTypeRequired
    brandstringYes

    Returns SquireBrand

    interface SquireAddress { street: string | null; city: string | null; state: string | null; zip: string | null; country: string | null; }
    
    interface SquireShopSummary {
      id: string; name: string; route: string; address: SquireAddress | null;
      lat: number | null; lng: number | null; distanceMiles: number | null;
      phone: string | null; timezone: string | null; barberCount: number | null;
      photos: string[]; bookingUrl: string;
    }
    
    interface SquireBrand {
      id: string; name: string; description: string | null; website: string | null; instagram: string | null;
      message: string | null; shopCount: number | null; shops: SquireShopSummary[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/getBrand

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.getBrand("828e06ac-38a5-4737-bc9b-5d8a335987c7");
  • getReviewsLists the customer reviews of a shop or of one barber, with the average rating, the review count and Squire's written summary of them: rating, text…

    Arguments

    NameTypeRequired
    shopstringNo
    barberstringNo
    limitnumberNo
    skipnumberNo

    Returns SquireReviews

    interface SquireReview {
      id: string; rating: number | null; text: string | null; createdAt: string | null;
      barber: { id: string; name: string } | null; customerName: string | null;
    }
    
    interface SquireReviews { averageRating: number | null; ratingCount: number | null; summary: string | null; reviews: SquireReview[]; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.getReviews({
      shop: "house-of-cuts-barber-studio-charlottesville",
      limit: 5
    });
  • getShopReturns one barbershop from its id, its route or a getsquire.com URL: name, address and coordinates, phone, Instagram, opening hours and days off…

    Arguments

    NameTypeRequired
    shopstringYes

    Returns SquireShop

    interface SquireAddress { street: string | null; city: string | null; state: string | null; zip: string | null; country: string | null; }
    
    interface SquireShopSummary {
      id: string; name: string; route: string; address: SquireAddress | null;
      lat: number | null; lng: number | null; distanceMiles: number | null;
      phone: string | null; timezone: string | null; barberCount: number | null;
      photos: string[]; bookingUrl: string;
    }
    
    interface SquireOpeningHours { weekDay: number; open: boolean; opens: string; closes: string; } // weekDay 1 = Monday
    
    interface SquireShop extends SquireShopSummary {
      brand: { id: string; name: string } | null;
      instagram: string | null; website: string | null;
      hours: SquireOpeningHours[]; daysOff: unknown[]; currency: string | null;
      advanceBookDays: number | null; advanceCancelMins: number | null; canCustomerCancel: boolean | null;
      requiresPrepayment: boolean | null; requiresPartialDeposits: boolean | null; allowInPersonPayments: boolean | null;
      klarnaEnabled: boolean | null; afterpayEnabled: boolean | null;
      customerBookingFeeCents: number | null; // 100 = $1.00
      waitingListEnabled: boolean | null; giftCardEnabled: boolean | null; walkInOnly: boolean | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/getShop

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.getShop("house-of-cuts-barber-studio-charlottesville");
  • getWalkInStatusSays whether a shop is taking walk-ins or a same-day standby list right now, and which barbers a walk-in can ask for.

    Arguments

    NameTypeRequired
    shopstringYes

    Returns SquireWalkInStatus

    interface SquireWalkInStatus {
      shopId: string;
      available: boolean;       // taking walk-ins / standby right now
      standbyEnabled: boolean; walkInEnabled: boolean; waitlistEnabled: boolean;
      anyBarberAllowed: boolean; // a walk-in may ask for "anyone"
      barbers: { id: string; name: string; route: string | null; photo: string | null }[]; // who a walk-in can ask for
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/getWalkInStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.getWalkInStatus("house-of-cuts-barber-studio-charlottesville");
  • listBarbersLists a shop's barbers: name, route, photos, working days and days off, and each barber's next available time.

    Arguments

    NameTypeRequired
    shopstringYes

    Returns SquireBarberSummary[]

    interface SquireOpeningHours { weekDay: number; open: boolean; opens: string; closes: string; } // weekDay 1 = Monday
    
    interface SquireBarberSummary {
      id: string; name: string; route: string | null; shopId: string | null; photo: string | null; instagram: string | null;
      nextAvailableTime: string | null; // ISO instant
      nextAvailableText: string | null; // e.g. "Available today"
      defaultServiceName: string | null;
      hours: SquireOpeningHours[];
      daysOff: { day: string; wholeDay: boolean; from: string | null; to: string | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/listBarbers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.listBarbers("house-of-cuts-barber-studio-charlottesville");
  • listServicesLists a shop's services with category, price, duration and description, and the add-ons offered with each; optionally only the services one barber…

    Arguments

    NameTypeRequired
    shopstringYes
    barberstringNo

    Returns SquireService[]

    interface SquireService {
      id: string; name: string; description: string | null;
      priceCents: number | null;                            // 4000 = $40.00; the barber's own price when one was given
      priceRangeCents: { min: number; max: number } | null; // when barbers charge differently
      durationMins: number | null; categories: string[];
      requiresPrepaid: boolean | null; requiresDeposit: boolean | null; addonOnly: boolean;
      addons: { id: string; name: string; priceCents: number | null; durationMins: number | null }[]; // barber lists only
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.listServices({ shop: "house-of-cuts-barber-studio-charlottesville" });
  • lookupReservationLooks up an appointment from the confirmation code Squire gives at booking: shop, barber, services, time, total and status.

    Arguments

    NameTypeRequired
    codestringYes

    Returns SquireReservation

    interface SquireReservation {
      id: string | null; confirmationCode: string;
      status: string | null; startTime: string | null; endTime: string | null; // ISO instants
      shop: { id: string | null; name: string | null; route: string | null } | null;
      barber: { id: string | null; name: string | null } | null;
      services: { id: string | null; name: string | null; priceCents: number | null; durationMins: number | null }[];
      totalCents: number | null;
      raw: Record<string, unknown>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/lookupReservation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.lookupReservation("<code>");
  • searchShopsSearches Squire by free text -- a shop or brand name, a barber's name, a city or a street -- and returns the matching barbershops, multi-location…

    Arguments

    NameTypeRequired
    querystringYes
    limitnumberNo

    Returns SquireSearchHit[]

    interface SquireAddress { street: string | null; city: string | null; state: string | null; zip: string | null; country: string | null; }
    
    interface SquireSearchHit {
      type: string;          // "shop" | "brand" | "barber" | "address"
      id: string;
      shopId: string | null; // the shop a shop/barber hit belongs to
      name: string;
      route: string | null;  // what getShop takes
      address: SquireAddress | null;
      shops: { id: string; name: string }[]; // a brand's locations
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/squire/searchShops

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.squire.searchShops({ query: "house of cuts" });

Use it from code