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.

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

Connect

Just Yelp

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/yelp
Every site

One MCP server for Yelp 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 16
  • 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/getBookmarks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    refstringYes

    Returns YelpBusiness

    interface 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/getBusiness

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    refstringYes

    Returns YelpCollection

    interface 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/getCollection

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getCollections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    refstringYes

    Returns YelpMenu

    interface 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/getMenu

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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 YelpUser

    interface 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/getOwnProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    businessstring
    A /biz/ url or bare alias from search.
    Yes
    tabstring
    The photo tab from a /biz_photos url's ?tab=; omit for all.
    No
    startnumber
    The previous page's nextStart; 0 by default.
    No

    Returns YelpPhotoPage

    interface 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/getPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    refstringYes

    Returns YelpQuestionPage

    interface 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/getQuestions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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
    querystring
    Yelp's own "search reviews" box.
    No
    afterstring
    NextCursor from the previous page.
    No
    limitnumber
    Per page, default 10, clamped to [1, 50].
    No

    Returns YelpReviewPage

    interface 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/getReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    userIdstringYes

    Returns YelpUser

    interface 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/getUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    refstringYes

    Returns YelpWaitlist

    interface 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/getWaitlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    parentstring
    A category alias, only its direct children, e.g. "japanese".
    No
    querystring
    Case-insensitive match on title or alias, e.g. "ramen".
    No
    countrystring
    ISO 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/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yelp.listCategories({ query: "ramen" });
  • 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

    NameTypeRequired
    citystringYes

    Returns YelpEventPage

    interface 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/searchEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yelp.searchEvents("sf");
  • suggestYelp's own search-as-you-type suggestions for a partial term or place.

    Arguments

    NameTypeRequired
    prefixstring
    What has been typed so far, e.g. "tera".
    Yes
    locationstring
    E.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/suggest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yelp.suggest({ prefix: "terakawa", location: "Philadelphia, PA" });

Use it from code