Site Audit & Link Preview Tools
Audit an entire site's SEO and social metadata, or instantly check how a single URL will preview on Facebook, X, LinkedIn, and Google — directly from your AI assistant.
These tools require signing in with your account. They aren't available with an API key alone. See Signing In.
Overview
The OpenGraph MCP Server includes six tools covering two related products: Site Audit and Link Preview.
- discoverSiteUrls – Crawl a domain and list every page found
- startSiteAudit – Kick off a full, multi-page SEO/social audit
- getSiteAuditStatus – Poll an in-progress audit
- getSiteAuditReport – Retrieve the completed report
- previewPageAudit – Instant quality check of a single URL
- getLinkPreview – Instant check of how a single URL previews on social platforms
Auditing a whole site
A full site audit runs in four steps. Your AI assistant handles all of them — just tell it what you want audited:
- Discover –
discoverSiteUrlscrawls the domain and its sitemap, returning every page found along with your remaining monthly audit quota. The assistant will ask whether you want the whole site, just the core pages, a specific section, or a hand-picked list. - Start –
startSiteAuditkicks off the audit for the pages you chose (or crawls the domain itself if you skip discovery) and returns an audit ID right away. - Poll –
getSiteAuditStatusis checked every few seconds until the audit finishes. - Report –
getSiteAuditReportreturns the full results: an overall score, an AI-generated summary with top priorities, and per-page scores and issues.
Audit my site https://example.comIf you already know exactly which pages you want audited, you can skip discovery entirely and hand your assistant the URLs directly — it will pass all of them through, even for large lists.
Auditing or previewing a single page
For a quick check on one URL, there's no need to run a full audit:
- previewPageAudit – returns a quality score (0–100), a score label (Well Optimized / Good / Room for Improvement / Needs Attention / Poor), a breakdown of the checks performed, any issues found, and mock social previews.
- getLinkPreview – returns the same score, plus platform-specific preview cards showing exactly what Facebook, X/Twitter, LinkedIn, and Google will display when the URL is shared, along with a list of fixes.
Both are synchronous and return instantly — neither counts against your audit quota.
Check the link preview for https://example.com/pricing — how will it look on Facebook and X?Tool Reference
| Tool | Input | Returns |
|---|---|---|
| discoverSiteUrls | domain | All discovered URLs grouped by depth, plus remaining monthly quota |
| startSiteAudit | domain, optional urls[], pagesRequested | An audit ID, initial status, and page count |
| getSiteAuditStatus | auditId | Current status (queued, crawling, scoring, complete) and progress counts |
| getSiteAuditReport | auditId | Overall score, AI summary, and per-page scores, issues, and previews |
| previewPageAudit | url | Score, checks, issues, and mock social previews for that page |
| getLinkPreview | url | Score plus Facebook, X/Twitter, LinkedIn, and Google preview cards and fix list |