io.github.AceDataCloud/mcp-serp
MCP server for Google search results via SERP API
Versions
2026.3.19.7latestTools 11
serp_google_search Search Google and get structured results using the SERP API. Performs a Google search and returns the complete JSON response from the API, preserving all available fields and data. Args: query: The search query string. Required. search_type: Type of search to perform. Options: - "search": Regular web search (default) - "images": Image search - "news": News articles - "maps": Map results - "places": Local business/place results - "videos": Video results country: Country code for localized results (e.g., "us", "cn", "uk"). Default is "us". language: Language code for results (e.g., "en", "zh-cn", "fr"). Default is "en". time_range: Time filter for results. Options: - "qdr:h": Past hour - "qdr:d": Past day - "qdr:w": Past week - "qdr:m": Past month - None: No time restriction (default) number: Number of results per page (default: 10). Note: More than 10 results may incur additional credits. page: Page number for pagination (default: 1). Returns: Complete JSON response from the SERP API containing all available data. Example: serp_google_search(query="artificial intelligence", search_type="news")
serp_google_images Search Google Images and get image results. Performs a Google Image search and returns structured image results.
serp_google_news Search Google News and get news article results. Performs a Google News search and returns structured news results.
serp_google_videos Search Google Videos and get video results. Performs a Google Video search and returns structured video results.
serp_google_places Search Google for local places and businesses. Performs a Google Places search and returns structured place results.
serp_google_maps Search Google Maps for locations. Performs a Google Maps search and returns structured map results.
serp_list_search_types List all available Google search types. Shows all available search types and their use cases. Use this to understand which search type to use for your query. Returns: Table of all search types with descriptions.
serp_list_countries List commonly used country codes for Google search. Shows common country codes that can be used to localize search results. Returns: Table of country codes and their countries.
serp_list_languages List commonly used language codes for Google search. Shows common language codes that can be used to get results in specific languages. Returns: Table of language codes and their languages.
serp_list_time_ranges List available time range filters for Google search. Shows all time range options that can be used to filter results by date. Returns: Table of time range codes and their meanings.
serp_get_usage_guide Get a comprehensive guide for using the Google SERP tools. Provides detailed information on how to use the SERP search tools effectively, including parameters, examples, and best practices. Returns: Complete usage guide for SERP tools.
Permissions 3
network medium filesystem low env_vars low