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.
- Site
- getsquire.com
- Functions
- 12
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/squireOne MCP server for Squire 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.
findShopsNearLists Squire barbershops near a place or a latitude/longitude, nearest first: name, route, address, coordinates, rating, photos and whether each…Arguments
Name Type Required nearstringA place name, geocoded first.No latnumberNo lngnumberNo limitnumberDefault 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/findShopsNearCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.findShopsNear({ lat: 38.03, lng: -78.48, limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.findShopsNear({"lat": 38.03, "lng": -78.48, "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/squire/findShopsNear \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"lat":38.03,"lng":-78.48,"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shopstringYes servicestringAn id from listServices, required unless barber is given.No barberstringAn id from listBarbers, that barber's own open times.No durationMinsnumberOnly with barber; default 30.No fromstringNo tostringISO 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/getAvailabilityCall 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" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.getAvailability({ "shop": "house-of-cuts-barber-studio-charlottesville", "service": "7d7f0fa4-bfa2-4046-9c32-7570cf5e045d" }))curl -X POST https://api.bowmark.ai/v1/sites/squire/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shop":"house-of-cuts-barber-studio-charlottesville","service":"7d7f0fa4-bfa2-4046-9c32-7570cf5e045d"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required barberstringYes Returns
SquireBarberinterface 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/getBarberCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.getBarber("e69b0d9d-a7ab-4fd6-926b-b38c38989148");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.getBarber("e69b0d9d-a7ab-4fd6-926b-b38c38989148"))curl -X POST https://api.bowmark.ai/v1/sites/squire/getBarber \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"barber":"e69b0d9d-a7ab-4fd6-926b-b38c38989148"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shopstringId, route or getsquire.com URL.Yes barberstringId from listBarbers, or a slot's barberIds.Yes servicestringId from listServices.No servicesstring[]Service ids from listServices, e.g. "7d7f0fa4-bfa2-4046-9c32-7570cf5e045d".No timestringISO instant from getAvailability.Yes Returns
SquireBookingQuoteinterface 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/getBookingQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.getBookingQuote({ shop: "<shop>", barber: "<barber>", time: "<time>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.getBookingQuote({"shop": "<shop>", "barber": "<barber>", "time": "<time>"}))curl -X POST https://api.bowmark.ai/v1/sites/squire/getBookingQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shop":"<shop>","barber":"<barber>","time":"<time>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required brandstringYes Returns
SquireBrandinterface 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/getBrandCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.getBrand("828e06ac-38a5-4737-bc9b-5d8a335987c7");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.getBrand("828e06ac-38a5-4737-bc9b-5d8a335987c7"))curl -X POST https://api.bowmark.ai/v1/sites/squire/getBrand \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"brand":"828e06ac-38a5-4737-bc9b-5d8a335987c7"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shopstringNo barberstringNo limitnumberNo skipnumberNo Returns
SquireReviewsinterface 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/getReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.getReviews({ shop: "house-of-cuts-barber-studio-charlottesville", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.getReviews({ "shop": "house-of-cuts-barber-studio-charlottesville", "limit": 5 }))curl -X POST https://api.bowmark.ai/v1/sites/squire/getReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shop":"house-of-cuts-barber-studio-charlottesville","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shopstringYes Returns
SquireShopinterface 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/getShopCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.getShop("house-of-cuts-barber-studio-charlottesville");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.getShop("house-of-cuts-barber-studio-charlottesville"))curl -X POST https://api.bowmark.ai/v1/sites/squire/getShop \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"shop":"house-of-cuts-barber-studio-charlottesville"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shopstringYes Returns
SquireWalkInStatusinterface 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/getWalkInStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.getWalkInStatus("house-of-cuts-barber-studio-charlottesville");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.getWalkInStatus("house-of-cuts-barber-studio-charlottesville"))curl -X POST https://api.bowmark.ai/v1/sites/squire/getWalkInStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"shop":"house-of-cuts-barber-studio-charlottesville"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listBarbersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.listBarbers("house-of-cuts-barber-studio-charlottesville");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.listBarbers("house-of-cuts-barber-studio-charlottesville"))curl -X POST https://api.bowmark.ai/v1/sites/squire/listBarbers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"shop":"house-of-cuts-barber-studio-charlottesville"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listServicesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.listServices({ shop: "house-of-cuts-barber-studio-charlottesville" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.listServices({"shop": "house-of-cuts-barber-studio-charlottesville"}))curl -X POST https://api.bowmark.ai/v1/sites/squire/listServices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shop":"house-of-cuts-barber-studio-charlottesville"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required codestringYes Returns
SquireReservationinterface 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/lookupReservationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.lookupReservation("<code>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.lookupReservation("<code>"))curl -X POST https://api.bowmark.ai/v1/sites/squire/lookupReservation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"code":"<code>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchShopsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.squire.searchShops({ query: "house of cuts" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.squire.searchShops({"query": "house of cuts"}))curl -X POST https://api.bowmark.ai/v1/sites/squire/searchShops \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"house of cuts"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.squire.searchShops({ query: "house of cuts" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/squire/<function> - OpenAPI
/v1/sites/squire/openapi.json