Opengraph.io

What is Opengraph.io?

Opengraph.io is a Model Context Protocol (MCP) server that exposes every OpenGraph.io API endpoint to AI agents such as Anthropic Claude, Cursor, and LangGraph. It acts as a secure bridge, allowing autonomous agents to unfurl links, scrape HTML, extract article text, capture screenshots, and generate images without exposing raw API keys.

How to use Opengraph.io?

Install globally via npm install -g opengraph-io-mcp or use the CLI installer with npx opengraph-io-mcp-install. Configure the server in your MCP client (e.g., Claude Desktop, Cursor, VS Code) using stdio transport and setting the APP_ID environment variable to your OpenGraph.io App ID. For HTTP/SSE transport, run npm start and point clients to http://localhost:3010/sse?app_id=YOUR_APP_ID.

Key features of Opengraph.io

• Exposes all OpenGraph.io data endpoints as MCP tools
• Includes AI-driven image generation (illustrations, diagrams, social cards, QR codes)
• Supports multiple MCP clients: Claude Desktop, Cursor, Windsurf, VS Code, Zed, JetBrains
• Offers both stdio and HTTP/SSE transport options
• Provides iteration and export capabilities for generated images
• Installs globally via npm or one‑click CLI installer

Use cases of Opengraph.io

• AI agents automatically unfurl links and extract Open Graph metadata from URLs
• Generate social‑media‑optimized images (OG cards, Twitter cards) directly from prompts
• Create technical diagrams from Mermaid, D2, or Vega syntax within chat interfaces
• Capture webpage screenshots and retrieve structured HTML extracts on demand
• Query webpages with custom questions and receive structured answers

FAQ from Opengraph.io

What is required to use this server?

An OpenGraph.io App ID is required. You can provide it via the APP_ID environment variable, a .env file, or a command‑line argument (--app-id).

Which transport options are supported?

Stdio transport (recommended) and HTTP/SSE transport. Stdio is configured for most MCP clients; SSE runs a persistent web server on port 3010.

Can I use it with Claude Desktop or Cursor?

Yes. Detailed configuration examples for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Zed, and JetBrains are provided in the README.

What types of images can be generated?

Illustrations, diagrams (Mermaid, D2, Vega), icons, social cards, and QR codes. Each type supports preset aspect ratios and style presets.

How do I iterate on or export a generated image?

Use the Iterate Image tool to modify an existing image by session and asset ID. Use Export Image Asset to retrieve the image inline as base64, optionally saving to disk when running locally.