Access Yelp business data including search, ratings, reviews, and business counts for market research.
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 |
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
Tools (7)
search_businessesSearch for businesses by location, category, or keyword.get_businessGet detailed information about a specific business.search_by_phoneFind a business by phone number.get_reviewsGet up to 3 review excerpts for a business.list_categoriesList all Yelp business categories with aliases.autocompleteGet autocomplete suggestions for search terms.count_businessesGet total business count for market sizing.Environment Variables
YELP_API_KEYrequiredAPI key from Yelp developer dashboardConfiguration
{
"yelp": {
"command": "node",
"args": ["/path/to/yelp/dist/index.js"],
"env": {
"YELP_API_KEY": "your-api-key"
}
}
}