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