AceDataCloud/MCPSerp

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
- **Web Search** - Regular Google web search with structured results
- **Image Search** - Search for images with URLs and thumbnails
- **News Search** - Get latest news articles on any topic
- **Video Search** - Find videos from YouTube and other sources
- **Places Search** - Search for local businesses and places
- **Maps Search** - Find locations and geographic information
- **Knowledge Graph** - Get structured entity information
- **Localization** - Support for multiple countries and languages
- **Time Filtering** - Filter results by time range
Tool Reference
| Tool | Description |
|------|-------------|
| serp_google_search | Search Google and get structured results using the SERP API. |
| serp_google_images | Search Google Images and get image results. |
| serp_google_news | Search Google News and get news article results. |
| serp_google_videos | Search Google Videos and get video results. |
| serp_google_places | Search Google for local places and businesses. |
| serp_google_maps | Search Google Maps for locations. |
| serp_list_search_types | List all available Google search types. |
| serp_list_countries | List commonly used country codes for Google search. |
| serp_list_languages | List commonly used language codes for Google search. |
| serp_list_time_ranges | List available time range filters for Google search. |
| serp_get_usage_guide | Get a comprehensive guide for using the Google SERP tools. |
Connect: hosted OAuth, API token, or local stdio
The hosted endpoint is https://serp.mcp.acedata.cloud/mcp. Choose one route for the MCP client:
| Route | When to use it | Credential setup |
|---|---|---|
| Hosted OAuth | The client supports remote MCP OAuth | Add only the URL, then sign in to AceDataCloud and approve access. No token needs to be pasted into client configuration. |
| Hosted API token | The client cannot finish OAuth, or you need an explicit integration credential | Send an AceDataCloud API token in the Authorization: Bearer … header. Keep it in a local secret store or environment variable. |
| Local stdio | The client runs a local MCP process | Install mcp-serp and pass ACEDATACLOUD_API_TOKEN to that process. It still calls the AceDataCloud API. |
The hosted service advertises OAuth metadata and Dynamic Client Registration (DCR). **DCR registers the client application; it is not an API key.** OAuth signs you in and the client sends the resulting Bearer token; it may reuse or create an API credential for the account. Browser sign-in still requires an AceDataCloud account. The hosted service can be metered: review current service documentation and displayed pricing before a real operation. Do not configure both an OAuth login and a fixed Authorization header for the same server.
Hosted OAuth examples
- **Claude and Claude Desktop chat:** Add a remote custom connector in Customize → Connectors → Add custom connector, enter https://serp.mcp.acedata.cloud/mcp, select sign-in, and choose **Register automatically** if Claude asks how to register its OAuth client. Complete consent. Claude Desktop's local claude_desktop_config.json is a separate setup. Claude connector guide.
- **Claude Code:** claude mcp add --transport http --scope user serp https://serp.mcp.acedata.cloud/mcp, then claude mcp login serp. Check /mcp. Claude Code MCP guide.
- **Cursor:** Add a remote server with only https://serp.mcp.acedata.cloud/mcp. For a project, merge the entry below into /.cursor/mcp.json; for personal use, use ~/.cursor/mcp.json. Cursor MCP guide.
- **VS Code / Copilot:** Run **MCP: Add Server**, select HTTP, enter https://serp.mcp.acedata.cloud/mcp, then finish the browser sign-in. New portable workspace configs use /.mcp.json; the VS Code-specific format below uses /.vscode/mcp.json or the user profile. Check **MCP: List Servers**. VS Code MCP setup.