# 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:
```json
{
"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
