# Open Graph Preview — MCP tool `findutils:open_graph_preview`

Extract Open Graph and Twitter Card tags from an HTML document (or take them as fields), and return the parsed values, validation issues (missing or too-long title/description/image/url/card), and regenerated <meta> tags. Does not fetch URLs — pass the page HTML.

- 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/open-graph-preview/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/open-graph-preview/
- Same tool on the other surface: https://findutils.com/api/open-graph-preview/

## Connect

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

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "open_graph_preview",
      "arguments": {
        "html": "<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `html` | string | no | HTML source to parse for og:* and twitter:* meta tags. Optional when tag values are given directly. |
| `og_title` | string | no | og:title value (overrides the parsed value). |
| `og_description` | string | no | og:description value. |
| `og_image` | string | no | og:image URL. |
| `og_url` | string | no | og:url value. |
| `og_type` | string (website \| article \| product \| profile \| video.movie \| video.episode \| music.song \| book) | no | og:type value. Default "website". |
| `og_site_name` | string | no | og:site_name value. |
| `twitter_card` | string (summary \| summary_large_image \| app \| player) | no | twitter:card value. Default "summary_large_image". |
| `twitter_title` | string | no | twitter:title value. |
| `twitter_description` | string | no | twitter:description value. |
| `twitter_image` | string | no | twitter:image URL. |

Example arguments (verified):

```json
{
  "html": "<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/open-graph-preview/execute \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"
  }'

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

Full REST reference: https://findutils.com/api/open-graph-preview/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt