Connect Screenshotone to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the analyze page with vision tool in Screenshotone
Use the get usage tool in Screenshotone
Use the generate pdf tool in Screenshotone
Use the extract page metadata tool in Screenshotone
Use the take screenshot tool in Screenshotone
Use the render file tool in Screenshotone
Supported Tools
analyze_with_vision
Analyze Page with Vision
Capture a screenshot and analyze it using OpenAI Vision in a single API call. Provide a prompt to describe what you want to learn from the visual content of the page.
Useful for visual QA, accessibility auditing, content analysis, competitive analysis, and any task that requires understanding what a rendered page looks like.
get_usage
Get Usage
Check current API usage and remaining quota for the ScreenshotOne account.
Returns total allowed requests, used requests, available requests remaining, and request slots in the current one-minute concurrency bucket.
generate_pdf
Generate PDF
DEPRECATED — use `render_file` instead. Render a web page (by URL), HTML, or Markdown content as a PDF document. Returns a URL to the generated PDF.
Supports configurable paper size, orientation, margins, background printing, and single-page fitting. Includes all page customization features such as content blocking, script injection, dark mode, and device emulation.
extract_metadata
Extract Page Metadata
Extract metadata from a web page including page title, Open Graph tags, favicon, fonts used, HTTP response status/headers, and page content as HTML or Markdown.
Page content is returned as a downloadable file URL when extraction succeeds. Use this to scrape structured information from web pages without needing to process raw screenshots. Useful for link previews, content extraction, SEO analysis, and page auditing.
take_screenshot
Take Screenshot
DEPRECATED — use `render_file` instead. Capture a screenshot of a web page (by URL), or render HTML/Markdown content as an image. Returns a URL to the rendered screenshot.
Supports multiple output formats (PNG, JPEG, WebP, GIF, AVIF, etc.), full-page capture, element-level selection via CSS selectors, device emulation, content blocking (ads, cookie banners, chat widgets), dark mode, custom JavaScript/CSS injection, geolocation emulation, and caching.
render_file
Render File
Capture a website or render HTML/Markdown as a downloadable image, PDF, HTML, or Markdown file. Delivers the file content from one synchronous capture, without relying on a temporary provider download URL.
Enable Screenshotone in Metorial. In your Metorial portal, enable the Screenshotone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Screenshotone tools.
Enable Screenshotone in Metorial. In your Metorial portal, enable the Screenshotone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Screenshotone tools.
Enable Screenshotone in Metorial. In your Metorial portal, enable the Screenshotone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Screenshotone tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Screenshotone in Metorial. In your Metorial portal, enable the Screenshotone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Screenshotone tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Screenshotone in Metorial. In your Metorial portal, enable the Screenshotone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Screenshotone tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Screenshotone through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Screenshotone and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Screenshotone tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Capture website screenshots, render HTML/Markdown to images or PDFs, and extract page metadata. Supports full-page and element-level screenshot capture in multiple formats (PNG, JPEG, WebP, GIF, PDF, and more). Emulate devices and viewports, block ads/cookie banners/chat widgets, inject custom JavaScript/CSS, and customize rendering with dark mode, geolocation, and proxy-based geo-targeting. Generate PDFs with configurable paper size, orientation, and margins. Extract metadata including Open Graph tags, fonts, favicons, and page content. Upload screenshots directly to S3-compatible storage. Download rendered image, PDF, HTML, or Markdown files directly from one capture. Integrate with OpenAI Vision for prompt completions on captured screenshots. Track API usage programmatically.
Frequently asked questions
Common questions about connecting Screenshotone to AI agents with Metorial.
How many tools does the Screenshotone MCP server have?
The Screenshotone MCP server exposes 6 tools, including Analyze Page with Vision, Get Usage, Generate PDF. Each one is governed and traced through Metorial.
Does the Screenshotone MCP server support triggers?
Screenshotone exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Screenshotone MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Screenshotone MCP server through the same Metorial URL.
How do I give only some teams access to Screenshotone?
Use role-based access control to decide which teams, users, and agents can use Screenshotone and which of its tools they can call.
Can I self-host the Screenshotone MCP server?
Yes. Metorial is open source, so you can run the Screenshotone MCP server yourself or use the hosted gateway.
Connect Screenshotone to production AI agents
See how Metorial gives your team governed access to Screenshotone, with tracing and security controls built in.