MCP 服务器

Yelp Fusion MCP Server

Provides access to Yelp's business database for searching local businesses, retrieving detailed ratings and reviews, and performing market research through business counts. It enables users to look up businesses by location, category, or phone number using the Yelp Fusion API.

README

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

Create an app at: https://www.yelp.com/developers/v3/manage_app
Get your API key from the app dashboard
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