# Serp Preview — REST API endpoint `serp-preview`

Return how a page title and meta description will display in Google search results on desktop or mobile: the truncated display text, character and pixel counts against Google's limits, an ok/warn/danger status per field, the breadcrumb URL, and the HTML <title>/<meta> snippet.

- Category: seo
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/serp-preview/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/serp-preview/
- Same tool on the other surface: https://findutils.com/mcp/serp-preview/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/serp-preview/execute \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Best Coffee Grinders 2026",
    "description": "Our tested picks for every budget.",
    "url": "https://example.com/guides/coffee-grinders"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/serp-preview
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `title` | string | yes | Page title (the <title> text). |
| `description` | string | no | Meta description text. Default: `""`. |
| `url` | string | no | Page URL, used for the breadcrumb and canonical link. Default: `""`. |
| `view` | string (desktop \| mobile) | no | Which Google layout to simulate. Default: `"desktop"`. |

Example arguments (verified):

```json
{
  "title": "Best Coffee Grinders 2026",
  "description": "Our tested picks for every budget.",
  "url": "https://example.com/guides/coffee-grinders"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:serp_preview`. Full MCP reference: https://findutils.com/mcp/serp-preview/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt