# 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