LABSCO SUMMARY

The page-reading toolkit, and then some.

Scrape, screenshot and markdown in one server already covers most of what an agent needs from the open web, and the markdown tool stripping nav and ads by default is the detail that makes output usable rather than noisy. The site-audit and image sides are genuinely separate products bolted on well — just note the audit half needs OAuth and its own plan, so check that before you plan a workflow around it.

What it is

The OpenGraph.io API surfaced to agents: metadata unfurling, HTML scraping, screenshots, markdown conversion, natural-language questions about a page, and on top of that a site-audit suite and an image generator. It runs as a hosted HTTPS endpoint or as a local stdio process.

What you get

Get OG Data — Open Graph metadata, HTML-inferred tags and hybrid social preview data, with use_ai and ai_sanitize
Get OG Scrape Data — raw HTML with scroll-to-bottom and load-more clicks for pages that need them
Get OG Screenshot — full_page, dark_mode, capture_delay, hideSelectors and custom viewport
Get OG Markdown — clean Markdown with only_main_content on by default; JS-heavy pages need full_render: true
Get OG Query and Get OG Extract — ask a question about a page, or pull specific elements by tag name
Site audits: discover a domain's URLs, start an audit, poll it, and read a report with a 0–100 score and prioritized fixes
Get Link Preview returns the Facebook, Twitter/X, LinkedIn and Google cards for a URL, without consuming audit quota
Image generation: generateImage for illustrations, diagrams, icons, social cards and QR codes; iterateImage, inspectImageSession and exportImageAsset around it
Named prompts your client can surface as commands — analyze-webpage, get-page-content, run-site-audit, quick-icon and more

Requirements

An OpenGraph.io account. Two ways in: OAuth 2.1, where the client discovers everything and a browser prompt lets you choose which API key to authorize, or an x-app-id header with your App ID for clients that lack OAuth. The README points at an opengraph-io-mcp-install helper that configures Cursor, Claude Desktop, Windsurf, VS Code, Zed or JetBrains for you, a name npm does not have. Two tiers matter: data and image tools work with either method, but site audit and link preview need OAuth over the hosted transport plus an active Site Audit plan, because they bill against the organization rather than a key. Writing a generated image to disk only works on stdio.

Setup effort

Add the hosted endpoint, then sign in — paste it into your client, then approve the OAuth sign-in

See installation options

USE CASES

01

Reading a page an assistant needs to reason about

Convert the URL to clean markdown with the boilerplate stripped, then work from the text.

02

Checking how a link will look when shared

Get the Facebook, X, LinkedIn and Google preview cards plus a fix list, without spending audit quota.

03

Producing a diagram that matches your brand

Generate from Mermaid or D2 syntax with a style preset and brand colours, then refine it in place.

16 tools

Listed in project docs. Your client may show a different list.

Get OG Data

Get OG Scrape Data

Get OG Screenshot

Get OG Query

Get OG Extract

Get OG Markdown

Discover Site URLs

Start Site Audit

Get Site Audit Status

Get Site Audit Report

Preview Page Audit

Get Link Preview

Generate Image

Iterate Image

Inspect Image Session

BEFORE YOU INSTALL

What to know first

Tools you get

16 tools named in the project's documentation.

Requires

A client that can reach a remote MCP server over HTTP
An OpenGraph.io account — clients with OAuth sign in when they connect; for the others, your App ID goes in the x-app-id header of the client configuration

INSTALLATION

Connect your client

Server setup

ENDPOINT URL

https://mcp.opengraph.io/mcp

Add this hosted endpoint to your MCP client, then sign in.

MCP Clients

Cursor, JetBrains IDEs

JSON

{
  "mcpServers": {
    "opengraph": {
      "url": "https://mcp.opengraph.io/mcp",
      "headers": {
        "x-app-id": "<YOUR_APP_ID>"
      }
    }
  }
}

Windsurf

WINDSURF · JSON

{
  "mcpServers": {
    "opengraph": {
      "serverUrl": "https://mcp.opengraph.io/mcp",
      "headers": {
        "x-app-id": "<YOUR_APP_ID>"
      }
    }
  }
}

Claude Code

CLAUDE CODE · TERMINAL

claude mcp add --transport http --header "x-app-id: <YOUR_APP_ID>" opengraph https://mcp.opengraph.io/mcp

VS Code

VS CODE · JSON

{
  "inputs": [
    {
      "type": "promptString",
      "id": "opengraph-app-id",
      "description": "OpenGraph App ID",
      "password": true
    }
  ],
  "servers": {
    "opengraph": {
      "type": "http",
      "url": "https://mcp.opengraph.io/mcp",
      "headers": {
        "x-app-id": "${input:opengraph-app-id}"
      }
    }
  }
}

Zed

ZED · JSON

{
  "context_servers": {
    "opengraph": {
      "url": "https://mcp.opengraph.io/mcp",
      "headers": {
        "x-app-id": "<YOUR_APP_ID>"
      }
    }
  }
}

Any MCP client

ANY MCP CLIENT · TERMINAL

npm install -g opengraph-io-mcp