# mcp-serp

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add acedatacloud-mcp/mcp-serp

# Browse available tools
npx -y @smithery/cli@latest tool list acedatacloud-mcp/mcp-serp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-serp serp_list_search_types

# Call a tool
npx -y @smithery/cli@latest tool call acedatacloud-mcp/mcp-serp serp_list_search_types '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-serp--acedatacloud-mcp.run.tools`

**Required config:**
- `x-api-key` (header) — AceDataCloud API Bearer Token (get from https://platform.acedata.cloud)

## Tools (11)

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

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-serp <tool-name>
```

## Prompts (3)

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