acedatacloud avatar

Mcp Serp

acedatacloud/serpmcp

Brings Google search into your MCP workflow via AceDataCloud's SERP API. Exposes tools for web search, images, news, videos, local places, and maps, plus knowledge graph lookups. You can filter by country, language, and time range. Ships with a hosted endpoint at serp.mcp.acedata.cloud that works over streamable HTTP, so you can connect from Claude Desktop, VS Code, Cursor, or JetBrains without running anything locally. Requires an AceDataCloud API token. If you need your AI to pull fresh search results or find current information beyond its training data, this handles the integration. Also available as a local Python package if you want to self host.

GitHub stars
1
tools
11
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Nov 1, 2026

Tools

11 tools

Public tool metadata for what this MCP can expose to an agent.

serp_list_search_typesList 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.

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.

No parameter schema in public metadata yet.

serp_list_countriesList 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.

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.

No parameter schema in public metadata yet.

serp_list_languagesList 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.

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.

No parameter schema in public metadata yet.

serp_list_time_rangesList 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.

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.

No parameter schema in public metadata yet.

serp_get_usage_guideGet 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.

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.

No parameter schema in public metadata yet.

serp_google_searchSearch 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:...7 params

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:...

Parameters* required
countryvalue
Country code for localized results (e.g., 'us', 'cn', 'uk'). Default is 'us'.
languagevalue
Language code for results (e.g., 'en', 'zh-cn', 'fr'). Default is 'en'.
numbervalue
Number of results per page (default: 10). Note: More than 10 results may incur additional credits.
pagevalue
Page number for pagination (default: 1).
querystring
The search query string. Required.
search_typestring
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'...one of search · images · news · maps · places · videosdefault: search
time_rangevalue
Time filter for results. Options: 'qdr:h' (past hour), 'qdr:d' (past day), 'qdr:w' (past week), 'qdr:m' (past month), or None for no time restriction (default).
serp_google_imagesSearch Google Images and get image results. Performs a Google Image search and returns structured image results.5 params

Search Google Images and get image results. Performs a Google Image search and returns structured image results.

Parameters* required
countryvalue
Country code for localized results (e.g., 'us', 'cn', 'uk'). Default is 'us'.
languagevalue
Language code for results (e.g., 'en', 'zh-cn', 'fr'). Default is 'en'.
numbervalue
Number of results per page (default: 10). Note: More than 10 results may incur additional credits.
pagevalue
Page number for pagination (default: 1).
querystring
The search query string for image search. Required.
serp_google_newsSearch Google News and get news article results. Performs a Google News search and returns structured news results.6 params

Search Google News and get news article results. Performs a Google News search and returns structured news results.

Parameters* required
countryvalue
Country code for localized results (e.g., 'us', 'cn', 'uk'). Default is 'us'.
languagevalue
Language code for results (e.g., 'en', 'zh-cn', 'fr'). Default is 'en'.
numbervalue
Number of results per page (default: 10). Note: More than 10 results may incur additional credits.
pagevalue
Page number for pagination (default: 1).
querystring
The search query string for news search. Required.
time_rangevalue
Time filter for results. Options: 'qdr:h' (past hour), 'qdr:d' (past day), 'qdr:w' (past week), 'qdr:m' (past month), or None for no time restriction (default).
serp_google_videosSearch Google Videos and get video results. Performs a Google Video search and returns structured video results.5 params

Search Google Videos and get video results. Performs a Google Video search and returns structured video results.

Parameters* required
countryvalue
Country code for localized results (e.g., 'us', 'cn', 'uk'). Default is 'us'.
languagevalue
Language code for results (e.g., 'en', 'zh-cn', 'fr'). Default is 'en'.
numbervalue
Number of results per page (default: 10). Note: More than 10 results may incur additional credits.
pagevalue
Page number for pagination (default: 1).
querystring
The search query string for video search. Required.
serp_google_placesSearch Google for local places and businesses. Performs a Google Places search and returns structured place results.5 params

Search Google for local places and businesses. Performs a Google Places search and returns structured place results.

Parameters* required
countryvalue
Country code for localized results (e.g., 'us', 'cn', 'uk'). Default is 'us'.
languagevalue
Language code for results (e.g., 'en', 'zh-cn', 'fr'). Default is 'en'.
numbervalue
Number of results per page (default: 10). Note: More than 10 results may incur additional credits.
pagevalue
Page number for pagination (default: 1).
querystring
The search query string for local places/businesses search. Required.
serp_google_mapsSearch Google Maps for locations. Performs a Google Maps search and returns structured map results.5 params

Search Google Maps for locations. Performs a Google Maps search and returns structured map results.

Parameters* required
countryvalue
Country code for localized results (e.g., 'us', 'cn', 'uk'). Default is 'us'.
languagevalue
Language code for results (e.g., 'en', 'zh-cn', 'fr'). Default is 'en'.
numbervalue
Number of results per page (default: 10). Note: More than 10 results may incur additional credits.
pagevalue
Page number for pagination (default: 1).
querystring
The search query string for maps/location search. Required.

Sponsors

Configuration

ACEDATACLOUD_API_TOKEN*secret

API token from Ace Data Cloud (https://platform.acedata.cloud)

Readme

SerpMCP

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

A Model Context Protocol (MCP) server for Google search using SERP API through the AceDataCloud API.

Perform Google searches and get structured results directly from Claude, VS Code, or any MCP-compatible client.

Features


View the full README on GitHub

Details

Repository
github.com/acedatacloud/serpmcp
Website
platform.acedata.cloud/documents/serp-mcp?utm_source=mcp_registry&utm_medium=referral&utm_campaign=evergreen&utm_content=serp_mcp_listing_guide
Category
Search & Web Crawling
Package
mcp-serp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from acedatacloud

Related Search & Web Crawling MCP servers

View all
1x402-index avatarX402search Mcpx402-index/x402search-mcpSearch 13,000+ x402-enabled APIs from your AI agent. Powered by x402search.xyz1stars
2pipeworx-io avatarExapipeworx-io/mcp-exaExa MCP — neural/semantic web search + content retrieval (exa.ai)0stars
3pipeworx-io avatarJina Readerpipeworx-io/mcp-jina-readerJina AI Reader/Search MCP — turn any URL into clean LLM-ready markdown, plus web search.0stars
4mifactory-bot avatarMifactory Scraping Apimifactory-bot/mifactory-scraping-apiWeb scraping for AI agents. Extract text and metadata from any URL worldwide. $0.005/page.0stars
5coleam00 avatarCrawl4AI RAGcoleam00/mcp-crawl4ai-ragProvides web crawling, RAG, and knowledge-graph capabilities for AI agents with a Supabase-backed vector store.2.2Kstars
6mrkrsl avatarWeb Searchmrkrsl/web-search-mcpProvides multi-engine web search with full-page extraction for local LLM workflows and quick summaries.862stars