Boulevard MCP server for AI agents
Let Claude, ChatGPT or your own agent read Boulevard: 11 typed functions through one MCP server. No Boulevard API key needed.
- Site
- joinblvd.com
- Functions
- 11
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Boulevard 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/boulevardOne MCP server for Boulevard 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.
findBusinessResolves a salon or spa on Boulevard to its business id and profile, from its Boulevard booking slug ("heyday"), a blvd.app/@<slug> or…Arguments
Name Type Required slugOrUrlstringYes Returns
BoulevardBusinessRefinterface BoulevardBusinessRef { /** The business id every other function takes as `business`. */ id: string; name: string; website: string | null; customBookingUrl: string | null; slug: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/findBusinessCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.findBusiness("heyday");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.findBusiness("heyday"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/findBusiness \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slugOrUrl":"heyday"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.findBusiness("heyday");getAvailableDatesLists the dates a service has open appointments at a location within a date range.Arguments
Name Type Required businessstringYes locationIdstringYes serviceIdstringYes fromstringYes tostringYes Returns
BoulevardAvailableDatesinterface BoulevardAvailableDates { /** "YYYY-MM-DD", the dates within the requested range that have an open slot. */ dates: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/getAvailableDatesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.getAvailableDates("<business>", "<locationId>", "<serviceId>", "<from>", "<to>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.getAvailableDates("<business>", "<locationId>", "<serviceId>", "<from>", "<to>"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/getAvailableDates \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"<business>","locationId":"<locationId>","serviceId":"<serviceId>","from":"<from>","to":"<to>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.getAvailableDates("<business>", "<locationId>", "<serviceId>", "<from>", "<to>");getAvailableTimesLists the open appointment start times for a service at a location on one date.Arguments
Name Type Required businessstringYes locationIdstringYes serviceIdstringYes datestringYes tzstringNo Returns
BoulevardAvailableTimesinterface BoulevardAvailableTimes { /** `id` is the bookable time id (e.g. "t_2026-11-02T10:00:00"); `startTime` is ISO with offset. */ times: { id: string; startTime: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/getAvailableTimesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.getAvailableTimes("<business>", "<locationId>", "<serviceId>", "<date>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.getAvailableTimes("<business>", "<locationId>", "<serviceId>", "<date>"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/getAvailableTimes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"<business>","locationId":"<locationId>","serviceId":"<serviceId>","date":"<date>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.getAvailableTimes("<business>", "<locationId>", "<serviceId>", "<date>");getBusinessGets a Boulevard business's profile: name, website, phone, time zone, cancellation fee policy, whether it sells memberships and gift cards online.Arguments
Name Type Required businessstringYes Returns
BoulevardBusinessinterface BoulevardBusiness { id: string; name: string; website: string | null; phoneNumber: string | null; avatar: string | null; customBookingUrl: string | null; /** Fixed late-cancel fee in cents. */ cancellationFeeFixedCents: number | null; cancellationFeePercentage: number | null; hasMemberships: boolean; giftCardMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/getBusinessCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.getBusiness("984d8ec1-2376-488c-9fd4-0a1db765e43f");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.getBusiness("984d8ec1-2376-488c-9fd4-0a1db765e43f"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/getBusiness \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"984d8ec1-2376-488c-9fd4-0a1db765e43f"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.getBusiness("984d8ec1-2376-488c-9fd4-0a1db765e43f");getLocationGets one location's detail: website, avatar, social links, arrival/cancellation policy text, and whether it allows online booking and rescheduling…Arguments
Name Type Required businessstringYes locationIdstringYes Returns
BoulevardLocationDetailinterface BoulevardLocation { /** "urn:blvd:Location:<uuid>", what the location-scoped functions take. */ id: string; name: string; businessName: string; tz: string; isRemote: boolean; allowOnlineBooking: boolean; phoneNumber: string | null; contactEmail: string | null; coordinates: unknown; address: { line1: string | null; line2: string | null; city: string | null; state: string | null; zip: string | null; country: string | null }; /** Seven entries in the site's own order; "HH:MM", null when closed. */ hours: { open: boolean; start: string | null; finish: string | null }[]; } interface BoulevardLocationSocial { instagram: string | null; facebook: string | null; twitter: string | null; yelp: string | null; } interface BoulevardLocationDetail extends BoulevardLocation { website: string | null; avatar: string | null; allowOnlineRescheduling: boolean; /** The business's own cancellation/arrival policy text, HTML-free. */ arrivalInstructions: string | null; social: BoulevardLocationSocial | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/getLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.getLocation("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.getLocation("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/getLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"984d8ec1-2376-488c-9fd4-0a1db765e43f","locationId":"urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.getLocation("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b");getServiceDetailsGets one service's full detail at a location: description, price and duration range, and its option groups (add-ons and upgrades a client can pick).Arguments
Name Type Required businessstringYes locationIdstringYes serviceIdstringYes Returns
BoulevardServiceDetailinterface BoulevardService { /** "urn:blvd:Service:<uuid>", what getServiceDetails and the booking flow take. */ id: string; name: string; description: string | null; priceCentsMin: number | null; priceCentsMax: number | null; durationMinMin: number | null; durationMinMax: number | null; } interface BoulevardServiceOptionGroup { id: string; name: string; options: { id: string; name: string }[]; } interface BoulevardServiceDetail extends BoulevardService { optionGroups: BoulevardServiceOptionGroup[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/getServiceDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.getServiceDetails("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b", "urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.getServiceDetails("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b", "urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/getServiceDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"984d8ec1-2376-488c-9fd4-0a1db765e43f","locationId":"urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b","serviceId":"urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.getServiceDetails("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b", "urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3");listBookingQuestionsLists the intake questions a business asks before it confirms a booking of a service (label, required, answer type, choices), so a caller can answer…Arguments
Name Type Required businessstringYes locationIdstringYes serviceIdstringYes Returns
BoulevardBookingQuestionsinterface BoulevardBookingQuestions { /** Intake questions the business asks before booking this service; often empty. `valueType` is BOOLEAN, DATETIME, FLOAT, INTEGER, MULTISELECT, SELECT or TEXT; `options` fill SELECT / MULTISELECT. */ questions: { id: string; key: string; label: string; required: boolean; valueType: string; displayType: string; options: { id: string; label: string }[]; }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/listBookingQuestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.listBookingQuestions("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b", "urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.listBookingQuestions("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b", "urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/listBookingQuestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"984d8ec1-2376-488c-9fd4-0a1db765e43f","locationId":"urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b","serviceId":"urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.listBookingQuestions("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b", "urn:blvd:Service:1498a8f3-0030-4cc1-a3c0-d6c998b34ed3");listLocationsLists a business's locations: id, name, full address, coordinates, time zone, opening hours and whether each takes online bookings.Arguments
Name Type Required businessstringYes Returns
BoulevardLocationsinterface BoulevardLocation { /** "urn:blvd:Location:<uuid>", what the location-scoped functions take. */ id: string; name: string; businessName: string; tz: string; isRemote: boolean; allowOnlineBooking: boolean; phoneNumber: string | null; contactEmail: string | null; coordinates: unknown; address: { line1: string | null; line2: string | null; city: string | null; state: string | null; zip: string | null; country: string | null }; /** Seven entries in the site's own order; "HH:MM", null when closed. */ hours: { open: boolean; start: string | null; finish: string | null }[]; } interface BoulevardLocations { locations: BoulevardLocation[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/listLocationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.listLocations("984d8ec1-2376-488c-9fd4-0a1db765e43f");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.listLocations("984d8ec1-2376-488c-9fd4-0a1db765e43f"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/listLocations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"984d8ec1-2376-488c-9fd4-0a1db765e43f"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.listLocations("984d8ec1-2376-488c-9fd4-0a1db765e43f");listPackagesAndMembershipsLists the memberships, packages, products and gift cards a location sells online, with price.Arguments
Name Type Required businessstringYes locationIdstringYes Returns
BoulevardPackagesAndMembershipsinterface BoulevardPackagesAndMemberships { /** What the location sells online besides appointments: memberships, packages and products (`kind: "product"`) and gift cards. Prices in cents. */ items: { id: string; name: string; category: string; kind: "product" | "giftCard"; description: string | null; priceMinCents: number | null; priceMaxCents: number | null; available: boolean; unavailableReason: string | null; agreementRequired: boolean; }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/listPackagesAndMembershipsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.listPackagesAndMemberships("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.listPackagesAndMemberships("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/listPackagesAndMemberships \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"984d8ec1-2376-488c-9fd4-0a1db765e43f","locationId":"urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.listPackagesAndMemberships("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b");listServicesLists the services a location books online, grouped by category, with price range and duration (facials, haircuts, massages, add-on enhancements).Arguments
Name Type Required businessstringYes locationIdstringYes Returns
BoulevardServicesinterface BoulevardService { /** "urn:blvd:Service:<uuid>", what getServiceDetails and the booking flow take. */ id: string; name: string; description: string | null; priceCentsMin: number | null; priceCentsMax: number | null; durationMinMin: number | null; durationMinMax: number | null; } interface BoulevardServiceCategory { name: string; services: BoulevardService[]; } interface BoulevardServices { categories: BoulevardServiceCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/listServicesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.listServices("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.listServices("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/listServices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"984d8ec1-2376-488c-9fd4-0a1db765e43f","locationId":"urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.listServices("984d8ec1-2376-488c-9fd4-0a1db765e43f", "urn:blvd:Location:9cf5ed29-c81f-409f-920d-eb5d3dfaa37b");listStaffForTimeLists the staff members (and any per-staff price or duration variant) who can perform a service at a chosen open time, so a caller can book a…Arguments
Name Type Required businessstringYes locationIdstringYes serviceIdstringYes timeIdstringYes Returns
BoulevardStaffForTimeinterface BoulevardStaffForTime { /** Who can perform the service at that time; `priceCents` / `durationMinutes` are that staff member's variant. */ staff: { variantId: string; staffId: string; name: string; firstName: string; lastName: string; role: string | null; bio: string | null; avatar: string | null; durationMinutes: number; priceCents: number; }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/boulevard/listStaffForTimeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.boulevard.listStaffForTime("<business>", "<locationId>", "<serviceId>", "<timeId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.boulevard.listStaffForTime("<business>", "<locationId>", "<serviceId>", "<timeId>"))curl -X POST https://api.bowmark.ai/v1/sites/boulevard/listStaffForTime \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business":"<business>","locationId":"<locationId>","serviceId":"<serviceId>","timeId":"<timeId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.boulevard.listStaffForTime("<business>", "<locationId>", "<serviceId>", "<timeId>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/boulevard/<function> - OpenAPI
/v1/sites/boulevard/openapi.json