# Serply — how to use (mcp.ai)

Connect your Serply account and use 3 tools for developer tools straight from your AI agent. Connect with your own API key. Serply is a fast and accurate search API that provides real-time Google search results, SERP data, and web scraping capabilities. Access Google Search, Bing Search, Google Jobs, Google Scholar, Google News, and more via simple API calls.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_serply?ms=1787293440000`
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. `serply_perform_image_search`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/serply`
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/serply/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/serply/perform/image/search` — Performs an image search using the Serply API to find images matching a text query. This tool searches for images on the web and returns results with image URLs, thumbnails, dimensions, titles, and so
  - body: { gl?: string, hl?: string, num?: integer, safe?: string, query: string, start?: integer }
- `POST https://api.mcp.ai/api/serply/perform/maps/search` — Tool to perform a maps search. Use when you need to find geographic locations for a given query.
  - body: { limit?: integer, query: string }
- `POST https://api.mcp.ai/api/serply/perform/scholar/search` — Tool to perform an academic scholar search via Serply. Use when you need scholarly literature search results for a specific query.
  - body: { gl?: string, hl?: string, num?: integer, query: string, newWindow?: boolean }

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

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