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.
- Site
- fareharbor.com
- Functions
- 6
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/fareharborOne MCP server for FareHarbor 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
Open a function to see its arguments, what it returns and how to call it.
getAvailabilitySlotGet details of a specific available time slot including start time, duration, remaining capacity and every bookable ticket type (customer type).Arguments
Name Type Required operatorstringYes itemIdnumberYes availabilityIdnumberNumeric slot id from listAvailability().slots[].id.Yes Returns
FareharborAvailabilitySlotDetailinterface 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/getAvailabilitySlotCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fareharbor.getAvailabilitySlot({ operator: "<operator>", itemId: 1, availabilityId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fareharbor.getAvailabilitySlot({"operator": "<operator>", "itemId": 1, "availabilityId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/fareharbor/getAvailabilitySlot \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"operator":"<operator>","itemId":1,"availabilityId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fareharbor.getAvailabilitySlot({ operator: "<operator>", itemId: 1, availabilityId: 1 });getItemGet detailed information about a specific item including title, description, and pricing.Arguments
Name Type Required operatorstringYes itemIdnumberNumeric item id from searchItems().items[].id.Yes Returns
FareharborItemDetailinterface 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/getItemCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fareharbor.getItem({ operator: "sail-nyc", itemId: 25950 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fareharbor.getItem({"operator": "sail-nyc", "itemId": 25950}))curl -X POST https://api.bowmark.ai/v1/sites/fareharbor/getItem \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"operator":"sail-nyc","itemId":25950}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required operatorstringYes itemIdnumberYes datestring"YYYY-MM-DD", operator-local.Yes Returns
FareharborAvailabilityinterface 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/listAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fareharbor.listAvailability({ operator: "sail-nyc", itemId: 25950, date: { $daysFromNow: 7 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fareharbor.listAvailability({ "operator": "sail-nyc", "itemId": 25950, "date": {"$daysFromNow": 7} }))curl -X POST https://api.bowmark.ai/v1/sites/fareharbor/listAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"operator":"sail-nyc","itemId":25950,"date":{"$daysFromNow":7}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required operatorstringYes itemIdnumberYes availabilityIdnumberNumeric slot id from listAvailability().slots[].id.Yes ticketsFareharborQuoteTicket[]Yes Returns
FareharborBookingQuoteinterface 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/quoteBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fareharbor.quoteBooking({ operator: "<operator>", itemId: 1, availabilityId: 1, tickets: [] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fareharbor.quoteBooking({ "operator": "<operator>", "itemId": 1, "availabilityId": 1, "tickets": [] }))curl -X POST https://api.bowmark.ai/v1/sites/fareharbor/quoteBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"operator":"<operator>","itemId":1,"availabilityId":1,"tickets":[]}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required operatorstringOperator shortname, the segment after /embeds/book/ in a FareHarbor url, e.g. "sail-nyc".Yes querystringWords that must all appear in the item name or headline.No limitnumberMax items returned (default 50, max 200).No Returns
FareharborItemSearchinterface 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/searchItemsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fareharbor.searchItems({ operator: "sail-nyc" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fareharbor.searchItems({"operator": "sail-nyc"}))curl -X POST https://api.bowmark.ai/v1/sites/fareharbor/searchItems \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"operator":"sail-nyc"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fareharbor.searchItems({ operator: "sail-nyc" });
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
Name Type Required 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
FareharborBookingResultinterface 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/createBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fareharbor.createBooking("<args>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fareharbor.createBooking("<args>"))curl -X POST https://api.bowmark.ai/v1/sites/fareharbor/createBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"<args>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fareharbor.createBooking("<args>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/fareharbor/<function> - OpenAPI
/v1/sites/fareharbor/openapi.json