Connect Cursor to SnapshotFlow MCP

Add the server

Cursor reads MCP servers from mcp.json. Create or edit the file in one of two places:

• .cursor/mcp.json in the project, for this project only. Commit it to share with your team.
• ~/.cursor/mcp.json in your home directory, for all projects.

{
  "mcpServers": {
    "snapshotflow": {
      "url": "https://api.snapshotflow.com/mcp"
    }
  }
}

No API key or headers are needed: the server uses OAuth. Restart Cursor if the server does not appear after saving.

Or ask Cursor to do it

Paste this into Cursor chat and review the change before accepting it:

Add the SnapshotFlow MCP server to this project. Create or update .cursor/mcp.json with:

{
  "mcpServers": {
    "snapshotflow": {
      "url": "https://api.snapshotflow.com/mcp"
    }
  }
}

Then tell me how to sign in and enable it.

Sign in and enable it

1. Open the Customize page from the sidebar (in older versions: Cursor Settings → Tools & MCP).
2. Find snapshotflow and start the connection. Cursor opens the SnapshotFlow sign-in in your browser.
3. After you sign in, turn the server's toggle on.

Check that it works

Open an Agent conversation and ask:

Which SnapshotFlow tools can you use? Take a screenshot of https://example.com to test the connection.

The agent should list screenshot, batch_screenshot, visual_diff, extract_text, and check_job, then return an image and a download link.

Prompts to try in Cursor

SnapshotFlow renders pages on its own servers, so use a deployed or preview URL rather than localhost.

Take full-page screenshots of https://preview.example.com at 1440 and 390 pixels wide. Compare them with the CSS in this project and fix anything that breaks on mobile.

Use SnapshotFlow visual_diff to compare https://staging.example.com/pricing with https://example.com/pricing and explain the visual changes.

Read https://docs.example.com/changelog with SnapshotFlow extract_text and list the breaking changes that affect this codebase.

Troubleshooting

• See connection errors. Open the Output panel (Cmd+Shift+U or Ctrl+Shift+U) and select MCP Logs.
• Two configs with one name. A project .cursor/mcp.json entry called snapshotflow overrides the global one. Keep a single entry.
• Sign-in expired. Turn the server off and on in Customize and complete the sign-in again.
• The agent does not call the tool. Check that the server toggle is on, then mention SnapshotFlow by name in the prompt.

What it costs

Your AI client spends its own model tokens, billed by your AI provider. SnapshotFlow only counts screenshots against your account:

New accounts get 300 free screenshots for the lifetime of the account. No credit card required. See pricing for paid plans.

Sources

Steps checked against the official documentation on October 29, 2026. Client menus change often; if a label differs, the linked page has the current name.

• Cursor docs: Model Context Protocol

Other MCP clients

The same server works with any client that supports remote MCP over Streamable HTTP with OAuth. Setup guides:

• Claude Code
• Claude
• Codex
• VS Code
• Antigravity
• Zed

See SnapshotFlow MCP server for all clients, the tool list, and capture options, or the MCP reference for tool schemas. For more tasks to try, browse the MCP prompt library.