To screenshot a web page in Cursor, use its integrated Browser tool: ask Agent to open the page and capture a screenshot. To supply an image from another capture tool, configure an MCP server that returns image content; Cursor can attach that image to chat for analysis when the selected model supports images. These are distinct workflows: Browser captures a page in Cursor’s browser, while an MCP image tool hands Cursor an image captured elsewhere.
Choose the screenshot workflow that fits
| What you need | Use | What provides the image |
|---|---|---|
| Capture a website page in Cursor | Cursor’s integrated Browser tool | Cursor-controlled browser, directed by Agent |
| Send an image produced by another service or tool to Cursor | A custom or Marketplace MCP server with an image-returning tool | The server captures or obtains the image; MCP carries it to Cursor |
| Capture your own desktop rather than a page in Cursor’s browser | Cursor’s computer-use worker workflow | A worker with the required platform setup and permissions |
Cursor’s Browser documentation describes screenshots as visual representations that help Agent understand layout and confirm browser actions. MCP image content is a handoff format: it does not, by itself, capture a browser window or desktop. For a custom server, the server’s own documentation determines how it captures, authenticates, and formats the image.
Capture a website screenshot with Cursor Browser
- Open Cursor and start an Agent task with the Browser tool available. If the tool is unavailable, check Cursor’s Browser settings and whether browser features are enabled for your organization.
- Ask Agent to navigate to the page and capture it. For example:
Open https://example.com in the browser and take a screenshot of the page. - Review the resulting screenshot in the conversation. Use a precise follow-up if you need Agent to inspect a particular region, compare the page layout, or confirm an interaction.
This route is suited to inspecting a web page through the browser Cursor controls. For a screenshot of an already-running desktop application, use computer use instead; the browser tool and desktop worker are not interchangeable.
Return a screenshot from an MCP server
Use a custom MCP server when the screenshot must come from an external service, a specialized capture process, or a tool you maintain. Configure or install the server, make its capture tool return image data, and then invoke that tool from Cursor.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Clear out junk files and repair common Windows errorsFree Scan →#1 Best Overall
- CRISP CLARITY: This 23.8″ Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
- INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
- THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors
- WORK SEAMLESSLY: This sleek monitor is virtually bezel-free on three sides, so the screen looks even bigger for the viewer. This minimalistic design also allows for seamless multi-monitor setups that enhance your workflow and boost productivity
- A BETTER READING EXPERIENCE: For busy office workers, EasyRead mode provides a more paper-like experience for when viewing lengthy documents
Image content format
Cursor documents MCP image returns as base64-encoded data with a MIME type. A tool response has an image content block with the image’s MIME type (for example, image/png) and the base64 data. Cursor attaches returned images to chat; whether the selected model can analyze the image depends on that model’s image support. See Cursor’s MCP documentation for its image-return guidance.
The server is responsible for obtaining the screenshot and returning valid image data. Cursor’s generic MCP guide does not prescribe a universal screenshot capture library, authentication scheme, or server implementation. Check the chosen server’s documentation for those details rather than assuming that enabling MCP creates a capture method.
Configure and verify the server
- Add the MCP server through Cursor Marketplace or configure a custom server in
mcp.json. Cursor describes MCP servers as connections to external tools and data sources; see the MCP guide. - Confirm the server is enabled and that its screenshot tool is exposed to Cursor. Ask Agent to use the tool by name or describe the task you want it to perform.
- Check that the tool response contains an image content block with a correct MIME type and valid base64 data. If the tool reports success but no image appears, inspect the server’s response format and logs.
- Ask Agent to analyze the returned image only if the selected model supports image input.
Use MCP screenshots from the Cursor CLI
Cursor says its CLI shares MCP configuration with the editor. After configuring a server, use the CLI to check that it is present and exposes the expected tools:
agent mcp list— lists configured MCP servers and their status.agent mcp list-tools <server>— inspects the tools exposed by a server. Replace<server>with its configured name.
Cursor’s documented CLI example for a Browser screenshot task is:
Do these 3 things before closing this tab:
1Fix the driver behind crashes, sound loss and screen glitches2Clear out junk files and repair common Windows errors3Scan for outdated or missing drivers - takes under a minuteRank #2
- CRISP CLARITY: This 22 inch class (21.5″ viewable) Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
- 100HZ FAST REFRESH RATE: 100Hz brings your favorite movies and video games to life. Stream, binge, and play effortlessly
- SMOOTH ACTION WITH ADAPTIVE-SYNC: Adaptive-Sync technology ensures fluid action sequences and rapid response time. Every frame will be rendered smoothly with crystal clarity and without stutter
- INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
- THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors
agent -p "Navigate to google.com and take a screenshot of the search page"
The prompt asks the agent to navigate and take a screenshot; it is not a command-line image-capture library. For current CLI MCP details, see Cursor’s CLI MCP documentation.
Capture a self-hosted desktop
If “screenshot” means the screen of a self-hosted computer rather than a page in Cursor Browser, use the separate computer-use worker workflow. Setup differs by operating system, and a successful worker installation alone does not prove that screenshot permissions or display access work.
macOS
- Start the worker with
agent worker --computer-use start. - Grant Accessibility and Screen Recording permissions to Cursor Computer Use when prompted or in macOS privacy settings. These permissions must be granted to Cursor Computer Use, not Terminal or the Cursor desktop app.
- Run a real computer-use task that produces a screenshot to verify the complete workflow.
agent worker debug can confirm helper installation on macOS, but Cursor notes that it does not report whether Accessibility and Screen Recording permissions are granted.
Rank #3
- Clear visuals. Fluid motion: A 144Hz refresh rate and 1ms MPRT deliver smooth, tear‑free motion across work, gaming, and streaming for clearer, more fluid viewing.
- Eye comfort: TÜV Rheinland 3‑star* certification reduces harmful blue light while preserving stunning color quality without compromise. *TÜV Rheinland 3-star eye comfort certification.
- Wide viewing angle: Get consistent views across a wide 178° /178° viewing angle.
- In-Plane Switching (IPS): See excellent color accuracy and consistency across wide viewing angles with In-plane Switching (IPS) technology.
- Ultra-thin bezels: Maximize your viewing experience with thin bezels.
Linux
Cursor’s computer-use workflow uses X11 and requires the documented desktop packages on the worker. Chrome or Chromium is optional but recommended for browser use. Check Cursor’s computer-use setup documentation for the applicable packages and setup details. Verify the X11 display and complete a task that returns a screenshot; an MCP server returning an image is a different route from capturing the worker’s desktop.
Enterprise browser access and origin controls
For enterprise deployments, administrators can enable browser features and configure origin allowlists. When an allowlist is configured, automatic navigation and MCP tool execution are limited to allowed origins. Manual navigation can still display other origins, but browser tools are blocked there. If an automated screenshot fails only on certain domains, ask an administrator to check the allowlist and the applicable organization settings. See Cursor’s enterprise Browser documentation.
Security and access checks
An MCP server may receive access to tools, data, or credentials, so treat setup as a security decision, not just a screenshot setting. Cursor advises users to verify server sources, review permissions, use restricted API keys, and audit server code for critical integrations. Give a server only the access it needs, and avoid placing broadly privileged secrets in its configuration. See Cursor’s MCP guidance.
Troubleshoot common screenshot failures
| Symptom | Likely cause | What to check |
|---|---|---|
| Agent cannot find or use Browser | Browser features are unavailable, disabled, or restricted by organization policy. | Check Browser availability and ask an enterprise administrator about feature access and origin controls. |
| Page opens manually but automated navigation or tools are blocked | The origin is outside the configured enterprise allowlist. | Ask the administrator to review the allowed origins. Manual display of a page does not mean browser tools are permitted there. |
| MCP server does not appear or its tool is missing | The server may not be configured, enabled, connected, or exposing the expected tool. | Check the Cursor MCP configuration, then run agent mcp list and agent mcp list-tools <server> in the CLI. |
| Tool runs but Cursor shows no image | The tool response may not contain valid image content, a MIME type, or base64 data. | Inspect the server response and logs; verify the image content block and encoding against Cursor’s MCP image guidance. |
| Image appears, but Agent cannot interpret it | The selected model may not support image input. | Use a model with image support or use the screenshot for visual reference without requesting image analysis. |
| macOS worker starts but cannot capture the screen | Accessibility or Screen Recording permission may be missing, or granted to the wrong app. | Grant both permissions to Cursor Computer Use and test with a real screenshot task. agent worker debug does not confirm these permissions. |
| Linux desktop capture does not work | The worker may lack the required X11 display or desktop packages. | Check the worker’s X11 setup and required packages in Cursor’s computer-use documentation; test an actual screenshot task. |
| Screenshot tool cannot access the target site | The custom server’s capture method, authentication, or network access may be failing. | Check that server’s documentation and logs. Cursor’s generic MCP image format does not define the capture mechanism or access policy. |
Or skip the browser setup
If you want a website screenshot without setting up a browser workflow or a capture server, ScreenshotNeo can return a screenshot or PDF from one GET request. Its cookie-consent handling, popup and chat-widget removal can be turned off individually. It reports page verdict and billing status in response headers: bot checks, blank pages, timeouts, failed loads, and cache hits are not billed. It also provides an MCP server with take_screenshot, get_page_info, and capture_pdf tools for AI agents, including Cursor.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Rank #4
- CURVED FOR ENHANCED ENGAGEMENT: An immersive viewing experience with a curved monitor that wraps more closely around your field of vision; It creates a wider view, enhancing depth perception and minimizing peripheral distraction
- SMOOTH PERFORMANCE FOR SEAMLESS CONTENT: Stay in the action when playing games, watching videos, or working on creative projects; The 100Hz refresh rate reduces lag and motion blur so you don't miss a thing in fast-paced moments¹
- MORE GAMING POWER: Gain the edge with optimizable game settings; Color and image contrast can be adjusted to see scenes more vividly and spot enemies hiding in the dark; Game Mode adjusts any game to fill the screen so you can view every detail²
- KEEP IT EASY ON THE EYES: Care for your eyes and stay comfortable, even during long sessions; Advanced eye comfort technology certified by TÜV reduces eye strain by minimizing blue light and reducing irritating screen flicker²
- INCREASED VERSATILITY: Connect to more; Plug devices straight into your monitor for increased flexibility, making your computing environment even more convenient
Example cURL request, with the URL encoded by --data-urlencode:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
Replace YOUR_API_KEY with your API key and change the target URL as needed. The API returns the requested screenshot or PDF; see the ScreenshotNeo API documentation for request parameters and response details. If you need a specific format or capture behavior, set the corresponding supported options in the request.
ScreenshotNeo includes 1,000 screenshots per month on its free plan with no card required; paid plans start at $5 for 3,000 screenshots. Sign up for free and get 1,000 screenshots a month with no card.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Best Value
- 【INTEGRATED SPEAKERS】Whether you're at work or in the midst of an intense gaming session, our built-in speakers provide rich and seamless audio, all while keeping your desk clutter-free.
- 【EASY ON THE EYES】 Protect your eyes and enhance your comfort with Blue-Light Shift technology. This feature reduces harmful blue light emissions from your screen, helping to alleviate eye strain during long hours of use and promoting healthier viewing habits.
- 【WIDEN YOUR PERSPECTIVE】Our sleek minimal bezel design ensures undivided attention. The nearly bezel-free display seamlessly connects in a dual monitor arrangement, delivering an unobstructed view that lets you focus on more at once, completely distraction-free.
FAQ
Does MCP itself take the screenshot?
No. MCP connects Cursor to tools. A screenshot tool or Cursor’s Browser/worker must capture the image; MCP can then return image content to Cursor.
Can I take a screenshot of a local development site?
The Cursor Browser route is intended for browser navigation and screenshots, but access to a particular local address can depend on Cursor’s environment and organization settings. For a custom server, check whether its capture environment can reach that address.
Does a returned screenshot automatically become a file on my computer?
Cursor’s MCP documentation describes returning images to chat for viewing and analysis. It does not establish that every image response is automatically saved as a local file; use the server’s own output or save/export options when you need a file.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
