Set Up OpenGraph.io MCP in Cursor

Connect OpenGraph.io to Cursor so your AI assistant can preview URLs, extract clean content, capture webpage context, and inspect metadata directly inside your coding workflow. One click to install.

No credit card required.

Cursor IDE + MCP

Cursor IDEAI-powered code editor

stdio

opengraph-io-mcpruns locally on your machine

REST API

OpenGraph.io APIapi.opengraph.io

Tools Available in Cursor

Preview

Extract & Markdown

Screenshots

Site Audit

Image Generation

mcp.opengraph.io/mcp

What You Can Do

What You Can Do in Cursor

Cursor's AI agent becomes dramatically more useful when it can work with URLs. These tools are discovered automatically — just ask in natural language.

Preview a URL

See a page's title, description, image, favicon, and Open Graph metadata — debug your own site's link previews or check a competitor's without leaving your editor.

getOgData

Extract Clean Markdown

Convert any URL to clean, readable Markdown with boilerplate stripped. Pull API docs or articles into your project as context — no HTML parsing required.

getOgMarkdown

Capture a Screenshot

Take full-page or viewport-sized screenshots of any webpage. Compare competitor UIs, verify deployments, or generate visual documentation inline.

getOgScreenshot

Check Open Graph Metadata

Ask the agent to check whether a page has complete Open Graph and Twitter Card tags before you ship it or share it.

getOgData

Audit a Page Before Launch

Run an instant quality check on a single URL, or kick off a full site audit, and get back a prioritized list of SEO and social-sharing fixes.

previewPageAudit

Generate a Diagram or Social Card

Ask the agent to create an architecture diagram, icon, or social card from a prompt, then export it straight into your project.

generateImage

Setup Guide

Set Up Cursor MCP in Under 2 Minutes

Click Add to Cursor above for the fastest path, or paste the config below yourself — hosted is selected by default.

1Create or edit mcp.json: Use ~/.cursor/mcp.json for global access or .cursor/mcp.json in your project root.
2Paste the config: Add the OpenGraph.io entry shown in the panel.
3Restart Cursor: Fully restart (not just reload). A browser tab opens once so you can sign in.
4Verify: Ask “What tools do you have access to?” in chat.

mcp.json

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

Works in either global or project mcp.json. Sign in when Cursor opens the browser tab.

Try It First

Your First Test Prompt

Once the tools appear, paste this into Cursor's chat to confirm everything is wired up correctly.

Try this in Cursor chat

Use OpenGraph.io to preview this URL and summarize the title, description, image, and metadata.

Config Scopes

Global vs. Project-Level MCP Config

Cursor supports two config locations. Choose based on whether you need tools everywhere or just for a specific project.

Global (~/.cursor/mcp.json)

Available in every Cursor workspace
Great for personal tools like web data access
Set up once, use everywhere
Lives in your home directory

Project (.cursor/mcp.json)

Scoped to a single project
Commit to git for team-wide access
Required for Cloud Agents
Takes priority over global config

Developer Prompts

Cursor Workflow Examples

The AI agent automatically picks the right MCP tool based on your request. These prompts work in Cursor's chat, Composer, or inline editing.

Building a feature: “Scrape the Stripe API docs at stripe.com/docs/api and show me how to create a payment intent.”
Reviewing a docs page: “Convert this changelog page to Markdown and summarize what changed for API consumers.”
Checking metadata: “Unfurl my staging site at staging.myapp.com and check if the OpenGraph tags are set up correctly.”
Extracting content: “Scrape news.ycombinator.com and extract the top 10 story headlines with their URLs into a JSON array.”
Capturing visual context: “Screenshot linear.app and describe their hero section design, then help me build something similar.”
Reviewing launch pages: “Audit our new landing page before we ship it and tell me what's missing for SEO and social sharing.”

API & Docs Research

Scrape or convert documentation pages to Markdown and have the agent summarize endpoints, parameters, and code examples inline.

Design & UI Reference

Screenshot competitor pages, analyze their design patterns, and generate implementation code — all in one flow.

Launch Page Review

Run a pre-launch audit and validate OG tags and social sharing previews without switching to a browser.

Security

Your API Key Never Reaches the AI Model

The MCP server runs locally as a subprocess of Cursor. Your App ID stays in your config file and is never sent to the AI model.

Local Config Storage

Your App ID is stored in mcp.json on your machine — never exposed to the AI model or transmitted externally.

Local Subprocess

The MCP server runs as a child process of Cursor on your machine. No cloud hosting, no shared infrastructure.

Stdio Transport

Communication uses standard input/output between Cursor and the MCP server. No open ports, no network exposure.

No Persistent State

The server doesn't cache responses locally or maintain session state. Every request is stateless and ephemeral.

Troubleshooting

Common Issues & Fixes

Most issues are solved by one of these steps. If you're still stuck, check the full troubleshooting guide.

Config not detected / no tools appearing: Fully restart Cursor (not just reload the window). Then check Settings > Tools & MCP to verify the server is listed and enabled.
App ID missing or invalid: Double-check the App ID in your config matches the one in your dashboard, with no extra spaces or quotes.
JSON parse error: Validate your mcp.json at jsonlint.com. Watch for trailing commas and duplicate keys.
Command not found: Ensure Node.js 18+ is installed — run node --version in your terminal. Restart Cursor after updating your PATH.
Request failed: Check your credit balance on the dashboard — some tools (screenshots, AI queries) cost more credits than a metadata lookup and may fail if you're out of balance.
URL cannot be accessed: Some sites block automated requests or require authentication. Try a different URL to confirm the server itself is working.
View MCP logs: Open the Output panel (Cmd+Shift+U) and select “MCP Logs” from the dropdown for detailed error messages.

Cursor MCP Shortcuts

Settings: Cmd+Shift+J > Tools & MCP

Logs: Cmd+Shift+U > MCP Logs

Verify: “What tools do you have?”

Cross-Platform

One MCP Server, 8+ AI Clients

The same opengraph-io-mcp package powers every client below. Only the config file format differs.

Zed

Keep Exploring

All 16 MCP Tools

Browse every capability across Web Data, Site Audit, and Image Generation.

Example Prompts

Copy-paste prompts for previewing, extracting, capturing, and auditing URLs.

MCP Hub

The full overview of OpenGraph.io's MCP server, security model, and client support.

MCP Quickstart Docs

Full setup documentation and configuration reference for every 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

Click Add to Cursor above for a one-click install against the hosted server — Cursor prompts you to sign in and the tools appear automatically. To configure manually, create or edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project root (project-specific), add the OpenGraph.io MCP config, save, and restart Cursor.

Cursor supports the Model Context Protocol (MCP), an open standard that connects Cursor's AI agent to external tools and data sources. The OpenGraph.io MCP server gives the agent URL Intelligence — metadata, content extraction, screenshots, site audits, link preview checks, and image generation — callable directly from Cursor's chat or Composer.

Global config (~/.cursor/mcp.json) makes MCP tools available across all your Cursor workspaces. Project-level config (.cursor/mcp.json) only applies to that project and can be committed to git so your team gets the same tools. Both files are merged — if the same server name appears in both, the project-level config takes priority. Cloud Agents only pick up project-level configs.

Cursor's agent gets all 16 OpenGraph.io MCP tools across three areas: Web Data (metadata, Markdown conversion, HTML scraping, screenshots, and AI-powered page queries), Site Audit & Link Preview (site-wide SEO/social audits and instant single-URL preview checks), and Image Generation (illustrations, diagrams, icons, and social cards) — all directly in your development workflow.

The MCP server itself is free and open-source. It connects to your OpenGraph.io account, which includes a free tier with 100 credits per month. Metadata extraction costs 1 credit, screenshots cost 20 credits (1 if cached), and AI queries cost 100–200 credits. Paid plans start at $25/month for 50,000 credits.

First, fully restart Cursor (not just reload the window). If you're using the hosted config, make sure the sign-in tab wasn't blocked by a popup blocker. If you're using a local config, verify your mcp.json has valid JSON syntax with no trailing commas and that Node.js 18+ is installed (node --version). You can view MCP-specific logs by opening the Output panel (Cmd+Shift+U on Mac, Ctrl+Shift+U on Windows/Linux) and selecting 'MCP Logs'. You can also toggle servers in Settings > Tools & MCP.

Yes. With the OpenGraph.io MCP server connected, just ask Cursor's AI agent in natural language: 'Scrape the pricing page at example.com and create a comparison table.' The agent calls the right tool automatically, fetches the rendered HTML, and processes it — no HTTP requests, API wrappers, or boilerplate code needed.

Yes, with one caveat: Cloud Agents run headless, so they can't complete an interactive browser sign-in. Use the hosted URL with an x-app-id header, or the local npx config with your App ID, in your project's .cursor/mcp.json (not the global ~/.cursor/mcp.json) so Cloud Agents can find and use the tools.

Still have Questions? 🤔

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