OpenGraph.io
Log inStart Free

Every OpenGraph.io MCP Tool, Explained

16 tools across four capabilities — Preview, Extract & Convert, Capture & Visualize, and Audit — that any MCP-compatible AI agent can call automatically.

No credit card required.

16 Tools · 3 Pillars
Your AI Agentasks in natural language
picks a tool
opengraph-io-mcp16 tools available
REST API
Structured Resultreturned to the agent
Four Capabilities
Preview
Extract & Convert
Capture & Visualize
Audit
mcp.opengraph.io/mcp
Capabilities

What Each Tool Group Does

Every tool is grouped by outcome, not just function name — so you know when to reach for it and what to expect back.

Preview
getOgDatagetLinkPreview

Fetch a URL's title, description, image, favicon, and Open Graph / Twitter Card data, or check exactly how it will look when shared on Facebook, X, LinkedIn, and Google.

Use whenBefore sharing a link, debugging your own site's social tags, or researching how a competitor's page presents.
OutputStructured title, description, image, and favicon fields, plus a quality score and list of missing tags for link preview checks.

“Preview https://example.com and tell me if the Open Graph tags are complete.”

See the Link Preview API →
Extract & Convert
getOgScrapeDatagetOgMarkdowngetOgExtractgetOgQuery

Fetch a page's raw rendered HTML, convert it to clean Markdown, pull specific elements like headings and links, or ask a natural-language question about the page.

Use whenPulling documentation into your project, summarizing an article, or extracting structured data without writing a custom scraper.
OutputRaw HTML, a clean Markdown document, an array of matched elements, or a direct structured answer to your question.

“Convert this changelog page to Markdown and summarize what changed for API consumers.”

See the HTML to Markdown API →
Capture & Visualize
getOgScreenshotgenerateImageiterateImageexportImageAssetinspectImageSession

Capture a full-page or viewport screenshot of any URL, or generate, refine, and export an AI image — an illustration, diagram, icon, or social card — from a text prompt.

Use whenVisual QA, competitive research, documentation, or creating a diagram or social card mid-conversation.
OutputA screenshot image file, or a generated or iterated image exported directly to your project.

“Screenshot this page, then generate a simple architecture diagram of its layout.”

See the Screenshot API →
Audit
discoverSiteUrlsstartSiteAuditgetSiteAuditStatusgetSiteAuditReportpreviewPageAudit

Crawl a site to discover its URLs, run a full SEO and social-sharing audit across them, or get an instant quality score and fix list for a single page.

Use whenBefore a launch, during a periodic SEO review, or when you want a fast sanity check on one URL without queuing a full audit.
OutputA discovered URL list, an audit score with a prioritized fix list, or an instant single-page score and issue list.

“Audit my site at example.com and tell me the top three things to fix before launch.”

See the Site Audit →
By Workflow

Tools by Workflow

Most real requests chain more than one tool together. Here's how the pillars above map to common agent workflows.

  • Understand a webpage: Preview a URL to get its title, description, and metadata before deciding whether to dig further.
  • Summarize a URL: Convert the page to Markdown, then have the agent summarize the content in its own words.
  • Check social metadata: Run a link preview check to see exactly how the page will render on Facebook, X, and LinkedIn.
  • Capture visual context: Screenshot the page for a visual reference, or generate a diagram to explain what it shows.
  • Review a launch page: Run an instant page audit for a quick score, or a full site audit before a bigger release.
  • Compare URLs: Preview or audit several URLs in sequence and have the agent build a comparison table.

Research & Summarize

Preview a URL, then convert it to Markdown for a full summary — two tools, one conversation.

Visual QA

Screenshot a page and check its link preview together to confirm it looks right everywhere before you ship.

Pre-Launch Review

Run an instant page audit for a fast check, or a full site audit when you need the complete picture.

Output Examples

What Comes Back

Trimmed, human-readable samples of what each tool group hands back to your agent.

Preview
title: “Example Domain”
description: “For illustrative examples”
image: og-image.png
favicon: favicon.ico
Extract & Convert
# Getting Started
Install the SDK, then call...
## Authentication
Pass your API key as a header...
Audit
score: 78 / 100
top fix: Missing og:image on 3 pages
next fix: Title tag too long on /pricing
Try It

Try a Tool Right Now

Once your client is connected, paste this into your agent to see a tool in action.

Try this in your MCP client
Use OpenGraph.io to preview this URL and summarize the title, description, image, and metadata.
Related Setup Guides

Connect a Client

Set Up in Cursor

One-click install for Cursor IDE.

Set Up in Claude

Config steps for Claude Desktop and Claude Code.

Example Prompts

Copy-paste prompts for every capability on this page.

MCP Quickstart Docs

Full setup documentation for every supported client.

Our Clients

Trusted by Thousands

Over 1B URLs processed

Powering previews, metadata, screenshots, extraction, embeds, and audits.

Try it for free today

Get started with 100 free API requests per month. No credit card required. Experience the power of our API with zero commitment.

FAQ

16 tools across three pillars: Web Data (getOgData, getOgScrapeData, getOgScreenshot, getOgExtract, getOgMarkdown, getOgQuery), Site Audit & Link Preview (discoverSiteUrls, startSiteAudit, getSiteAuditStatus, getSiteAuditReport, previewPageAudit, getLinkPreview), and Image Generation (generateImage, iterateImage, exportImageAsset, inspectImageSession).
All 16 tools are live today. There's no waitlist, beta flag, or partial rollout — every tool listed on this page is callable as soon as your MCP client is connected.
Use getOgData for raw metadata (title, description, image, favicon) or getLinkPreview for a platform-by-platform preview with a quality score across Facebook, X, LinkedIn, and Google.
Use getOgMarkdown for clean, readable Markdown (best for docs and articles), getOgScrapeData for raw rendered HTML, or getOgExtract to pull specific elements like headings, paragraphs, or links.
No. Once your MCP client is connected, the AI agent selects the right tool automatically based on your natural-language request — you don't need to know the tool names or call them directly.
Yes, the same credit costs as the REST API apply: metadata lookups cost 1 credit, screenshots cost 20 credits (1 if cached), and AI queries cost 100–200 credits. Site Audit and Link Preview use your existing marketing tool plan. See the pricing page for full details.

Still have Questions? 🤔

Can't find the answer you're looking for? Please chat to our friendly team. We usually respond within 24 hours.