# Yelp Fusion MCP > Yelp Fusion lets your agent dig deep into local commerce data. Search for businesses by category or location, check operational hours, find recent customer reviews, and discover upcoming local events worldwide. It pulls together business details, service offerings, and event schedules from Yelp's massive database directly into your chat. ## Overview - **Category:** travel-hospitality - **Price:** Free - **Tags:** local-search, restaurant-reviews, business-directory, yelp-api, event-discovery ## Description Need to know the best place to eat in a new city? This MCP connects your AI agent directly to Yelp’s rich global data pool. You can find everything from specific restaurant cuisines and neighborhoods to detailed business hours and customer reviews, all without leaving your chat interface. Need to research market trends? You can analyze business density or track service offerings available in a given area. It even finds local events and helps you pinpoint businesses that support food delivery. Because this data comes from so many angles—reviews, categories, jobs, transactions—you need visibility into what's happening behind the scenes. That’s where Vinkius AI Analytics steps up; it gives you full visibility into exactly which tools were called and what data flowed through, making sure nothing happens in the dark. ## Tools ### autocomplete Suggests names, keywords, and categories as you type your search query. ### get_business_details Pulls rich data for a single business listing using its ID. ### get_business_engagement Retrieves metrics showing how active or popular a specific business is. ### get_business_insights Gathers monthly performance and trend data for a given business. ### get_business_reviews Fetches up to three recent customer review excerpts for any business. ### get_categories Lists all available Yelp business categories so you can browse by type. ### get_category_details Provides detailed information about a specific business category. ### get_event_details Gets complete information for a single, identified local event. ### get_featured_event Identifies and retrieves the most notable or featured upcoming event in a location. ### get_jobs Determines available job types based on descriptive text, useful for specialized services like plumbing. ### get_review_highlights Extracts the most commonly mentioned positive and negative themes from a business's reviews. ### get_service_offerings Lists all current and eligible services that a business provides or can provide. ### match_business Finds a specific Yelp business by matching exact input data fields. ### search_businesses Performs a general search across all businesses on the Yelp platform. ### search_by_phone Searches for a business using its full phone number, which must include the country code. ### search_events Finds all upcoming local community or commercial events in an area. ### search_transactions Locates businesses that support specific service methods, like food delivery. ## Prompt Examples **Prompt:** ``` Find highly-rated Italian restaurants in Brooklyn that are open now. ``` **Response:** ``` I've searched Yelp for Italian restaurants in Brooklyn. Top options currently open include 'L'Industrie Pizzeria' (Rating: 4.8) and 'Al Di La Trattoria' (Rating: 4.5). Would you like the address or reviews for any of these? ``` **Prompt:** ``` What are the review highlights for the business with ID 'v76-88-99'? ``` **Response:** ``` Fetching highlights for that business... Customers frequently mention 'excellent service', 'authentic flavors', and 'great atmosphere'. There are also specific mentions of their signature pasta dish being a must-try. ``` **Prompt:** ``` Search for upcoming food events in Austin, Texas. ``` **Response:** ``` I found several upcoming events in Austin. Notable ones include the 'Austin Food & Wine Festival' and the 'Taco & Margarita Fest'. Would you like the specific dates and location details for these? ``` ## Capabilities ### Search by location or keyword Find local businesses using general terms, precise locations, or phone numbers. ### Analyze business details and reviews Get deep metadata on any establishment, including operating hours, detailed insights, and up to three recent review excerpts. ### Map out local events Discover featured happenings or search for specific types of community events in an area. ### Identify services and jobs Pinpoint active service offerings (like plumbing) or get lists of job types based on a natural language query. ### Track commerce activity Search for businesses that support food delivery or specific transaction methods. ## Use Cases ### Planning a corporate visit The ops manager needs to know if a potential meeting location is viable. They ask the agent to use `search_by_phone` and then run `get_business_insights`. The result immediately shows contact info, current engagement metrics, and recent performance trends, saving hours of manual directory research. ### Finding unique local experiences A lifestyle blogger wants to build content about a city's culture. They ask the agent to `search_events` for the weekend and then use `get_featured_event`. This provides specific dates, locations, and details needed for an article outline. ### Vetting restaurant choices A user is choosing a new dinner spot. They ask the agent to find Italian restaurants using `search_businesses`, then request `get_business_reviews` and `get_review_highlights`. The agent summarizes common praise points (like 'authentic flavors') versus complaints. ### Identifying service gaps A small business owner needs to see what services their local competition offers. They ask the agent to use `get_service_offerings` on several nearby competitors, quickly compiling a list of market opportunities they aren't currently meeting. ## Benefits - Go beyond basic searching. By using `get_business_details`, you get deep metadata, including operating hours and specific service listings, making decisions faster than checking a website. - Don't just read reviews; understand them. The `get_review_highlights` tool pulls out themes like 'great atmosphere' or 'excellent service,' telling you what customers *actually* care about. - Build comprehensive trip reports by combining searches: use `search_businesses` first, then check specific events with `search_events`, and finally pull the full schedule via `get_event_details`. - Never miss a potential client. The MCP allows you to find businesses that support food delivery or specific job services using `search_transactions` and `get_jobs` in one flow. - Get immediate suggestions as you type. Use `autocomplete` to narrow down your search instantly, ensuring the agent targets the right category or business name the first time. ## How It Works The bottom line is, you treat Yelp’s entire global directory like a single, searchable database through your chat interface. 1. Subscribe to the Yelp Fusion MCP and provide your API Key. 2. Tell your AI agent what you're looking for (e.g., 'Italian restaurants open now in Brooklyn'). 3. The agent uses the tools to pull detailed results, presenting everything from reviews to operating hours back to you. ## Frequently Asked Questions **How do I find businesses that deliver food using Yelp Fusion MCP?** You must use the `search_transactions` tool. This dedicated search type filters results specifically for locations or services that support delivery options, which a general business search might miss. **Can I get recent customer opinions with get_business_reviews?** Yes, the `get_business_reviews` tool pulls up to three of the most recent review excerpts for any given place. This gives you a quick pulse on what customers are saying right now. **What if I don't know the exact name? Can autocomplete help?** Absolutely. Before running a main search, use `autocomplete` to get suggestions for businesses, keywords, and categories. This helps refine your query and ensures you target the right segment. **Is there a way to see if a business is busy or popular?** You can check engagement metrics by calling `get_business_engagement`. This tool provides quantitative data on how active or relevant the listing currently is, helping you prioritize targets. **What if I need to filter by a very specific type of service, like 'dog grooming'? Can the `get_categories` tool help me narrow it down?** Yes. The `get_categories` tool gives you Yelp's full business category tree structure. You can use this list to find highly niche services or cuisines that might not be obvious in a general search. **I only have a phone number for a place, but no name. Can the `search_by_phone` tool still locate it?** Absolutely. You input the full phone number using the country code (it must start with '+'). The `search_by_phone` tool finds the business details directly from that specific contact information. **How can I use `get_jobs` to understand local labor market trends in a certain area?** You simply give the `get_jobs` tool a natural language query, like 'plumbing' or 'nursing'. It returns specific job types based on your request, helping you gauge local employment needs. **After finding an event through search, how do I get all the detailed information about tickets and schedules using `get_event_details`?** You pass the event ID to `get_event_details`. This fetches comprehensive metadata for that specific occurrence, including things like ticket links, cancellation policies, and schedule changes. **Can I find businesses that offer delivery in my area?** Yes. Use the `search_transactions` tool. It specifically filters for businesses that support food delivery transactions in your specified location. **How can I see what people are saying about a specific business?** Use the `get_business_reviews` tool with the business ID or alias. It returns up to 3 review excerpts and ratings to help you gauge the quality of the establishment. **Is it possible to identify a business using just a phone number?** Absolutely. The `search_by_phone` tool allows you to find a Yelp business by providing its phone number (including the '+' and country code).