MCP server exposing Outscraper tools for Google Maps search, reviews, photos, and Google search capabilities
Server exposes 5 tools with complete input schemas and descriptions. All tools follow verb_noun naming (google_maps_search, google_maps_reviews, etc.). Descriptions are present and moderately detailed (100-250 chars), exceeding the 20-char minimum. However, descriptions lack actionable guidance on WHEN to use each tool vs. alternatives, and parameter descriptions are generic. No output schemas documented. Error handling is minimal, exceptions are caught and logged but provide no recovery guidance to the LLM. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all tools being read-only. Parameters lack enum constraints for categorical fields (e.g., 'sort' accepts free-form strings instead of an enum of 'most_relevant'|'newest'|'highest_rating'|'lowest_rating'). No pagination guidance in descriptions despite tools accepting limit/skip parameters.
Get photos from Google Maps places. Examples: - Get photos of a place: google_maps_photos("Eiffel Tower", photos_limit=10) - Get photos for a specific place ID: google_maps_photos("ChIJIQBpAG2ahYAR_6128GcTUEo") Parameters: query (str): Search query, place_id, google_id or Maps URL. photos_limit (int): Maximum photos to extract per place. Default: 20. limit (int): Maximum places to retrieve per query. Default: 1. tag (str): Filter photos by tag. language (str): Results language code. Default: 'en'. region (str): Region code (e.g., 'US', 'GB'). fields (str): Fields to include in response. async_request (bool): If True, returns request ID for later retrieval. ui (bool): If True, executes as UI task (sets async_request=True). webhook (str): URL for POST notification when task completes.
Get reviews for Google Maps places. Examples: - Get reviews for a place by ID: google_maps_reviews("ChIJIQBpAG2ahYAR_6128GcTUEo", reviews_limit=10) - Get reviews for a place by URL: google_maps_reviews("https://www.google.com/maps/place/Eiffel+Tower") Parameters: query (str): Search query, place_id, google_id or Maps URL. reviews_limit (int): Maximum reviews to extract per place. Default: 10. limit (int): Maximum places to retrieve per query. Default: 1. sort (str): Sort order - 'most_relevant', 'newest', 'highest_rating', 'lowest_rating'. Default: 'most_relevant'. start (int): Start timestamp for reviews (sets sort to 'newest'). cutoff (int): Maximum timestamp for reviews (sets sort to 'newest'). cutoff_rating (int): Min/max rating filter (requires appropriate sort). ignore_empty (bool): Whether to ignore reviews without text. language (str): Results language code. Default: 'en'. region (str): Region code (e.g., 'US', 'GB'). reviews_query (str): Search term to filter reviews. source (str): Source filter (e.g., 'Booking.com', 'Expedia'). last_pagination_id (str): ID of last item for pagination. fields (str): Fields to include in response. async_request (bool): If True, returns request ID for later retrieval. ui (bool): If True, executes as UI task (sets async_request=True). webhook (str): URL for POST notification when task completes.
No output schemas documented. LLMs cannot predict response structure, forcing them to guess at field names for downstream tool calls or data extraction.
Categorical parameters lack enum constraints. 'sort' in google_maps_reviews accepts free-form strings instead of enum ['most_relevant', 'newest', 'highest_rating', 'lowest_rating']. LLMs will hallucinate invalid values.
Error handling provides no recovery guidance. Exceptions are logged but not returned with actionable messages. LLMs receive raw errors with no hint on what to try next.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | <=2025-11-25 | v2 |
Search businesses or places on Google Maps. Examples: - Find coffee shops: google_maps_search("coffee shops in san francisco", limit=5) - Get details for specific place: google_maps_search("ChIJIQBpAG2ahYAR_6128GcTUEo") Parameters: query (str): Search query, place name, or google_id. limit (int): Maximum places to retrieve per query. Default: 20. drop_duplicates (bool): Whether to remove duplicate results across queries. language (str): Results language code. Default: 'en'. region (str): Region code (e.g., 'US', 'GB'). skip (int): Skip first N places (must be multiple of 20). Used for pagination. coordinates (str): Location coordinates as "latitude,longitude". enrichment (list): Data enrichments to apply to results. fields (str): Fields to include in response. async_request (bool): If True, returns request ID for later retrieval. ui (bool): If True, executes as UI task (sets async_request=True). webhook (str): URL for POST notification when task completes.
Search Google. Examples: - Simple search: google_search("what is the weather in london") - Search with multiple pages: google_search("python tutorials", pages_per_query=2) Parameters: query (str): Search query for Google. pages_per_query (int): Number of pages to return. Default: 1. uule (str): Google UULE location parameter. language (str): Results language code. Default: 'en'. region (str): Region/country code (e.g., 'US', 'GB', 'CA'). fields (str): Fields to include in response. async_request (bool): If True, returns request ID for later retrieval. ui (bool): If True, executes as UI task (sets async_request=True). webhook (str): URL for POST notification when task completes. Returns: list: Google search results with organic listings, ads, and related data.
Search Google News. Examples: - Search for news: google_search_news("latest technology news") - Search news in a specific region: google_search_news("stock market today", region="US") Parameters: query (str): Search query for Google News. pages_per_query (int): Number of pages to return. Default: 1. uule (str): Google UULE location parameter. tbs (str): Date range filter (h: hour, d: day, w: week, m: month, y: year). language (str): Results language code. Default: 'en'. region (str): Region/country code (e.g., 'US', 'GB', 'CA'). fields (str): Fields to include in response. async_request (bool): If True, returns request ID for later retrieval. ui (bool): If True, executes as UI task (sets async_request=True). webhook (str): URL for POST notification when task completes. Returns: list: Google News search results with articles and metadata.
No tool annotations despite all tools being read-only. Missing readOnlyHint annotation prevents agents from understanding which tools are safe to call without side effects.
Descriptions lack WHEN-to-use guidance. No explanation of when to call google_maps_search vs google_search, or how google_maps_reviews differs from google_search_news. LLMs must guess at tool selection.