iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
To add ScreenshotNeo to a Proxmox-hosted AI agent, configure it as a remote MCP server in the MCP client running alongside that agent—not in Proxmox itself unless the client actually runs on the host. Use https://api.screenshotneo.com/mcp and send a normal ScreenshotNeo API key in an Authorization: Bearer header. The exact settings file and reload steps depend on your MCP client.
ScreenshotNeo’s official API documentation, updated 21 October 2026, describes this as a generic MCP-client connection: “Point any MCP client at https://api.screenshotneo.com/mcp with your key as a Bearer token.” Proxmox supplies the VM, LXC container, storage, and networking; the agent client determines how an MCP server is declared, loaded, refreshed, and monitored.
What do you need before configuring ScreenshotNeo MCP?
You need a running AI agent with an MCP client that supports remote MCP servers over Streamable HTTP, a normal ScreenshotNeo API key, and network access from the guest or container running the client to ScreenshotNeo’s HTTPS endpoint. The endpoint and authentication format come from ScreenshotNeo’s API documentation.
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11- Identify the runtime: know whether the agent and its MCP client run in a VM, an LXC container, or on the Proxmox host. This determines which filesystem contains the MCP settings and which network namespace must reach ScreenshotNeo.
- Get a normal API key: MCP requests use Bearer-token authentication. A key restricted to signed requests for
GET /v1/shotis not sufficient for MCP. - Check guest networking: the runtime needs to resolve and make outbound HTTPS connections to
api.screenshotneo.com. Being able to reach the endpoint from the Proxmox host does not prove a separately networked guest can reach it. - Protect the key: use the client’s supported secret store or environment-backed configuration if available. Do not put a real key in a shared repository, a public config example, or an image used to clone guests.
- Know the client’s transport support: ScreenshotNeo exposes a hosted remote MCP endpoint. Your selected client must support the remote transport and its own header configuration; a client that only launches local MCP processes will need a different connection mode or may not support this setup.
Take an inventory before editing anything. Record the guest name or container ID, the operating environment in which the agent process runs, the account that owns the process, and the client’s documented MCP configuration location. If the agent is launched by a service manager, container entrypoint, or orchestration layer, its environment-backed secrets may be different from those available in an interactive shell.
Popular on Amazon
- 【90 Degree Full Function USB C Adapter】Supports the latest USB4 standard for up to 40Gbps of bandwidth, 8K video support, and up to 240W Fast charging; Support USB PD 3.1 Extended Power Range (EPR) including 140W, 180W and 240W. Your productivity is easily doubled. *Warm Tip: For the best fit, please make sure the USB-C port is fully exposed; thick or bulky cases may affect compatibility.
- 【Reliable Quality】Made from high-quality, scratch-resistant aluminum alloy, delicate metal frame. get excellent wear resistance and heat dissipation. Non-Slip Design for easier insertion and removal.
- 【Small and portable】Ultra thin size, ultra compact design, a petite physique that matches the minimalist design of your modern laptops. Coming with a slim figure that won't block the port next to the one it's plugged into.
- 【Compatibility】Widely work with most usb c, thunderbolt 4/3 devices. Compatibilit for ROG Ally, Steam Deck, Switch, MacBook Pro, Quest 3 VR headset, Surface Book 2, iPhone 18/17/16/15, Samsung Galaxy S23/S22/S21, Note 20/10, Google Pixel, ChromeBook, etc.
- 【Excellence Customer Support】If you experience any issues or cable failure, simply reach out to our dedicated customer service team. We provide a prompt response within 18 hours, providing you with the necessary technical support to resolve any concerns.
How do you add ScreenshotNeo MCP to an agent in Proxmox?
Add the remote server in the MCP settings of the client process that runs with the agent. The following is ScreenshotNeo’s generic configuration example; it shows the endpoint and header, but it is not a guaranteed drop-in file for every client.
- Open the agent client’s MCP settings inside the correct guest. If the agent runs in a VM, use that VM’s client configuration. If it runs in a container, use the client configuration available to that container. Proxmox manages the guest infrastructure; it does not automatically apply host-side application settings inside a guest.
- Add the server entry. Adapt the syntax to the selected client’s documented format and use a real key only in the private configuration or secret mechanism intended for it:
{
"mcpServers": {
"screenshotneo": {
"url": "https://api.screenshotneo.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Replace YOUR_KEY with the actual key without adding quotation marks inside the value, extra spaces, or a second authentication scheme. Keep the server name, such as screenshotneo, stable so the agent’s tool references remain understandable. If the client uses YAML, a graphical settings page, an environment-variable reference, or a different property name, translate the same three values rather than copying this JSON literally.
- Save the settings and reload or refresh MCP connections using that client’s own documented procedure. There is no single Proxmox-wide reload command for MCP clients. Some clients read settings only at startup; others provide a reconnect, refresh, or tool-discovery action.
- Check the client’s connection status and tool discovery. Confirm that the ScreenshotNeo tools are listed, then make a harmless permitted call. A saved JSON entry alone does not prove the guest can reach the endpoint or that the client accepted its configuration.
- Record the working configuration without recording the secret. Keep the endpoint, server label, client version, and guest identity in your operational notes, but redact the Bearer value. This makes future troubleshooting and guest migration easier without creating another copy of the credential.
Where should the configuration live: Proxmox host, VM, or LXC?
The correct location is wherever the MCP client process runs. A Proxmox host configuration affects host processes; it does not automatically become an application configuration inside a VM or container. Likewise, a client configuration in one guest does not register the server for agents running in another guest.
Free tools Windows power users keep installed
One-click scans. No signup required.
| Agent placement | Where to configure MCP | What to verify |
|---|---|---|
| Proxmox host | The host-side client configuration used by the agent process. | The host’s DNS, firewall, proxy, permissions, and service environment. |
| Virtual machine | The MCP settings available inside that VM to the agent’s user or service. | The VM’s own DNS, routing, outbound HTTPS policy, and service environment. |
| LXC container | The client settings inside that container, not merely a file on the host. | The container’s network namespace, DNS, egress policy, and mounted secret mechanism. |
There is no functional requirement to install a ScreenshotNeo screenshot daemon in the guest. The documented setup points the client to ScreenshotNeo’s hosted endpoint. The guest only needs an MCP-capable client, the endpoint configuration, the key, and a permitted network path to the service.
Which ScreenshotNeo tools should appear?
ScreenshotNeo documents three MCP tools: take_screenshot, get_page_info, and capture_pdf. They let a connected agent request a website screenshot, retrieve page metadata, or request a PDF capture.
take_screenshotis the image-capture operation. An agent can use it when a visual representation of a permitted website is needed.get_page_inforetrieves page metadata, which can help an agent inspect a target before requesting an image.capture_pdfrequests a PDF capture when a document-style result is more useful than an image.
The exact argument names, optional parameters, return shape, and error display are supplied by the MCP client’s tool-discovery interface. Do not infer a client-specific schema from the server name alone. First confirm that the tools are discovered, then use the client’s displayed descriptions when constructing a call.
Also popular on Amazon
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
This configuration connects the client to ScreenshotNeo’s hosted remote MCP endpoint. It does not require you to install a local screenshot server in the Proxmox guest. The client still needs its own MCP support and connectivity to the remote service.
Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Scan for outdated or missing drivers - takes under a minute3Clear out junk files and repair common Windows errorsHow can you check connectivity without confusing host and guest networking?
Test from the environment that runs the MCP client, not only from the Proxmox management shell. The important condition is that this runtime can resolve the public endpoint and establish HTTPS access; access from a different network namespace is not a substitute.
- For a VM, check the VM’s own DNS and outbound network path.
- For an LXC container, check the container’s DNS and outbound network path. Do not assume its access matches the host’s.
- If outbound traffic is filtered, allow the guest or container’s required HTTPS egress according to your network policy.
- If the endpoint is reachable from the guest but the client still shows no tools, inspect the client’s MCP logs or status view for configuration parsing, authentication, or connection errors.
- If your environment uses an explicit proxy, confirm that the agent service receives the proxy settings as well as your interactive shell. A shell test that succeeds under one account does not prove that a service account has the same environment.
The Proxmox-specific advice here is about where the client runs and what network it can reach; the exact interface and network configuration vary by installation. Keep two paths separate while diagnosing: the agent-to-ScreenshotNeo HTTPS path, and the page-fetch operation that ScreenshotNeo performs after receiving a tool request.
For example, the guest may be able to connect to api.screenshotneo.com while ScreenshotNeo cannot capture a page at a private LAN address. Conversely, a public target may be capturable by ScreenshotNeo even when the agent’s guest has a restrictive outbound policy that prevents MCP connection. These are different failure domains and should not be fixed with the same change.
What should you know about keys, capture limits, and billing?
ScreenshotNeo’s documentation says API keys are shown once and can be revoked and replaced from the dashboard. Keep a key with the agent’s private configuration, limit access to it, and rotate it if it is exposed. Use a normal API key for MCP rather than a signed-request-only key.
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 →A signed-request-only credential is intended for signed GET /v1/shot calls. The MCP connection instead sends the key in the HTTP header shown above. If authentication fails even though a key appears active, check that you selected a regular API key and that the complete value was copied into the client’s secret mechanism.
Also popular on Amazon
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
ScreenshotNeo’s product page lists 1,000 screenshots per month on the free plan with no card required, and paid examples include 3,000 for $5 per month and 15,000 for $15 per month. These are provider-listed plan terms, not independent performance findings; check the ScreenshotNeo site for current pricing and quotas when choosing a plan.
Plan arithmetic matters for agents because one workflow can issue repeated captures while iterating on a page. Establish a usage expectation for the agent, monitor the account allowance, and avoid assuming that a free allowance or listed price remains unchanged. The numbers above are the published 2026 examples: 1,000 monthly screenshots, 3,000 for $5 monthly, and 15,000 for $15 monthly.
According to ScreenshotNeo’s documentation, cache hits and certain failed captures—including bot checks, blank pages, timeouts, and failed loads—are not billed. Treat that as the provider’s stated billing policy rather than a guarantee about a particular page or an independently verified result. A client may still report an error or consume your agent’s time even when ScreenshotNeo does not charge that attempt.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
One important boundary: ScreenshotNeo refuses capture requests for private and internal addresses, including when a redirect leads to one. That restriction applies to the website ScreenshotNeo is asked to capture; it is separate from the agent’s connection to the public ScreenshotNeo MCP endpoint. A Proxmox dashboard, an RFC1918 address, a localhost URL, or a public URL that redirects into an internal network is therefore not a suitable capture target.
How should you handle secrets in VM and container deployments?
Use the secret facility documented by your MCP client whenever one exists. An environment-backed value is generally preferable to hard-coding a token in a file that is copied into backups, images, or source control, but the exact variable name and interpolation syntax are client-specific. Follow that client’s instructions rather than inventing a variable name.
- Keep the key out of tickets, screenshots, shell history, and shared configuration examples.
- Restrict read access to the account that runs the agent and to administrators who need to rotate credentials.
- Review VM templates, LXC snapshots, backups, and exported configuration because they can preserve a key even after the live file is edited.
- When cloning a guest, remove or replace the inherited credential before allowing the clone to run an agent.
- If a key appears in logs, a repository, or an image, revoke or replace it in the ScreenshotNeo dashboard and then update every client that used it.
The dashboard replacement action is the security boundary; merely deleting a visible copy does not invalidate a credential that another process may have retained.
Also popular on Amazon
- Portable and powerful USB-C HUB: BENFEI USB Type-C HUB, with super-soft and knot-free silicone woven design cable, meets most mobile office needs. Compact, lightweight, stylish, and powerful portable USB C Hub equipped with 1 x HDMI port, 1 x 100W charging, and 3 x USB ports. 18-month warranty, 24-hour response, to ensure you feel at ease when using our product.
- Design centered on comfort and reliability: Thanks to BENFEI's end-to-end in-house cable production capability, in-house PCBA and assembly capability, using the industry's most advanced silicone woven design and process, 20cm cable in length, no knots, super-soft, the HUB is easy to use in all scenarios: laptop, tablet, stand etc. Super-soft, 25000+ life cycles, to meet your daily carrying and office needs.
- 100W Charging: Support up to 90W USB C pass-through charging via Type-C port to keep your laptop powered. 10W is reserved for other interface operations. No data and video function on the Type-C port.
- 4K HDMI Display: The HDMI port supports media display at resolutions up to 4K 30Hz, keeping every incredible moment detailed and ultra vivid. Please note that the C port of the Host device needs to support video output.
- Transfer Files in Seconds: Transfer files and from your laptop at speeds up to 10 Gbps with USB A 3.2 port. Extra 2 USB A 2.0 ports are perfectly for your keyboards and mouse.
What should you troubleshoot if the MCP server does not connect?
| Symptom | Likely cause | What to check |
|---|---|---|
| The client cannot find or connect to the server | The endpoint is mistyped, the guest cannot reach it, or the client does not support the configured remote MCP transport. | Confirm the complete URL is https://api.screenshotneo.com/mcp. Check DNS and outbound HTTPS from the guest or container, then verify the client’s supported remote-server format. |
| The server entry is saved, but no tools appear | The client did not load the entry, needs a refresh, or rejected the configuration syntax. | Use the client-specific configuration format and its documented refresh or reconnect action. Check its MCP status or logs for a parse or discovery error. |
| Authentication fails | The key is missing, malformed, invalid, or restricted to signed requests. | Use a normal API key and pass it as Authorization: Bearer YOUR_KEY. Ensure the value has not been truncated or surrounded by unintended characters. |
| It works from the host but not from the agent | The host and guest/container have different DNS, routing, firewall, or proxy settings. | Check the network path from the actual MCP client runtime. Adjust the guest/container’s permitted outbound HTTPS path rather than relying on a host-only check. |
| The client connects but a capture request fails | The requested page may be unavailable to the capture service, may be a private/internal address, or may fail to load. | Check the target URL and the client’s returned error or verdict. ScreenshotNeo documents that it rejects private/internal targets and does not bill certain failed captures. |
| A service works interactively but not after reboot | The service account does not receive the interactive user’s MCP file, environment variable, or proxy setting. | Compare the service’s configured user, working directory, secret source, and client startup procedure with the settings used during the successful interactive test. |
| A cloned VM or container suddenly shares unexpected usage | The clone inherited the original agent configuration and API key. | Remove or rotate the inherited key, assign an intentional credential, and confirm which guest is making MCP calls before enabling automation. |
Do not diagnose a failure only by changing the Proxmox host configuration: first establish whether the MCP client itself runs on the host, in a VM, or in a container, then check that runtime’s settings and network path. Also avoid changing several variables at once. Verify the URL, transport support, key type, header, guest egress, and client reload state in that order so the resulting error is meaningful.
How do you verify a successful setup safely?
A successful verification has several parts. First, the client reports that the remote server is connected or ready. Second, the tool list contains take_screenshot, get_page_info, and capture_pdf. Third, a harmless permitted call returns a normal result. Finally, the client logs do not show recurring authentication, reconnect, or discovery errors.
Use a public, non-sensitive URL for the initial call. Do not use a private Proxmox address as a test target, because ScreenshotNeo’s private and internal-address restriction will produce a capture failure unrelated to MCP connectivity. Do not describe the setup as tested merely because the JSON was saved; state that it is verified only after the client has discovered the tools and completed an allowed call.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Or skip the browser setup
If you need a direct screenshot request rather than an agent calling MCP tools, ScreenshotNeo also provides a one-request screenshot API. This is an API alternative, not a replacement for configuring the MCP server when you specifically need MCP tools. See the ScreenshotNeo API documentation.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpThe direct endpoint is useful for a scripted or manually initiated image request, while MCP is useful when the agent should discover and call tools as part of a larger workflow. Do not substitute a signed-request-only key into the MCP header simply because it works with a signed GET /v1/shot request; MCP requires the normal API-key authentication described above.
ScreenshotNeo says it accepts cookie or consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; those steps can be turned off. Bot checks, blank pages, and failed loads are not billed under its stated policy. Its MCP server gives AI agents the tools take_screenshot, get_page_info, and capture_pdf. The free plan includes 1,000 screenshots a month with no card, and paid plans start at $5 for 3,000 screenshots, according to the provider’s published 2026 plan examples.
Sign up for ScreenshotNeo’s free plan to get 1,000 screenshots a month with no card. Review the current plan page before automating high-volume agent workflows because quotas and prices can change.
Also popular on Amazon
- 【Read before You Buy】 Note: This adapter is USB 2.0 version and cannot transmit HDM, VGA, or other video signals. Nevertheless, they are fully capable of charging devices,duplicating files, and can be seamlessly integrated with USB-C earphones, wireless network adapters, and SD card adapters.
- 【Easy to Use and Safe】Thanks to modern manufacturing techniques, we've made these adapters sufficiently compact so that they can remain inserted in your device without noticeable protrusion or inconvenience. This means you don't have to constantly plug and unplug them, reducing the likelihood of wear and misalignment, and making them more convenient to carry around.
- 【Reliable Quality】Engineered for enhanced durability, durable aluminum alloy shell material,get excellent wear resistance and heat dissipation,the male USB C and female USB connectors & the male USB and female USB C connectors are designed to be plugged and unplugged up to 20000 times. Provides data transfer, device charging, memory space expansion, and additional computer peripherals.
- 【Think more for you】Do you need to connect a USB-C-enabled device to an odd device that only has USB-A ports? Then these USB-A male to USB-C female adapters are made for you.Simply insert the adapter into the USB-A port on the device, and you can instantly connect your USB-C device to the device that originally didn't have the correct connection port.
- 【Trusted xiwxi Quality and Service】As a responsible brand seller, you will receive xiwxi's 12-month Quality assurance and lifetime friendly customer service, you're not just buying a product,you're investing in peace of mind with all-round quality and exceptional customer service.
Frequently Asked Questions
Can I use the same ScreenshotNeo key for more than one agent?
The documented authentication method is a Bearer API key. If you share a key across runtimes, treat every runtime and its logs or backups as having access to that credential; use your account’s key controls to replace it if its exposure is uncertain. Separate keys or carefully isolated secret storage make it easier to identify and disable one agent without disrupting others.
What should I do if I accidentally exposed my API key?
Revoke or replace the key from the ScreenshotNeo dashboard, then update the MCP client’s private configuration with its replacement. Also remove the exposed value from any shared configuration or repository where practical; deleting a visible copy alone does not invalidate the credential. Check VM templates, LXC snapshots, backups, logs, and shell history for additional copies.
Can the ScreenshotNeo MCP server capture a private Proxmox dashboard by its LAN address?
No. ScreenshotNeo documents that it refuses capture requests to private and internal addresses, including targets reached through redirects. This restriction concerns the page being captured, not the agent’s connection to ScreenshotNeo’s public MCP endpoint. Use a permitted public target for verification instead.
Do I install ScreenshotNeo inside the Proxmox VM?
No local screenshot server is required for the documented MCP setup. Configure the MCP client in the VM or container where the agent runs and point it to ScreenshotNeo’s hosted endpoint. The guest still needs MCP-client support, the Bearer key, and outbound HTTPS access.
Why does the host reach ScreenshotNeo while my container does not?
The host and container can have different DNS, routes, firewall rules, proxy settings, and network namespaces. Test from the container that runs the MCP client and adjust that guest’s permitted outbound HTTPS path. A successful host-side check does not establish container connectivity.
Can I use a signed-request-only key with MCP?
No. ScreenshotNeo documents signed-request-only keys for signed GET /v1/shot calls. MCP uses a normal API key in the Authorization: Bearer YOUR_KEY header.
How do I know whether the setup really works?
The client should report a connected remote server, discover take_screenshot, get_page_info, and capture_pdf, and complete a harmless call against a permitted public URL. A saved configuration entry without tool discovery is not sufficient verification.
Are failed screenshots charged?
ScreenshotNeo’s documentation says cache hits and certain failed captures, including bot checks, blank pages, timeouts, and failed loads, are not billed. Treat this as the provider’s stated policy; an individual result can still fail and should be checked in the client response.
The Bottom Line
Configure ScreenshotNeo in the MCP client that actually runs your Proxmox-hosted agent. Use https://api.screenshotneo.com/mcp, authenticate with a normal API key as Authorization: Bearer YOUR_KEY, verify DNS and HTTPS from the VM or container, and refresh the client until its three documented tools appear. Keep the key private, remember that private or internal capture targets are refused, and recheck ScreenshotNeo’s published quotas and prices when planning usage.
