OpenGraph MCP Server for Windsurf

Why Use OpenGraph MCP in Windsurf?

Windsurf's Cascade AI becomes significantly more powerful when it can access live web data. With OpenGraph MCP, Cascade can:

• Analyze documentation – Fetch and understand API docs on the fly
• Inspect websites – Capture screenshots for UI/UX analysis
• Extract content – Pull structured data from any webpage
• Debug link previews – Test OpenGraph metadata for your sites

Installation

1. Create or Edit Your MCP Config

   Open or create ~/.codeium/windsurf/mcp_config.json:

   ~/.codeium/windsurf/mcp_config.json

   Copy

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

   Prefer a static API key instead of signing in? See Signing In for the alternate config.

2. Restart Windsurf

   Completely restart Windsurf. A browser tab will open the first time you connect so you can sign in with your OpenGraph.io account — no App ID needed.

3. Verify the Connection

   Open Cascade and try:

   Test prompt

   Copy

   Unfurl https://github.com and summarize the page metadata.

Available Tools

Once connected, Cascade has access to:

• Get OG Data – Extract OpenGraph metadata and Twitter Cards
• Screenshot – Capture full-page or viewport screenshots
• Scrape – Fetch raw HTML with JavaScript rendering
• Query – Ask questions about webpage content

Example Prompts

Documentation Research

Scrape the React documentation at https://react.dev/learn and summarize the main concepts.

Design Inspiration

Take a screenshot of https://vercel.com and describe their navigation design pattern.

Competitive Analysis

Unfurl https://stripe.com and https://square.com and compare their OpenGraph metadata strategies.

Troubleshooting

Tools not appearing?

• Ensure Windsurf is fully restarted (not just reloaded)
• Verify the config file path is exactly ~/.codeium/windsurf/mcp_config.json
• If you signed in, make sure you approved the connection in the browser tab that opened
• Validate your JSON syntax (no trailing commas)

Common Errors

• Sign-in prompt never appears – Remove and re-add the config, then fully restart Windsurf
• "Invalid App ID" (API key mode) – Verify your App ID in the dashboard

Related Guides