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