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.
- Site
- peek.com
- Functions
- 11
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/peekOne MCP server for Peek 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.
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
Name Type Required idstringAn experience id such as "a0q5bg3" (or url: its www.peek.com URL).No urlstringNo startDatestringYYYY-MM-DD, inclusive.Yes endDatestringYYYY-MM-DD, inclusive; defaults to startDate.No quantitynumberNumber of travelers; defaults to 1.No Returns
PeekAvailabilityinterface 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/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.getAvailability({ id: "a0q5bg3", quantity: 2, startDate: { $daysFromNow: 3 }, endDate: { $daysFromNow: 17 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.getAvailability({ "id": "a0q5bg3", "quantity": 2, "startDate": {"$daysFromNow": 3}, "endDate": {"$daysFromNow": 17} }))curl -X POST https://api.bowmark.ai/v1/sites/peek/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"a0q5bg3","quantity":2,"startDate":{"$daysFromNow":3},"endDate":{"$daysFromNow":17}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringAn experience id such as "a0q5bg3".No urlstringOr its www.peek.com activity / booking URL.No Returns
PeekExperienceinterface 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/getExperienceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.getExperience({ id: "a0q5bg3" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.getExperience({"id": "a0q5bg3"}))curl -X POST https://api.bowmark.ai/v1/sites/peek/getExperience \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"a0q5bg3"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.peek.getExperience({ id: "a0q5bg3" });getMyProfileReturns the signed-in traveler's own profile: name, email and phone.Arguments
None.
Returns
PeekProfileinterface 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/getMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.getMyProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.getMyProfile())curl -X POST https://api.bowmark.ai/v1/sites/peek/getMyProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringAn experience id such as "a0q5bg3" (or url).No urlstringNo sessionIdstringA session id from getAvailability, e.g. "at0drp8ayjr".Yes quantitynumberNumber of travelers.Yes startDatestringYYYY-MM-DD, the date getAvailability returned this session on.Yes endDatestringYYYY-MM-DD; defaults to startDate.No Returns
PeekPriceQuoteinterface PeekPriceQuote { id: string; sessionId: string; quantity: number; total: { amount: number; currency: string }; currency: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/peek/getPriceQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.getPriceQuote({ sessionId: "<sessionId>", quantity: 1, startDate: "<startDate>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.getPriceQuote({ "sessionId": "<sessionId>", "quantity": 1, "startDate": "<startDate>" }))curl -X POST https://api.bowmark.ai/v1/sites/peek/getPriceQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"sessionId":"<sessionId>","quantity":1,"startDate":"<startDate>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listDestinationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.listDestinations();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.listDestinations())curl -X POST https://api.bowmark.ai/v1/sites/peek/listDestinations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringAn experience id such as "a0q5bg3".No urlstringOr its www.peek.com activity / booking URL.No Returns
PeekReviewListinterface 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/listReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.listReviews({ id: "a0q5bg3" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.listReviews({"id": "a0q5bg3"}))curl -X POST https://api.bowmark.ai/v1/sites/peek/listReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"a0q5bg3"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringAn experience id such as "a0q5bg3".No urlstringOr 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/listSimilarExperiencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.listSimilarExperiences({ id: "a0q5bg3" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.listSimilarExperiences({"id": "a0q5bg3"}))curl -X POST https://api.bowmark.ai/v1/sites/peek/listSimilarExperiences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"a0q5bg3"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listTagsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.listTags();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.listTags())curl -X POST https://api.bowmark.ai/v1/sites/peek/listTags \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required regionIdstringFrom searchRegions, e.g. "r0gd" (Seattle).No latLngstring"lat,lng", experiences NEAR a point rather than in a region.No querystringOne keyword matched against titles ("beer", "kayak"); never a place.No tagIdstringNo categoryIdstringNo startDatestringYYYY-MM-DD; only experiences running on or after it.No endDatestringYYYY-MM-DD; only experiences running on or before it.No limitnumberNo Returns
PeekSearchResultinterface 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/searchExperiencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.searchExperiences({ regionId: "r0gd" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.searchExperiences({"regionId": "r0gd"}))curl -X POST https://api.bowmark.ai/v1/sites/peek/searchExperiences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"regionId":"r0gd"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringYes limitnumberNo Returns
{ regions: PeekRegion[] }interface PeekRegion { id: string; name: string; url: string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/peek/searchRegionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.searchRegions({ query: "Seattle" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.searchRegions({"query": "Seattle"}))curl -X POST https://api.bowmark.ai/v1/sites/peek/searchRegions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Seattle"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.peek.searchRegions({ query: "Seattle" });
updateProfileEdits the signed-in traveler's own profile -- first name, last name, phone or email -- the way the account settings form does.Arguments
Name Type Required firstNamestringNo lastNamestringNo phonestringNo emailstringNo Returns
PeekUpdateProfileResultinterface 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/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.peek.updateProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.peek.updateProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/peek/updateProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.peek.updateProfile({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/peek/<function> - OpenAPI
/v1/sites/peek/openapi.json