Yelp Fusion MCP Server

Access Yelp business data including search, ratings, reviews, and business counts for market research.

Data Available

• Business Search - Find businesses by location, category, keyword
• Business Details - Ratings, reviews, hours, contact info
• Categories - Full list of Yelp business categories
• Business Counts - Total businesses in an area (market sizing)

Setup

1. Create an app at: https://www.yelp.com/developers/v3/manage_app
2. Get your API key from the app dashboard
3. Add to your MCP config:

{
  "yelp": {
    "command": "node",
    "args": ["/path/to/yelp/dist/index.js"],
    "env": {
      "YELP_API_KEY": "your-api-key"
    }
  }
}

Pricing Tiers

Tier	Cost	Daily Calls	Features
Starter	$7.99/1000 calls	300	Basic search, business details
Plus	$9.99/1000 calls	500	+ Reviews endpoint
Enterprise	$14.99/1000 calls	More	+ Review Highlights

Tools

search_businesses

Search for businesses by location, category, or keyword.

Parameter	Required	Description
location	Yes	Location (e.g., "New York, NY", "90210")
term	No	Search term (e.g., "restaurants", "plumbers")
categories	No	Category aliases, comma-separated (e.g., "bars,french")
price	No	Price levels: "1"=$, "2"=$$, "3"=$$$, "4"=$$$$. Comma-separate for multiple
radius	No	Search radius in meters (max 40000)
limit	No	Results to return (max 50, default 20)
sortBy	No	"best_match", "rating", "review_count", "distance"

Example: Find highly-rated Italian restaurants in Chicago

location: "Chicago, IL"
term: "italian"
categories: "restaurants"
sortBy: "rating"
limit: 10

get_business

Get detailed information about a specific business.

Parameter	Required	Description
businessId	Yes	Yelp business ID (from search results)

Returns: Name, rating, review count, price, categories, address, phone, hours, photos

search_by_phone

Find a business by phone number.

Parameter	Required	Description
phone	Yes	Phone with country code (e.g., "+14157492060")

get_reviews

Get up to 3 review excerpts for a business.

Parameter	Required	Description
businessId	Yes	Yelp business ID

Note: Requires Plus tier ($9.99/1000 calls) or higher. Starter tier will receive an error message.

list_categories

List all Yelp business categories with aliases.

Parameter	Required	Description
locale	No	Locale (default: "en_US")

Use case: Find category aliases to use in search_businesses

autocomplete

Get autocomplete suggestions for search terms.

Parameter	Required	Description
text	Yes	Text to autocomplete
latitude	No	Latitude for location context
longitude	No	Longitude for location context

count_businesses

Get total business count for market sizing.

Parameter	Required	Description
location	Yes	Location (e.g., "Los Angeles, CA")
categories	No	Category alias (e.g., "restaurants", "dentists")

Example: Count auto repair shops in LA

location: "Los Angeles, CA"
categories: "autorepair"

Common Categories

Alias	Description
restaurants	Restaurants
bars	Bars
coffee	Coffee & Tea
hotels	Hotels
beautysvc	Beauty & Spas
autorepair	Auto Repair
dentists	Dentists
physicians	Doctors
lawyers	Lawyers
realestate	Real Estate

Rate Limits

• Varies by tier (300-500+ calls/day)
• 5 requests per second max

Documentation

• API Documentation: https://docs.developer.yelp.com/
• Category List: https://www.yelp.com/developers/documentation/v3/all_category_list