Yelp MCP server for AI agents
Let Claude, ChatGPT or your own agent read Yelp: 16 typed functions through one MCP server. No Yelp API key needed.
- Site
- yelp.com
- Functions
- 16
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Yelp 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/yelpOne MCP server for Yelp 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.
getBookmarksLists the businesses the signed-in caller has bookmarked on Yelp (their own My Bookmarks page): alias, name and url for each, in page order; [] when…Arguments
None.
Returns
YelpBookmarks// getBookmarks: the signed-in caller's own "My Bookmarks" interface YelpBookmark { alias: string; // what getBusiness / getReviews take name: string; url: string; } interface YelpBookmarks { bookmarks: YelpBookmark[]; // page order; [] when nothing is saved }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getBookmarksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getBookmarks();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getBookmarks())curl -X POST https://api.bowmark.ai/v1/sites/yelp/getBookmarks \ -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.yelp.getBookmarks();getBusinessReads one business's own schema.org listing off its /biz/<alias> page: name, phone, address, coordinates, Yelp's own star rating and review count…Arguments
Name Type Required refstringYes Returns
YelpBusinessinterface YelpBusiness { name: string; url: string; alias: string; phone: string | null; address: { street: string | null; city: string | null; state: string | null; zip: string | null; country: string | null } | null; coordinates: { lat: number; lng: number } | null; rating: number | null; reviewCount: number | null; priceRange: string | null; categories: string[]; // breadcrumb path, root first ("Restaurants", "Japanese", "Ramen") hours: { day: string; opens: string; closes: string }[]; amenities: { name: string; value: boolean }[]; paymentAccepted: string[]; photoUrl: string | null; videoCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getBusinessCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getBusiness("terakawa-ramen-philadelphia");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getBusiness("terakawa-ramen-philadelphia"))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getBusiness \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"terakawa-ramen-philadelphia"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getBusiness("terakawa-ramen-philadelphia");getCollectionReads a public Yelp collection (a member's named list of places) from its /collection/<id> url: title, description, owner, follower and place counts…Arguments
Name Type Required refstringYes Returns
YelpCollectioninterface YelpCollectionBusiness { alias: string | null; // → getBusiness name: string; url: string | null; rating: number | null; reviewCount: number | null; city: string | null; region: string | null; imageUrl: string | null; } interface YelpCollection { id: string; title: string | null; url: string | null; description: string | null; ownerId: string | null; // → getUser ownerName: string | null; followerCount: number | null; placeCount: number | null; // the whole list; businesses holds the first page (up to 30) businesses: YelpCollectionBusiness[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getCollectionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getCollection("OECwzrFwhKtS-WwvrtPkYA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getCollection("OECwzrFwhKtS-WwvrtPkYA"))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getCollection \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"OECwzrFwhKtS-WwvrtPkYA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getCollection("OECwzrFwhKtS-WwvrtPkYA");getCollectionsLists the signed-in caller's own Yelp collections (their My Collections page): id, title and url for each, in page order; [] when none.Arguments
None.
Returns
YelpOwnCollections// getCollections: the signed-in caller's own collections interface YelpOwnCollection { id: string; title: string; url: string; // pass to getCollection } interface YelpOwnCollections { collections: YelpOwnCollection[]; // page order; [] when none }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getCollectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getCollections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getCollections())curl -X POST https://api.bowmark.ai/v1/sites/yelp/getCollections \ -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.yelp.getCollections();getMenuReads a restaurant's menu from its /menu/<alias> page's own ld+json Menu block: each section (e.g. Appetizers, Ramen) and its items' name, item-page…Arguments
Name Type Required refstringYes Returns
YelpMenuinterface YelpMenuItem { name: string; url: string | null; // /menu/<alias>/item/<slug> description: string | null; price: number | null; priceCurrency: string | null; // "USD" } interface YelpMenuSection { name: string; // e.g. "Ramen", "Appetizers" items: YelpMenuItem[]; } interface YelpMenu { name: string; // e.g. "Terakawa Ramen Menu" sections: YelpMenuSection[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getMenuCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getMenu("terakawa-ramen-philadelphia");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getMenu("terakawa-ramen-philadelphia"))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getMenu \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"terakawa-ramen-philadelphia"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getMenu("terakawa-ramen-philadelphia");getMessagesLists the threads in the signed-in caller's own Yelp inbox (/messaging/inbox): id, url and preview text for each, in page order; [] when empty.Arguments
None.
Returns
YelpMessages// getMessages: the signed-in caller's own Yelp inbox interface YelpMessageThread { id: string; url: string; preview: string; // the thread's visible text as the inbox shows it } interface YelpMessages { threads: YelpMessageThread[]; // page order; [] when the inbox is empty }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getMessages();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getMessages())curl -X POST https://api.bowmark.ai/v1/sites/yelp/getMessages \ -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.yelp.getMessages();getOwnProfileReads the signed-in caller's own Yelp profile (their /user_details page): name, location, join month, tagline, photo, Elite years…Arguments
None.
Returns
YelpUserinterface YelpUserReview { id: string; rating: number | null; text: string | null; createdAt: string | null; // business-local ISO time business: { alias: string | null; name: string | null; city: string | null }; // alias → getBusiness } interface YelpUser { id: string; // the userid, e.g. from a getReviews row's author.id name: string | null; // e.g. "Vince C." location: string | null; joined: string | null; // Yelp's own month, e.g. "September 2013" tagline: string | null; photoUrl: string | null; eliteYears: number[]; reviewCount: number; photoCount: number; friendCount: number; followerCount: number; complimentCount: number; about: Record<string, string>; // filled-in "About" answers keyed by Yelp's own prompt recentReviews: YelpUserReview[]; // the latest 5 the profile shows }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getOwnProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getOwnProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getOwnProfile())curl -X POST https://api.bowmark.ai/v1/sites/yelp/getOwnProfile \ -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.yelp.getOwnProfile();getPhotosLists a business's photos from its /biz_photos/<alias> page, 30 at a time (optionally one photo tab, paged by start): each photo's full-size url…Arguments
Name Type Required businessstringA /biz/ url or bare alias from search.Yes tabstringThe photo tab from a /biz_photos url's ?tab=; omit for all.No startnumberThe previous page's nextStart; 0 by default.No Returns
YelpPhotoPageinterface YelpPhoto { url: string; // full-size image thumbnailUrl: string | null; caption: string | null; uploadDate: string | null; // ISO instant uploader: string | null; // display name, e.g. "Hesper W." } interface YelpPhotoPage { photos: YelpPhoto[]; // up to 30, Yelp's own page size start: number; nextStart: number | null; // pass back as start for the next page; null on the last }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getPhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getPhotos({ business: "terakawa-ramen-philadelphia", tab: "food" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getPhotos({"business": "terakawa-ramen-philadelphia", "tab": "food"}))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getPhotos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":"terakawa-ramen-philadelphia","tab":"food"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getPhotos({ business: "terakawa-ramen-philadelphia", tab: "food" });getQuestionsReads a business's Ask the Community questions from its /questions/ page: each question's text, asker, relative date, answer count, top answer and…Arguments
Name Type Required refstringYes Returns
YelpQuestionPageinterface YelpAnswer { id: string; text: string; author: string | null; // display name, e.g. "Peter P." createdAt: string | null; // ISO instant helpfulCount: number; } interface YelpQuestion { id: string; text: string; author: string | null; askedAgo: string | null; // Yelp's own relative date, e.g. "5 years ago" answerCount: number; topAnswer: YelpAnswer | null; // null when nobody has answered aiAnswer: string | null; // Yelp's own AI-generated answer, when it shows one } interface YelpQuestionPage { business: { alias: string | null; name: string | null }; totalCount: number; // every question the business has questions: YelpQuestion[]; // the first 10, Yelp's own "best" order }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getQuestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getQuestions("terakawa-ramen-philadelphia");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getQuestions("terakawa-ramen-philadelphia"))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getQuestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"terakawa-ramen-philadelphia"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getQuestions("terakawa-ramen-philadelphia");getReviewsLists a business's reviews a page at a time with Yelp's own sorts (relevance, newest, oldest, highest, lowest, Elites), a star filter and search…Arguments
Name Type Required businessstring/biz/ url or alias, from search.Yes sort"relevance" | "newest" | "oldest" | "highest" | "lowest" | "elites"No starsnumber[]Only these star ratings, e.g. [1, 2].No querystringYelp's own "search reviews" box.No afterstringNextCursor from the previous page.No limitnumberPer page, default 10, clamped to [1, 50].No Returns
YelpReviewPageinterface YelpReviewPage { business: { id: string; alias: string; name: string; rating: number | null; reviewCount: number | null }; totalCount: number | null; // reviews matching these filters countsByRating: { 1: number; 2: number; 3: number; 4: number; 5: number } | null; reviews: { id: string; rating: number | null; text: string; language: string | null; date: string | null; // business-local ISO time author: { id: string | null; name: string | null; location: string | null; reviewCount: number | null; friendCount: number | null; photoCount: number | null; eliteYear: string | null }; photos: { url: string; caption: string | null }[]; reactions: { type: string; count: number }[]; // HELPFUL, THANKS, LOVE_THIS, OH_NO ownerReply: string | null; }[]; nextCursor: string | null; // pass as after; null on the last page }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getReviews({ business: "terakawa-ramen-philadelphia", sort: "newest" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getReviews({ "business": "terakawa-ramen-philadelphia", "sort": "newest" }))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":"terakawa-ramen-philadelphia","sort":"newest"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getReviews({ business: "terakawa-ramen-philadelphia", sort: "newest" });getUserReads a public Yelp member profile from /user_details?userid=<id>: name, location, join month, tagline, photo, Elite years, review, photo, friend…Arguments
Name Type Required userIdstringYes Returns
YelpUserinterface YelpUserReview { id: string; rating: number | null; text: string | null; createdAt: string | null; // business-local ISO time business: { alias: string | null; name: string | null; city: string | null }; // alias → getBusiness } interface YelpUser { id: string; // the userid, e.g. from a getReviews row's author.id name: string | null; // e.g. "Vince C." location: string | null; joined: string | null; // Yelp's own month, e.g. "September 2013" tagline: string | null; photoUrl: string | null; eliteYears: number[]; reviewCount: number; photoCount: number; friendCount: number; followerCount: number; complimentCount: number; about: Record<string, string>; // filled-in "About" answers keyed by Yelp's own prompt recentReviews: YelpUserReview[]; // the latest 5 the profile shows }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getUser("74YfCVzn3CXIlyIpWtH0dg");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getUser("74YfCVzn3CXIlyIpWtH0dg"))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"74YfCVzn3CXIlyIpWtH0dg"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getUser("74YfCVzn3CXIlyIpWtH0dg");getWaitlistReads a restaurant's Yelp Waitlist state off its business page: whether it is on Yelp Waitlist at all, whether it is taking parties right now, the…Arguments
Name Type Required refstringYes Returns
YelpWaitlistinterface YelpWaitlist { onWaitlist: boolean; // false = not on Yelp Waitlist; every other field is then null open: boolean | null; // taking waitlist parties right now status: string | null; // Yelp's own status word, e.g. "restaurant_closed", the site's own labels, read the values off a result, never guess one from prose minWaitMinutes: number | null; // quoted wait, when open maxWaitMinutes: number | null; closedText: string | null; // Yelp's own line when closed, e.g. "Waitlist usually opens at 11:00 am" bizId: string | null; // Yelp's encrypted business id bizName: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/getWaitlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.getWaitlist("marufuku-ramen-san-francisco-9");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.getWaitlist("marufuku-ramen-san-francisco-9"))curl -X POST https://api.bowmark.ai/v1/sites/yelp/getWaitlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ref":"marufuku-ramen-san-francisco-9"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.getWaitlist("marufuku-ramen-san-francisco-9");listCategoriesLists Yelp's business categories (about 1,600) from Yelp's own published category list: each one's alias (what search's category filter takes)…Arguments
Name Type Required parentstringA category alias, only its direct children, e.g. "japanese".No querystringCase-insensitive match on title or alias, e.g. "ramen".No countrystringISO code, e.g. "US", only categories Yelp lists there.No Returns
YelpCategory[]interface YelpCategory { alias: string; // pass as search's category title: string; parent: string | null; // parent's alias; null at the top level depth: number; // 0 = top level countries: "all" | string[]; // ISO codes }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.listCategories({ query: "ramen" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.listCategories({"query": "ramen"}))curl -X POST https://api.bowmark.ai/v1/sites/yelp/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"ramen"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.listCategories({ query: "ramen" });searchRuns Yelp's own business search for a term and location.Arguments
Name Type Required termstringE.g. "ramen", Yelp's own find_desc.Yes locationstringE.g. "Philadelphia, PA", Yelp's own find_loc.Yes limitnumberDefault 10, clamped to [1, 30].No sort"recommended" | "rating" | "review_count"No pricenumber[]Tiers 1-4 = "$".."$$$$".No openNowbooleanNo featuresstring[]The site's own labels, read the values off a result, never guess one from prose.No categorystringCategory alias, e.g. "ramen".No startnumberOffset: 10 = page 2, 20 = page 3.No Returns
YelpSearchResult[]interface YelpSearchResult { name: string; url: string; alias: string; // pass to getBusiness / getReviews rating: number | null; reviewCount: number | null; priceRange: string | null; // "$".."$$$$", or null neighborhood: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.search({ term: "ramen", location: "Philadelphia, PA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.search({"term": "ramen", "location": "Philadelphia, PA"}))curl -X POST https://api.bowmark.ai/v1/sites/yelp/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"term":"ramen","location":"Philadelphia, PA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.search({ term: "ramen", location: "Philadelphia, PA" });searchEventsLists the events on a city's Yelp Events browse page (its first page, in the order the page shows them): each one's name, url, start time, the card's…Arguments
Name Type Required citystringYes Returns
YelpEventPageinterface YelpEventVenue { alias: string | null; // → getBusiness name: string; } interface YelpEvent { name: string; url: string; // the event's own /events/<slug> page startDate: string | null; when: string | null; // the card's own wording, e.g. "Tomorrow, Nov 13, 7:00 pm – 9:30 pm" venue: YelpEventVenue | null; locale: string | null; // the text after the venue, e.g. "Oakland" description: string | null; // Yelp's own text, already truncated with "…" by the site category: string | null; // the card's footer category, e.g. "Food & Drink" interestedCount: number | null; imageUrl: string | null; official: boolean; // Yelp's own event ("Official Yelp Event") } interface YelpEventPage { events: YelpEvent[]; warnings: string[]; // cards Yelp listed without a name or a link, left out }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/searchEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.searchEvents("sf");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.searchEvents("sf"))curl -X POST https://api.bowmark.ai/v1/sites/yelp/searchEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"city":"sf"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.searchEvents("sf");suggestYelp's own search-as-you-type suggestions for a partial term or place.Arguments
Name Type Required prefixstringWhat has been typed so far, e.g. "tera".Yes locationstringE.g. "Philadelphia, PA".Yes Returns
YelpSuggestion[]interface YelpSuggestion { title: string; subtitle: string | null; // a business's city, or "See all nearby locations" for a chain type: string; // "business" | "chain" | "category" | "common" query: string; // pass as search's term alias: string | null; // business rows only, pass to getBusiness url: string | null; refinements: string[]; // narrower queries Yelp offers, e.g. "Plumbers - Drain Cleaning" thumbnail: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yelp/suggestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yelp.suggest({ prefix: "terakawa", location: "Philadelphia, PA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yelp.suggest({"prefix": "terakawa", "location": "Philadelphia, PA"}))curl -X POST https://api.bowmark.ai/v1/sites/yelp/suggest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"prefix":"terakawa","location":"Philadelphia, PA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yelp.suggest({ prefix: "terakawa", location: "Philadelphia, PA" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/yelp/<function> - OpenAPI
/v1/sites/yelp/openapi.json