# Serpdog — how to use (mcp.ai)

Connect your Serpdog account and use 1 tools for web scraping straight from your AI agent. Connect with your own API key. Serpdog provides APIs for scraping Google search results and related services, enabling developers to access real-time data from Google Search, Maps, Scholar, and more. Note: Serpdog has merged with Scrapingdog but continues to operate independently at api.serpdog.io.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_serpdog?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `serpdog_screenshot_api`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/serpdog`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/serpdog/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/serpdog/screenshot/api` — Tool to capture a screenshot of a webpage. Use when you need a visual snapshot of a page; supports full-page, device emulation, delays, and dark mode.
  - body: { url: string, delay?: integer, device?: string, output?: string, dark_mode?: boolean, full_page?: boolean, window_width?: integer, window_height?: integer, no_cookie_banners?: boolean }

## Example prompts
- "What can I do in Serpdog?"
- "Show me a summary of my Serpdog account"

## More
- Page: https://mcp.ai/serpdog
- Agent spec (llms.txt): https://mcp.ai/serpdog/llms.txt
- Postman collection: https://mcp.ai/serpdog/postman.json