> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Yelp

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Find sushi restaurants with 4+ stars within 2 miles, open now.
* Pull the top 10 coffee shops in the Mission, sorted by review count.
* Show me the average rating and review count for our top 3 competitors.

## Available Tools

#### autocomplete

Get autocomplete suggestions for search text. Returns matching terms, businesses, and categories. Optionally provide lat/lng for location-aware results.

#### search\_businesses

Search businesses by term, location, category, price, and more. Requires location or latitude/longitude. Returns up to 50 per page, 1000 total via offset pagination.

#### search\_businesses\_by\_phone

Find businesses by phone number. Phone must include + and country code (e.g. '+14157492060').

#### match\_business

Match a business by name, address, city, state, and country. Returns best-matching Yelp business. Use match\_threshold='none' to get all potential matches.

#### get\_business

Get detailed info for a business by ID or alias, including hours, photos, price, rating, and location. Use search\_businesses to find IDs.

#### search\_food\_delivery

Search businesses that offer food delivery. Requires location or latitude/longitude. Currently US-only.

#### get\_service\_offerings

Get service offerings for a business (e.g. plumbing, electrical). Requires Yelp Partner API access.

#### get\_engagement\_metrics

Get engagement metrics (page views, ad clicks, calls, etc.) for one or more businesses. Requires Yelp Partner API access.

#### get\_business\_insights

Get business insights including review trends and competitive benchmarks. Requires Yelp Partner API access.

#### get\_food\_and\_drinks\_insights

Get food and drink insights for a business, including trending items. Requires Yelp Partner API access.

#### get\_risk\_signal\_insights

Get risk signal insights for a business (e.g. health inspection issues). Requires Yelp Partner API access.

#### list\_categories

List all Yelp business categories. Optionally filter/translate by locale. Returns alias, title, and parent categories.

#### get\_category

Get details for a specific category by alias (e.g. 'pizza'). Use list\_categories to find valid aliases. Requires developer beta.

#### search\_events

Search for events by location, category, date range, and more. Requires location or lat/lng. Supports offset pagination. Requires developer beta.

#### get\_event

Get details for a specific event by ID. Use search\_events to find event IDs. Requires developer beta.

#### get\_featured\_event

Get the featured event for a location. Requires location or latitude/longitude. Requires developer beta.

#### get\_reviews

Get reviews for a business. Supports pagination via limit/offset and sorting by 'yelp\_sort' or 'newest'. Use search\_businesses to find business IDs.

#### get\_review\_highlights

Get review highlight excerpts for a business, showing key themes from reviews. Use search\_businesses to find business IDs.