Yelp MCP Server

Yelp

Read-only Yelp Places (Fusion) coverage: discover businesses, resolve external records to Yelp ids, read ratings and hours, pull review excerpts and highlights, browse categories and community events, and search delivery/pickup/reservation availability.

Typical workflows

1. Match owned locations — when you have name + street address, match first to get stable Yelp business ids. Store ids for repeat monitoring (Yelp permits indefinite id retention).
2. Monitor a portfolio — for each business id, read details for rating and review count, then read review excerpts or review highlights for sentiment snippets.
3. Discover by market — search, autocomplete, or category lookup when the user only knows city + category or partial name.
4. Local events — search events near a property or market; featured event surfaces Yelp's curated pick for a location.
5. On-premise transactions — transaction search finds businesses supporting delivery, pickup, or restaurant reservations near coordinates.

Data limits

• Review excerpts only — at most three short excerpts per business per call; not full review text and not owner replies.
• Reviewed businesses only — search and match omit listings with zero Yelp reviews.
• Engagement metrics — weekly engagement/intent scores require Yelp Insights partner entitlement on the API key.
• Caching — Yelp content other than business ids should not be stored longer than 24 hours outside your live query flow.
• Display — consumer-facing products must follow Yelp brand and attribution rules when showing stars, logos, or review text.

Gotchas

• Prefer the 22-character business id over alias when chaining tools; aliases can include unicode.
• Phone search can return multiple businesses sharing a corporate line.
• Pagination — business search returns up to 240 total matches; event search offset max 1000.
• Transaction search requires latitude and longitude — not a free-text location alone.
• Daily call quotas apply; heavy multi-property monitoring should batch ids deliberately (engagement accepts up to 20 ids per call).