autocomplete
Autocomplete
Get real-time autocomplete suggestions as users type. Returns suggestions for search terms, businesses, and categories. Providing location coordinates improves suggestion relevance.
Ask your agent in plain language. Each of these maps to a real tool on the server.
autocomplete
Get real-time autocomplete suggestions as users type. Returns suggestions for search terms, businesses, and categories. Providing location coordinates improves suggestion relevance.
get_reviews
Retrieve review excerpts for a specific Yelp business. Returns review excerpts (approximately 160 characters each) along with the reviewer's name, rating, and profile URL. Yelp documents up to three excerpts for this endpoint; access requires an Enhanced or Premium plan.
search_businesses
Search for businesses on Yelp by keyword, category, location, price level, and more. Supports searching by text query with location (address or coordinates), filtering by price, open status, and business attributes. Results are sorted by best match by default but can be sorted by rating, review count, or distance.
search_transactions
Search for businesses that support specific transaction types, such as food delivery or pickup. Currently supports "delivery" for food delivery businesses in the US.
get_business_details
Retrieve detailed information about a specific Yelp business. Returns comprehensive data including name, address, phone, photos, rating, price level, hours of operation, special hours, messaging info, and business attributes. You can look up a business by its Yelp business ID or its URL alias.
ai_chat
Have a conversational interaction with Yelp's AI for local business discovery. Send natural language queries like "Best sushi near downtown" and receive natural language responses along with structured business data. Supports multi-turn conversations by passing back the chatId from a previous response.
match_business
Find the Yelp business ID for a known business by matching on name, address, and other attributes. Use this when you have a business's real-world information and need to find its corresponding Yelp entry.
search_by_phone
Find Yelp businesses by phone number. Useful for looking up a specific business when you have its phone number. Multiple businesses may share the same phone number (e.g., chain stores or businesses in the same building).
list_categories
Discover Yelp business category aliases and names for search filters. Optionally restrict and localize categories by locale.
get_category
Retrieve a Yelp business category and its parent and country restrictions. Call list_categories to discover category aliases.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Search for local businesses by keyword, category, location, phone number, price level, and transaction type. Retrieve detailed business information including name, address, phone, photos, ratings, hours, and price levels. Access review excerpts and review highlights for businesses. Provide real-time autocomplete suggestions for business, term, and category searches. Match businesses by name and address to obtain Yelp Business IDs. Use conversational AI chat for natural language local business discovery. Manage business listings, respond to reviews, handle leads, book reservations, and manage advertising programs via partner APIs. Retrieve engagement metrics, advertising performance data, and location analytics.
Common questions about connecting Yelp to AI agents with Metorial.