FareHarbor MCP server for AI agents

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

Functions
6
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just FareHarbor

An MCP server for FareHarbor 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/fareharbor
Every site

One MCP server for FareHarbor 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

Open a function to see its arguments, what it returns and how to call it.

Read 5
  • getAvailabilitySlotGet details of a specific available time slot including start time, duration, remaining capacity and every bookable ticket type (customer type).

    Arguments

    NameTypeRequired
    operatorstringYes
    itemIdnumberYes
    availabilityIdnumber
    Numeric slot id from listAvailability().slots[].id.
    Yes

    Returns FareharborAvailabilitySlotDetail

    interface FareharborSlot {
      id: number;
      /** Operator-local wall-clock time, no offset. */
      startAt: string;
      endAt: string;
      utcStartAt: string | null;
      utcEndAt: string | null;
      headline: string | null;
      isBookable: boolean;
      isSoldOut: boolean;
      isWaitlist: boolean;
      isBookableOnlyByPhone: boolean;
      /** FareHarbor's own approximate figure; reads 0 on slots that still book. */
      approximateCapacity: number | null;
      bookingUrl: string;
    }
    
    interface FareharborCustomerTypeRate {
      id: number;
      /** The bookable ticket type's name, e.g. "Private Section Seating (2-8 guests)". */
      name: string;
      note: string | null;
      minPartySize: number | null;
      maxPartySize: number | null;
      capacityRemaining: number | null;
    }
    
    interface FareharborAvailabilitySlotDetail extends FareharborSlot {
      bookableCapacity: number | null;
      customerTypeRates: FareharborCustomerTypeRate[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fareharbor/getAvailabilitySlot

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fareharbor.getAvailabilitySlot({ operator: "<operator>", itemId: 1, availabilityId: 1 });
  • getItemGet detailed information about a specific item including title, description, and pricing.

    Arguments

    NameTypeRequired
    operatorstringYes
    itemIdnumber
    Numeric item id from searchItems().items[].id.
    Yes

    Returns FareharborItemDetail

    interface FareharborOperator { shortname: string; name: string; currency: string | null; }
    
    interface FareharborItem {
      id: number;
      name: string;
      headline: string | null;
      shortDescription: string | null;
      imageUrl: string | null;
      minPartySize: number | null;
      maxPartySize: number | null;
      bookingUrl: string;
    }
    
    interface FareharborLocation {
      name: string; street: string | null; city: string | null; province: string | null;
      country: string | null; postalCode: string | null; latitude: number | null; longitude: number | null;
    }
    
    interface FareharborItemDetail extends FareharborItem {
      operator: FareharborOperator;
      description: string | null;
      bookingNotes: string | null;
      cancellationNotes: string | null;
      cancellationPolicy: string | null;
      imageUrls: string[];
      location: FareharborLocation | null;
      isWaitlistWhenFull: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fareharbor/getItem

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fareharbor.getItem({ operator: "sail-nyc", itemId: 25950 });
  • listAvailabilityCheck availability and list available time slots for an item on a specific date.

    Arguments

    NameTypeRequired
    operatorstringYes
    itemIdnumberYes
    datestring
    "YYYY-MM-DD", operator-local.
    Yes

    Returns FareharborAvailability

    interface FareharborSlot {
      id: number;
      /** Operator-local wall-clock time, no offset. */
      startAt: string;
      endAt: string;
      utcStartAt: string | null;
      utcEndAt: string | null;
      headline: string | null;
      isBookable: boolean;
      isSoldOut: boolean;
      isWaitlist: boolean;
      isBookableOnlyByPhone: boolean;
      /** FareHarbor's own approximate figure; reads 0 on slots that still book. */
      approximateCapacity: number | null;
      bookingUrl: string;
    }
    
    interface FareharborAvailability { operator: string; itemId: number; date: string; slots: FareharborSlot[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fareharbor/listAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fareharbor.listAvailability({
      operator: "sail-nyc",
      itemId: 25950,
      date: { $daysFromNow: 7 }
    });
  • quoteBookingPrices a booking up to the payment step (ticket lines, booking fee, tax, total due) from the checkout's own live quote; reserves nothing.

    Arguments

    NameTypeRequired
    operatorstringYes
    itemIdnumberYes
    availabilityIdnumber
    Numeric slot id from listAvailability().slots[].id.
    Yes
    ticketsFareharborQuoteTicket[]Yes

    Returns FareharborBookingQuote

    interface FareharborQuoteLine {
      customerTypeRateId: number;
      name: string;
      count: number;
      /** Minor units (cents). */
      unitPriceCents: number;
      totalCents: number;
    }
    
    interface FareharborBookingQuote {
      operator: string;
      itemId: number;
      availabilityId: number;
      startAt: string | null;
      currency: string | null;
      lines: FareharborQuoteLine[];
      priceCents: number;
      bookingFeeCents: number;
      taxCents: number;
      totalDueCents: number;
      /** What the checkout would take next, e.g. ["card", "applepay"]. */
      paymentMethods: string[];
      /** Where a person finishes the booking, the step this function stops before. */
      checkoutUrl: string;
      // The handoff: give the person checkout.url (it opens this slot; they pick the same
      // tickets) and stop. They book and pay themselves; Bowmark never books.
      checkout: { status: string; url: string; urlKind: string; account: { site: string; hint: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null }[]; total: string | null; currency: string; dates?: { start: string; end?: string }; guests?: number }; warnings: string[] } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fareharbor/quoteBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fareharbor.quoteBooking({
      operator: "<operator>",
      itemId: 1,
      availabilityId: 1,
      tickets: []
    });
  • searchItemsLists every tour, activity or rental a FareHarbor operator sells, optionally filtered by words in the name.

    Arguments

    NameTypeRequired
    operatorstring
    Operator shortname, the segment after /embeds/book/ in a FareHarbor url, e.g. "sail-nyc".
    Yes
    querystring
    Words that must all appear in the item name or headline.
    No
    limitnumber
    Max items returned (default 50, max 200).
    No

    Returns FareharborItemSearch

    interface FareharborOperator { shortname: string; name: string; currency: string | null; }
    
    interface FareharborItem {
      id: number;
      name: string;
      headline: string | null;
      shortDescription: string | null;
      imageUrl: string | null;
      minPartySize: number | null;
      maxPartySize: number | null;
      bookingUrl: string;
    }
    
    interface FareharborItemSearch { operator: FareharborOperator; items: FareharborItem[]; total: number; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fareharbor/searchItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fareharbor.searchItems({ operator: "sail-nyc" });
Act 1
  • createBookingPlaces a booking for a slot and ticket mix under a contact (name, email, phone) through the checkout's own order call; never pays.

    Arguments

    NameTypeRequired
    argsFareharborCreateBookingArgsYes
    interface FareharborQuoteTicket {
      /** customerTypeRates[].id from getAvailabilitySlot, ids differ per slot. Give this or name. */
      customerTypeRateId?: number;
      /** Or the ticket type's exact name, e.g. "Communal Section Seating". */
      name?: string;
      /** How many of this ticket type (default 1). */
      count?: number;
    }
    
    interface FareharborQuoteBookingArgs {
      operator: string;
      itemId: number;
      /** Numeric slot id from listAvailability().slots[].id. */
      availabilityId: number;
      tickets: FareharborQuoteTicket[];
    }
    
    interface FareharborContact {
      name: string;
      email: string;
      phone: string;
    }
    
    interface FareharborCreateBookingArgs extends FareharborQuoteBookingArgs {
      /** The person the booking is for, FareHarbor requires all three. */
      contact: FareharborContact;
    }

    Returns FareharborBookingResult

    interface FareharborBookingResult {
      operator: string;
      itemId: number;
      availabilityId: number;
      /** The order's uuid. */
      orderUuid: string;
      /** FareHarbor's HAL path for the order, "/orders/<uuid>". */
      orderPath: string;
      // the site's own labels, read the values off a result, never guess one from prose
      status: string | null;
      totalDueCents: number | null;
      /** Where a person pays, if the slot needs payment. This function never pays. */
      checkoutUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fareharbor/createBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fareharbor.createBooking("<args>");

Use it from code