Yelp MCP Server

A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf and any other MCP client three read-only Yelp tools. Search businesses by keyword and location, read one business in full, and page through its complete review feed, all as structured JSON, with no Yelp Fusion key and nothing to host.

It reads public Yelp pages that a signed-out visitor can see, on any of the 41 regional domains.

1,000 free credits every month, no card required, which is 100 Yelp calls at the 10-credit rate.

https://mcp.hasdata.com/mcp?apis=yelp

Contents

• What you need
• Quick start
• Example prompts
• Tools
• Errors and failure paths
• Pricing, free tier and limits
• Tool selection
• How it compares
• FAQ
• HasData links
• Development
• Contributing
• License

What you need

An MCP client and a HasData API key from the dashboard, free to create with no card, and the free tier covers about 100 calls a month at the 10-credit rate. This is a remote server, so the simplest path is a URL and an x-api-key header, with no container to run. A client that only speaks stdio reaches it through a thin launcher, published as @hasdata/yelp-mcp on npm and hasdata-yelp-mcp on PyPI, shown below.

Quick start

The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server.

Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file.

claude mcp add --transport http yelp "https://mcp.hasdata.com/mcp?apis=yelp" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "yelp": {
      "command": "npx",
      "args": ["-y", "@hasdata/yelp-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "yelp": {
      "command": "uvx",
      "args": ["hasdata-yelp-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "yelp": {
      "url": "https://mcp.hasdata.com/mcp?apis=yelp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "yelp": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=yelp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "yelp": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=yelp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Example prompts

Each of these lands on one tool, or on two in sequence when the second needs an identifier the first returns.

• Find coffee roasteries in Austin, TX and rank them by rating against review count.
• Pull the hours, phone and website for the Yelp business desnudo-coffee-austin.
• Read every one-star and two-star review of this business and group the complaints by theme.
• Which dishes does Yelp list as popular for this place, and what do reviewers say about them?
• Compare the rating distribution of these three competitors in the same neighborhood.
• Show me the reviews Yelp does not recommend for this business and how they differ from the recommended ones.

A prompt that names a business rather than a Yelp ID takes two calls, one search to resolve the ID and one place or reviews lookup to read it. The search tool returns both placeId and placeAlias, and either one works as the placeId argument to the place tool.

Tools

Three tools, 10 credits per successful call. Every tool accepts domain to switch country, one of 41 values, from www.yelp.com through the European, Asian and Latin American sites, including the language-specific variants such as fr.yelp.ca and zh.yelp.com.hk.

Get Yelp search results

hasdata_yelp_search_getSearchResults

A page of businesses for a keyword in a place.

Returns searchInformation with the echoed keyword, location and totalResults, an ads array of paid placements, an organicResults array, and pagination with currentPage, perPage, totalPages, nextPageUrl and otherPagesUrls.

The two result arrays are not the same shape. An organic result carries position and streetAddress, while an ad carries neither and adds phone and a highlights array of the badges Yelp shows advertisers. Merging the arrays without checking which one a business came from turns paid placement into rank.

{
  "position": 2,
  "placeId": "oiJ7QuhhpsEpe9zFTZF0bA",
  "placeAlias": "desnudo-coffee-austin",
  "url": "https://www.yelp.com/biz/desnudo-coffee-austin",
  "title": "Desnudo Coffee",
  "streetAddress": "2505 Webberville Rd, Austin",
  "price": "$$",
  "categories": [{ "title": "Coffee Roasteries", "url": "https://www.yelp.com/search?find_desc=Coffee+Roasteries&find_loc=Austin%2C+TX" }],
  "snippet": "My favorite coffee shop to go to ever! Everyone must go. [[HIGHLIGHT]]Great coffee[[ENDHIGHLIGHT]], great vibes,great customer...",
  "rating": 4.7,
  "reviews": 347,
  "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/0nE_IcbRiyxrw3kk2z6owg/ls.jpg",
  "allImagesUrl": "https://www.yelp.com/biz_photos/oiJ7QuhhpsEpe9zFTZF0bA"
}

Get Yelp place details

hasdata_yelp_place_getPlaceDetails

One business in full.

Returns a placeResult object with name, url, address, neighborhoods, country, phone, website, price, categories, rating, reviews, isClaimed and isClaimable, an operationHours object holding a week of hours plus today, a features array, a menu object with popularDishes, a faqs array of questions Yelp readers asked and answered, a reviewHighlights array of the phrases Yelp pins to the top of the page, an images array, and businessMap, a static map image URL.