Peek MCP server for AI agents

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

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

Connect

Just Peek

An MCP server for Peek 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/peek
Every site

One MCP server for Peek 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 10
  • getAvailabilityReturns an experience's bookable sessions for a party size over a date range: each date and start/end time in the venue's timezone, the session id…

    Arguments

    NameTypeRequired
    idstring
    An experience id such as "a0q5bg3" (or url: its www.peek.com URL).
    No
    urlstringNo
    startDatestring
    YYYY-MM-DD, inclusive.
    Yes
    endDatestring
    YYYY-MM-DD, inclusive; defaults to startDate.
    No
    quantitynumber
    Number of travelers; defaults to 1.
    No

    Returns PeekAvailability

    interface PeekSession {
      date: string; startTime: string; endTime: string; timezone: string; duration: string | null;
      status: string; spotsLeft: number | null;
      /** The slot id ("at0drp8ayjr") a booking takes. */
      sessionId: string;
      variant: string | null;
      /** Peek's own price list for the slot, in its order. Unlabelled at the source. */
      prices: Array<{ amount: number; currency: string }>;
    }
    
    interface PeekAvailability {
      id: string; title: string | null; quantity: number; startDate: string; endDate: string;
      sessions: PeekSession[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/getAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.getAvailability({
      id: "a0q5bg3",
      quantity: 2,
      startDate: { $daysFromNow: 3 },
      endDate: { $daysFromNow: 17 }
    });
  • getExperienceReturns one experience's full listing: title, tier, description, highlights, what is and is not included, things to know, duration, cancellation…

    Arguments

    NameTypeRequired
    idstring
    An experience id such as "a0q5bg3".
    No
    urlstring
    Or its www.peek.com activity / booking URL.
    No

    Returns PeekExperience

    interface PeekReview { rating: number; title: string; text: string; date: string | null }
    
    interface PeekTicketType { name: string; ages: string | null; min: number | null; max: number | null }
    
    interface PeekExperience {
      id: string; title: string; tier: string | null;
      durationMinutes: { min: number; max: number } | null;
      cancellationMinutesBefore: number | null; travelerRequirements: string | null;
      address: string | null; lat: number | null; lng: number | null; region: string | null;
      price: { amount: number; currency: string } | null;
      rating: number | null; reviewCount: number | null; recentReviews: PeekReview[];
      categories: string[]; operator: string | null; tickets: PeekTicketType[]; images: string[];
      description: string | null; highlights: string[]; included: string[]; excluded: string[];
      cancellationPolicy: string | null; meetingLocation: string | null; toKnow: string[];
      bookingUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/getExperience

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.getExperience({ id: "a0q5bg3" });
  • getMyProfileReturns the signed-in traveler's own profile: name, email and phone.

    Arguments

    None.

    Returns PeekProfile

    interface PeekProfile {
      email: string | null;
      /** Every visible user[...] field on the signed-in settings page, keyed by its own name. */
      fields: Record<string, string>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/getMyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.getMyProfile();
  • getPriceQuotePrices a party for one session: given a sessionId from getAvailability and a quantity of travelers, returns the total Peek charges for that party…

    Arguments

    NameTypeRequired
    idstring
    An experience id such as "a0q5bg3" (or url).
    No
    urlstringNo
    sessionIdstring
    A session id from getAvailability, e.g. "at0drp8ayjr".
    Yes
    quantitynumber
    Number of travelers.
    Yes
    startDatestring
    YYYY-MM-DD, the date getAvailability returned this session on.
    Yes
    endDatestring
    YYYY-MM-DD; defaults to startDate.
    No

    Returns PeekPriceQuote

    interface PeekPriceQuote {
      id: string; sessionId: string; quantity: number;
      total: { amount: number; currency: string }; currency: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/getPriceQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.getPriceQuote({
      sessionId: "<sessionId>",
      quantity: 1,
      startDate: "<startDate>"
    });
  • listDestinationsLists Peek's popular destinations as the home page shows them -- each place's name, region id, URL and how many experiences it has ("London 3856…

    Arguments

    None.

    Returns { destinations: PeekDestination[] }

    interface PeekDestination { id: string; name: string; url: string; experienceCount: number | null; imageUrl: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/listDestinations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.listDestinations();
  • listReviewsAn experience's rating and its most recent reviews (reviewer rating, title, text, date) -- up to 10, Peek's MCP's own ceiling on this door…

    Arguments

    NameTypeRequired
    idstring
    An experience id such as "a0q5bg3".
    No
    urlstring
    Or its www.peek.com activity / booking URL.
    No

    Returns PeekReviewList

    interface PeekReview { rating: number; title: string; text: string; date: string | null }
    
    interface PeekReviewList {
      id: string; rating: number | null; reviewCount: number | null; reviews: PeekReview[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/listReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.listReviews({ id: "a0q5bg3" });
  • listSimilarExperiencesLists the "More activities from this operator" experiences the booking page shows beside one experience, with their ids, titles, urls, price, rating…

    Arguments

    NameTypeRequired
    idstring
    An experience id such as "a0q5bg3".
    No
    urlstring
    Or its www.peek.com activity / booking URL.
    No

    Returns { experiences: PeekSimilarExperience[] }

    interface PeekSimilarExperience {
      id: string; title: string; url: string;
      price: { amount: number; currency: string } | null;
      rating: number | null; reviewCount: number | null; region: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/listSimilarExperiences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.listSimilarExperiences({ id: "a0q5bg3" });
  • listTagsLists Peek's category tags (Adventures, Food & Drink, On the Water, Families, ...) with the tag id searchExperiences filters by.

    Arguments

    None.

    Returns { tags: PeekFacet[] }

    interface PeekFacet { id: string; name: string; count?: number }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/listTags

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.listTags();
  • searchExperiencesSearches Peek's marketplace of tours and activities IN a region (regionId from searchRegions) or NEAR a lat,lng, optionally narrowed by keyword, tag…

    Arguments

    NameTypeRequired
    regionIdstring
    From searchRegions, e.g. "r0gd" (Seattle).
    No
    latLngstring
    "lat,lng", experiences NEAR a point rather than in a region.
    No
    querystring
    One keyword matched against titles ("beer", "kayak"); never a place.
    No
    tagIdstringNo
    categoryIdstringNo
    startDatestring
    YYYY-MM-DD; only experiences running on or after it.
    No
    endDatestring
    YYYY-MM-DD; only experiences running on or before it.
    No
    limitnumberNo

    Returns PeekSearchResult

    interface PeekFacet { id: string; name: string; count?: number }
    
    interface PeekExperienceRow {
      id: string; title: string; address: string | null; lat: number | null; lng: number | null;
      rating: number | null; reviewCount: number | null; description: string; bookingUrl: string;
    }
    
    interface PeekSearchResult {
      total: number | null; experiences: PeekExperienceRow[];
      categories: PeekFacet[]; tags: PeekFacet[]; regions: PeekFacet[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/searchExperiences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.searchExperiences({ regionId: "r0gd" });
  • searchRegionsFinds Peek regions (cities, islands, states, countries) by name and returns each one's region id and full name -- "Seattle" gives r0gd "Seattle…

    Arguments

    NameTypeRequired
    querystringYes
    limitnumberNo

    Returns { regions: PeekRegion[] }

    interface PeekRegion { id: string; name: string; url: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/searchRegions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.searchRegions({ query: "Seattle" });
Act 1
  • updateProfileEdits the signed-in traveler's own profile -- first name, last name, phone or email -- the way the account settings form does.

    Arguments

    NameTypeRequired
    firstNamestringNo
    lastNamestringNo
    phonestringNo
    emailstringNo

    Returns PeekUpdateProfileResult

    interface PeekProfile {
      email: string | null;
      /** Every visible user[...] field on the signed-in settings page, keyed by its own name. */
      fields: Record<string, string>;
    }
    
    interface PeekUpdateProfileResult { updated: string[]; profile: PeekProfile }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/peek/updateProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.peek.updateProfile({});

Use it from code