Schema | MCP Serp

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`LOG_LEVEL`	No	Logging level	INFO
`SERP_REQUEST_TIMEOUT`	No	Request timeout in seconds	30
`ACEDATACLOUD_API_TOKEN`	Yes	API token from AceDataCloud
`ACEDATACLOUD_API_BASE_URL`	No	API base URL	https://api.acedata.cloud

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name	Description
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.`
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.

Prompts

Interactive templates invoked by user choice

Name	Description
`serp_search_guide`	Guide for choosing the right SERP tool for search tasks.
`serp_workflow_examples`	Common workflow examples for SERP search tasks.
`serp_query_tips`	Tips for writing effective search queries.

Resources

Contextual data attached and managed by the client

Name	Description
No resources

MCP Serp

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API