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.

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

Connect

Just Boulevard

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

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

    NameTypeRequired
    slugOrUrlstringYes

    Returns BoulevardBusinessRef

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.boulevard.findBusiness("heyday");
  • getAvailableDatesLists the dates a service has open appointments at a location within a date range.

    Arguments

    NameTypeRequired
    businessstringYes
    locationIdstringYes
    serviceIdstringYes
    fromstringYes
    tostringYes

    Returns BoulevardAvailableDates

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

    Call it

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

    NameTypeRequired
    businessstringYes
    locationIdstringYes
    serviceIdstringYes
    datestringYes
    tzstringNo

    Returns BoulevardAvailableTimes

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

    Call it

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

    NameTypeRequired
    businessstringYes

    Returns BoulevardBusiness

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

    Call it

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

    NameTypeRequired
    businessstringYes
    locationIdstringYes

    Returns BoulevardLocationDetail

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

    Call 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");
  • 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

    NameTypeRequired
    businessstringYes
    locationIdstringYes
    serviceIdstringYes

    Returns BoulevardServiceDetail

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

    Call 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");
  • 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

    NameTypeRequired
    businessstringYes
    locationIdstringYes
    serviceIdstringYes

    Returns BoulevardBookingQuestions

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

    Call 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");
  • listLocationsLists a business's locations: id, name, full address, coordinates, time zone, opening hours and whether each takes online bookings.

    Arguments

    NameTypeRequired
    businessstringYes

    Returns BoulevardLocations

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

    Call it

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

    NameTypeRequired
    businessstringYes
    locationIdstringYes

    Returns BoulevardPackagesAndMemberships

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

    Call 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");
  • listServicesLists the services a location books online, grouped by category, with price range and duration (facials, haircuts, massages, add-on enhancements).

    Arguments

    NameTypeRequired
    businessstringYes
    locationIdstringYes

    Returns BoulevardServices

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

    Call 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");
  • 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

    NameTypeRequired
    businessstringYes
    locationIdstringYes
    serviceIdstringYes
    timeIdstringYes

    Returns BoulevardStaffForTime

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.boulevard.listStaffForTime("<business>", "<locationId>", "<serviceId>", "<timeId>");

Use it from code