Windsurf + MagicScreenshots

App Store screenshots in Windsurf

• Search real App Store screenshots and preview videos from the top apps
• Use them as design reference for your own app
• Generate and localize your own App Store screenshots

How do I add MagicScreenshots to Windsurf?

~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "magicscreenshots": {
      "serverUrl": "https://www.magicscreenshots.com/api/mcp"
    }
  }
}

1. Open mcp_config.json: ~/.config/devin/mcp_config.json on Mac and Linux, %APPDATA%\devin\mcp_config.json on Windows (current docs, now published under Devin Desktop).
2. Paste the magicscreenshots entry and save.
3. Refresh MCP servers in Cascade, then ask for App Store screenshots.
4. For generation, add your API key as an Authorization header.

What is Windsurf?

Windsurf is an AI code editor from Cognition whose agent is called Cascade. Cascade can call tools from remote MCP servers listed in mcp_config.json.

Do I need an API key?

Search works with no key. For restyle and localize, add an Authorization header with your key. Windsurf uses serverUrl, not url.

{
  "mcpServers": {
    "magicscreenshots": {
      "serverUrl": "https://www.magicscreenshots.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MAGICSCREENSHOTS_API_KEY"
      }
    }
  }
}

MCP, skill or CLI: which should I use?

• MCP server: Most people
• Skill: Agents you want to follow the inspiration → restyle flow on their own
• CLI: Scripts, CI and one-off lookups

FAQ

How do I connect MagicScreenshots to Windsurf?

Open mcp_config.json: ~/.config/devin/mcp_config.json on Mac and Linux, %APPDATA%\devin\mcp_config.json on Windows (current docs, now published under Devin Desktop). Then paste the magicscreenshots entry and save. The server URL is https://www.magicscreenshots.com/api/mcp.

Do I need an API key to use MagicScreenshots in Windsurf?

Search works with no key. For restyle and localize, add an Authorization header with your key. Windsurf uses serverUrl, not url.

Is the MagicScreenshots MCP server free?

Searching the library is free and needs no account. Generating your own screenshots uses credits. Listing history and preview video downloads are part of Library Pro.

Which App Store screenshots can Windsurf find?

About 4,700 real App Store listings: the top 100 free and top-grossing apps in every Apple category, refreshed daily. Search by name, category, look or chart position.

Can Windsurf get App Store preview videos?

Yes. Poster frames are free for everyone. With a Library Pro API key, get_app_videos also returns download links to the preview video files.

Can Windsurf make App Store screenshots for my app?

Yes, with an API key. Ask it to restyle your screenshots like an app from the library with create_restyle, or localize them with create_localize. The first time, it calls create_api_key and you open the claim link to sign in and buy credits.

Is MagicScreenshots made by Cognition?

No. MagicScreenshots is an independent product that works with Windsurf through the open Model Context Protocol. It is not affiliated with or endorsed by Cognition.

Other agents

• Claude Code
• Cursor
• Codex
• Claude
• ChatGPT
• Gemini CLI
• VS Code + GitHub Copilot
• Zed
• Cline
• Lovable
• Bolt
• v0
• Replit Agent
• Figma Make
• Perplexity
• Grok Build
• Kimi Code
• OpenClaw
• Hermes Agent
• Paperclip
• NanoClaw

Last updated September 2026 · AI agents guide

Product names and logos are trademarks of their owners. MagicScreenshots is not affiliated with or endorsed by them.