Yelp AI Agent
Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Yelp MCP or direct API to search businesses, fetch ratings, analyze reviews, and discover local services through natural language.
Connect on Telegram
Yelp is a local business directory and review platform with millions of listings. Instantly access rich business data, ratings, and customer reviews for location-based services.
▪ Tools & Triggers
Supported Tools and Triggers
Every Yelp action and event your agent gets out of the box.
Get Business Details
Get detailed information about a specific business on Yelp using its business ID or alias. Returns comprehensive business information including hours (in the business's local timezone), photos, reviews, and location details. The returned `url` field is the Yelp listing page, not the business's own website. Response fields such as `phone` and `website` may be null; handle missing values explicitly. Avoid many parallel calls — HTTP 429 throttling applies; limit concurrency to ~5 parallel requests with exponential backoff.
Get Business Reviews
Get reviews for a specific business on Yelp using its business ID or alias. Returns up to 3 review excerpts for the business.
Get Review Highlights
Get review highlights for a specific business on Yelp using its business ID or alias. Returns summarized key points and themes from customer reviews. IMPORTANT: This endpoint requires Yelp Places API Premium Plan access. Without Premium Plan, requests will return a 403 NOT_AUTHORIZED error. For basic review access, consider using the Get Business Reviews action instead, which is available on Enhanced and Premium plans. Note: Get Business Reviews returns at most 3 recent reviews per call, while this action synthesizes themes across the full review history.
Search and Chat
Chat with Yelp's AI assistant to search for businesses, get recommendations, and ask questions. This action provides a conversational interface to Yelp's AI that can: - Search for businesses by type, location, and criteria (e.g., "best Italian restaurants near Times Square") - Answer questions about specific businesses (e.g., "what are the hours for The Purple Pig?") - Provide recommendations based on user preferences - Maintain conversation context when chat_id is provided for follow-up questions The response includes the AI's natural language answer along with detailed business data including ratings, reviews, locations, photos, and attributes for any mentioned businesses.
Search Businesses
Search for businesses on Yelp by location, term, categories, and other filters. Returns at most 50 results per call; use offset to paginate. Overly restrictive filter combinations (categories, price, radius) can yield zero results — loosen iteratively. Results may include businesses from adjacent areas; post-process on location.city or distance for strict boundaries. The returned url field is the Yelp listing page, not the business's own website. Rapid parallel calls can trigger HTTP 429 — apply exponential backoff.
Search Business by Phone
Search for a business by phone number on Yelp. Returns business data including business_id, required by YELP_GET_BUSINESS_DETAILS, YELP_GET_BUSINESS_REVIEWS, and YELP_GET_REVIEW_HIGHLIGHTS. Empty results are inconclusive due to incomplete Yelp coverage.
No matches.
Put Yelp on autopilot
Connect Yelp to your TeleClaw agent and run these 6 tools straight from Telegram.
Get started free