URL Intelligence for AI Agents

Connect the OpenGraph.io MCP server to Cursor, Claude, VS Code, and other AI tools so your agents can preview URLs, extract Markdown, capture screenshots, audit sites, check link previews, and generate images.

No credit card required.

OpenGraph.io MCP

AI AssistantClaude, Cursor, VS Code...

opengraph-io-mcphosted or local

REST API

OpenGraph.io APIapi.opengraph.io

16 Tools Across 3 Pillars

Web Data

Site Audit

Link Preview

Image Generation

mcp.opengraph.io/mcp

Why MCP

Give Your AI Tools the Ability to Work With URLs

OpenGraph.io MCP connects AI agents to the URL Intelligence tools behind OpenGraph.io. Instead of asking an agent to guess what's on a page, let it fetch preview metadata, extract clean Markdown, capture screenshots, audit an entire site, check link previews, and generate images — directly from your AI workflow.

Web Data, On Demand

Agents fetch Open Graph metadata, convert pages to Markdown, scrape rendered HTML, extract specific elements, capture screenshots, and query pages in natural language.

6 tools

Site Audits & Link Previews

Agents can discover a site's URLs, run a full SEO and social-sharing audit, or check how a single URL previews on Facebook, X, LinkedIn, and Google.

6 tools

AI Image Generation

Agents can generate illustrations, diagrams, icons, and social cards from prompts, iterate on them, and export the results to your project.

4 tools

Sign In, No Key Pasting

Supported clients connect through a secure browser sign-in. Prefer a key? Use an x-app-id header or run the server locally instead.

OAuth

Capabilities

URL Intelligence Tools Your Agent Can Call

16 tools across three pillars — your AI assistant discovers and calls them automatically through the Model Context Protocol.

Web Data Tools

Get OG Data

getOgData

Fetch Open Graph metadata, Twitter Cards, and hybrid social preview data from any URL.

/api/3.0/site

Scrape

getOgScrapeData

Fetch raw HTML with JS rendering, proxy rotation, and automatic retries.

/api/3.0/scrape

Screenshot

getOgScreenshot

Capture a full-page or viewport screenshot with dark mode, capture delay, and custom sizing.

/api/3.0/screenshot

Extract

getOgExtract

Pull specific HTML elements (headings, paragraphs, links, images) in structured format.

/api/1.1/extract

Markdown

getOgMarkdown

Convert any URL's HTML into clean, readable Markdown with boilerplate stripped.

/api/3.0/markdown

Query

getOgQuery

Ask a natural-language question about a page's content and get a structured answer.

/api/1.1/query

Site Audit & Link Preview Tools

Discover Site URLs

discoverSiteUrls

Crawl a domain and return every page found, grouped by depth, so you can choose what to audit.

Site Audit

Start Site Audit

startSiteAudit

Kick off an asynchronous audit for a list of URLs — the whole site, a section, or specific pages.

Site Audit

Audit Status

getSiteAuditStatus

Poll a running audit's progress until it completes.

Site Audit

Audit Report

getSiteAuditReport

Retrieve the full audit results: overall score, per-page findings, and prioritized fixes.

Site Audit

Preview Page Audit

previewPageAudit

Get an instant, synchronous score and issue list for a single URL — no audit queue needed.

Site Audit

Link Preview

getLinkPreview

See how a single URL will appear when shared on Facebook, X, LinkedIn, and Google, with a quality score and fixes.

Link Preview

Image Generation Tools

Generate Image

generateImage

Create illustrations, diagrams, icons, and social cards from a text prompt.

AI Image Generator

Iterate Image

iterateImage

Refine and modify previously generated images with follow-up prompts.

AI Image Generation

Export Image

exportImageAsset

Save a generated image directly to your local project filesystem.

Local Filesystem

Inspect Image Session

inspectImageSession

Review generation history and find asset IDs to use with iteration.

AI Image Generation

How It Works

Connect OpenGraph.io MCP in Minutes

Point your client at the hosted server and sign in, or run it locally — either way, your AI assistant discovers the available tools automatically.

1Choose your AI client: Cursor, Claude Desktop, Claude Code, VS Code, Windsurf, JetBrains, Zed, or Cline.
2Connect: point the client at https://mcp.opengraph.io/mcp and sign in with your account, or run npx opengraph-io-mcp locally with your App ID.
3Ask naturally, get results: “Preview this URL,” “audit my site,” or “screenshot this page” — the agent calls the right tool.

MCP Request Flow

AI requests: “Audit my site”

MCP server calls the OpenGraph.io API

Structured results returned to the AI

Security

Your Credentials Never Reach the AI Model

Whether you sign in or use an App ID, neither is ever sent to the AI model — only the tool results are.

Sign In or App ID

Supported clients authenticate through a secure browser sign-in. Prefer a key? Pass your App ID as an x-app-id header instead.

Or Run It Locally

Run the server as a local subprocess over stdio if you'd rather not connect over the network. Your App ID stays in a local config file.

No Persistent State

The server doesn't store request data or maintain session state beyond what's needed to complete a call.

Same Billing You Already Use

Web Data tools bill against your App ID like the REST API. Site Audit and Link Preview use your existing marketing tool plan.

Setup

Set Up in Under a Minute

Point your client at the hosted server and sign in. Prefer local? Run it with npx instead.

mcp.json

{
  "mcpServers": {
    "opengraph": {
      "url": "https://mcp.opengraph.io/mcp"
    }
  }
}

If your client supports it, connecting triggers a browser sign-in automatically. No sign-in support? Add an x-app-id header instead. See Signing In for both options, or the Install Hub for copy-paste configs per client.

Use Cases

What Teams Use OpenGraph.io MCP For

Whether you're auditing SEO, prepping a launch, or building AI-assisted tools — OpenGraph.io MCP fits into your existing AI workflow.

SEO & site audits: Ask an agent to discover a site's URLs, run a full audit, and summarize the highest-priority fixes.
Pre-launch QA: Check how a new page previews on Facebook, X, LinkedIn, and Google before you ship it.
Research & RAG: Convert docs and articles to clean Markdown for summaries and knowledge bases.
Competitive analysis: Screenshot and scrape competitor pages directly from your IDE without switching context.
Visual assets: Generate diagrams, icons, and social cards from a prompt without leaving your AI client.

Browse example prompts for these use cases →

Full-Site SEO Audit

Discover URLs, run the audit, and get a prioritized fix list — all from one prompt.

Link Preview QA

Check social previews before launch, across every major platform, in one call.

On-the-Fly Visuals

Generate a diagram or social card mid-conversation, then export it straight to your project.

Supported Clients

Use OpenGraph.io MCP With the AI Tools You Already Use

The same opengraph-io-mcp server powers every client below — hosted sign-in or local npx.

Zed

Use MCP Across the URL Intelligence Platform

Every tool above is backed by a product you can also use directly.

MCP Tools Reference MCP Prompts Link Preview API HTML to Markdown API Web Scraping API Content Extraction API Screenshot API Site Audit AI Image Generator MCP Server Comparison

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

OpenGraph.io MCP is the Model Context Protocol server that lets AI agents use OpenGraph.io's URL Intelligence tools — metadata extraction, Markdown conversion, screenshots, site audits, link preview checks, and AI image generation — directly inside MCP-compatible clients.

Agents can fetch Open Graph and Twitter Card metadata, scrape rendered HTML, convert any URL to clean Markdown, extract specific page elements, capture screenshots, ask natural-language questions about a page, audit an entire site for SEO and social-sharing issues, check how a single URL previews on Facebook/X/LinkedIn/Google, and generate or iterate on AI images — 16 tools in total.

OpenGraph.io MCP works with any MCP-compatible client, including Cursor, Claude Desktop, Claude Code, VS Code (Copilot Chat), Windsurf, JetBrains AI Assistant, Zed, and Cline.

No key required to get started — supported clients can sign in with your OpenGraph.io account through a secure browser flow. If your client doesn't support sign-in, you can pass your App ID as an x-app-id header, or run the server locally with npx using your App ID as an environment variable.

Yes. Point Cursor at the hosted MCP URL and sign in, or use the npx config with your App ID. See the Cursor setup guide for both options.

Yes. Claude Desktop and Claude Code both support OpenGraph.io MCP through the hosted sign-in flow or a local npx config. See the Claude setup guide.

No. Developers and AI builders are the first to adopt it, but marketers, agencies, and no-code users can use OpenGraph.io MCP through simple prompts once their AI client is connected.

The REST API is for direct application integration. MCP lets AI agents call the same OpenGraph.io capabilities as tools from inside AI clients and agent workflows, without you writing any request or parsing code.

Sign in with your OpenGraph.io account from a supported client, or copy a client-specific config from the install guide, then ask your agent to preview, extract, screenshot, or audit a URL.

Still have Questions? 🤔

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