Opengraph.io
About
Opengraph data, web scraping, screenshot features in a handy MCP tool
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Opengraph.ioCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The server requires an OpenGraph.io App ID to function properly. You can provide this in several ways:
1. Using environment variables: Set OPENGRAPH_APP_ID or APP_ID in a .env file or as an environment variable
2. Using command-line arguments with stdio transport: --app-id YOUR_APP_ID
3. When using SSE transport: Include it in the URL as a query parameter (?app_id=YOUR_APP_ID)
Example .env file:
OPENGRAPH_APP_ID=your_app_id_here
You can install this package globally via npm:
npm install -g opengraph-io-mcp
The easiest way to configure OpenGraph MCP for any supported client:
npx opengraph-io-mcp-install
All configurations below use stdio transport (recommended). Replace YOUR_OPENGRAPH_APP_ID with your OpenGraph.io App ID.
1. Clone this repository
2. Install dependencies:
npm install
3. Build the TypeScript code:
npm run build
4. Start the server:
npm start
The server will run on port 3010 by default (configurable via PORT environment variable).
| Tool Name | OpenGraph.io API Endpoint | Description | Documentation |
|-----------|---------------------------|-------------|---------------|
| Get OG Data | /api/1.1/site/<URL> | Extracts Open Graph data from a URL | OpenGraph.io Docs |
| Get OG Scrape Data | /api/1.1/scrape/<URL> | Scrapes data from a URL using OpenGraph's scrape endpoint | OpenGraph.io Docs |
| Get OG Screenshot | /api/1.1/screenshot/<URL> | Gets a screenshot of a webpage using OpenGraph's screenshot endpoint | OpenGraph.io Docs |
| Get OG Query | /api/1.1/query/<URL> | Query a site with a custom question and optional response structure | OpenGraph.io Docs |
| Get OG Extract | /api/1.1/extract/<URL> | Extract specific HTML elements (h1, p, etc.) from a webpage | OpenGraph.io Docs |
| Tool Name | Description |
|-----------|-------------|
| Generate Image | Create professional images: illustrations, diagrams (Mermaid/D2/Vega), icons, social cards, or QR codes |
| Iterate Image | Refine, modify, or create variations of existing generated images |
| Inspect Image Session | Retrieve session metadata and asset history for image generation sessions |
| Export Image Asset | Export generated image assets as inline base64, with optional disk write when running locally |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"opengraph.io": {
"opengraph": {
"command": "npx",
"args": [
"-y",
"opengraph-io-mcp"
],
"env": {
"OPENGRAPH_APP_ID": "YOUR_APP_ID_HERE"
}
},
"opengraph-io-hosted-mcp": {
"url": "https://mcp.opengraph.io/mcp",
"headers": {
"x-app-id": "YOUR_APP_ID_HERE"
}
}
}
}
}McpServers
{
"opengraph": {
"command": "npx",
"args": [
"-y",
"opengraph-io-mcp"
],
"env": {
"OPENGRAPH_APP_ID": "YOUR_APP_ID_HERE"
}
},
"opengraph-io-hosted-mcp": {
"url": "https://mcp.opengraph.io/mcp",
"headers": {
"x-app-id": "YOUR_APP_ID_HERE"
}
}
}| Tool Name | OpenGraph.io API Endpoint | Description | Documentation |
|-----------|---------------------------|-------------|---------------|
| Get OG Data | /api/1.1/site/<URL> | Extracts Open Graph data from a URL | OpenGraph.io Docs |
| Get OG Scrape Data | /api/1.1/scrape/<URL> | Scrapes data from a URL using OpenGraph's scrape endpoint | OpenGraph.io Docs |
| Get OG Screenshot | /api/1.1/screenshot/<URL> | Gets a screenshot of a webpage using OpenGraph's screenshot endpoint | OpenGraph.io Docs |
| Get OG Query | /api/1.1/query/<URL> | Query a site with a custom question and optional response structure | OpenGraph.io Docs |
| Get OG Extract | /api/1.1/extract/<URL> | Extract specific HTML elements (h1, p, etc.) from a webpage | OpenGraph.io Docs |
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
