# Urlbox MCP > Urlbox lets you render live websites into high-quality PNGs, JPEGs, and PDFs using a cloud API. This MCP handles complex responsive layouts and dynamic content so your agent can generate exact visual proofs of any public URL or raw HTML code base in multiple formats. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** screenshot-api, pdf-generation, web-rendering, html-to-image, automation, headless-browser ## Description Need to prove what a webpage looks like? This connection lets your AI client capture it visually. You feed it a URL, and the system returns flawless screenshots—PNGs, JPEGs, WebPs—no matter how complicated the site's layout is. If you need a full document backup, it handles converting entire pages to customized PDFs. Developers can also use this MCP to test raw code snippets by rendering HTML directly into images, or they can focus on just one area using CSS selectors. It’s about getting perfect visual assets without leaving your agent flow. Since Vinkius is the #1 catalog for these kinds of tools, you get access right here, letting your agent handle everything from checking usage stats to running complex renders in a single chat session. ## Tools ### get_account_info Retrieves basic profile information about the connected Urlbox account. ### list_proxies Provides a list of available proxy locations that can be used for rendering web pages. ### get_render_status Checks the current status of an asynchronous rendering job you started. ### get_credit_usage Retrieves your current usage statistics and remaining credit balance. ### list_storage_buckets Lists all the storage buckets associated with your account for asset management. ### list_webhooks Retrieves a list of active webhooks configured on your account. ### render_async Starts an asynchronous rendering job for a URL, and the results are sent to a specified webhook endpoint. ### render_html Converts raw HTML code directly into a rendered image file. ### capture_pdf Takes an entire live URL and converts it into a comprehensive PDF document. ### capture_png Captures a standard PNG screenshot of an entire web page or specific area. ### render_selector Renders and captures only the content matching a specific CSS selector on a live webpage. ### render_sync Performs an immediate, synchronous rendering of a URL and returns the result directly. ## Prompt Examples **Prompt:** ``` Take a high-quality screenshot of 'https://vinkius.com'. ``` **Response:** ``` Screenshot captured! I've rendered 'https://vinkius.com' as a high-quality PNG. You can view or download the image here: [Render URL]. Shall I convert this page to PDF as well? ``` **Prompt:** ``` Convert the article at 'https://example.com/blog/1' to an A4 PDF. ``` **Response:** ``` Conversion successful! I've generated an A4 PDF for the provided URL. Here is your download link: [PDF URL]. Is there anything else you'd like to capture? ``` **Prompt:** ``` Capture only the element '#pricing-table' from 'https://mysaas.com'. ``` **Response:** ``` Selective render complete! I've captured only the element matching '#pricing-table' from 'https://mysaas.com'. Here is the cropped image: [Element URL]. ``` ## Capabilities ### Capture Visual Proofs Generate instant screenshots and image files (PNG, JPG, WebP) of any public URL. ### Convert Pages to Documents Transform entire web pages into high-fidelity PDF documents with customizable page sizes. ### Isolate Specific Content Use CSS selectors to capture only a specific element, like a chart or price table, from a live webpage. ### Test Raw Code Styles Render raw HTML code directly into images for visual testing of styles or assets. ### Monitor Usage and Assets Track credit usage, list active webhooks, or check storage buckets directly through your agent. ## Use Cases ### Debugging Layouts for Clients A QA engineer needs to show a client that a specific pricing widget is misaligned. Instead of manually cropping screenshots, they ask their agent to use `render_selector` on the live page and get a perfectly cropped image of just the offending widget. ### Creating Content Backups A content creator finishes an article and wants a permanent record. They prompt their agent to use `capture_pdf` on the URL, instantly generating a professional, A4-sized PDF backup of the entire piece. ### Validating Marketing Mockups A marketing team needs visual assets for an ad campaign. They instruct their agent to use `capture_png` on three different landing pages and gather all high-quality, consistent screenshots needed for the final creative brief. ### Testing Isolated Components A developer wants to check if a new JavaScript component (like a complex graph) renders correctly. They use `render_html` by pasting the raw code, and their agent returns an image so they don't have to run it in a full browser environment. ## Benefits - Stop manual screenshots. Instead of taking a picture and hoping it captures everything, use the `capture_png` tool to guarantee you get a high-fidelity image capture of any URL. - Need legal proof that an article looked a certain way? Use `capture_pdf` to convert entire webpages into standardized PDF documents with customizable page sizes for reliable archiving. - Don't waste time on full-page captures when you only need one thing. The `render_selector` tool lets your agent focus and capture just the pricing table or a specific chart, making your assets clean and targeted. - Test frontend code without running a local server. Simply use `render_html` to turn raw HTML snippets into images so you can visually check styles in place. - Build robust pipelines by using asynchronous methods like `render_async`. This allows your agent to start a long render job now and process the result later via webhooks, without timing out. ## How It Works The bottom line is, you get reliable web rendering capabilities integrated directly into your AI workflow. 1. First, you subscribe to this MCP and enter your unique Urlbox API Key into your AI client's settings. 2. Next, you prompt your agent with the URL or HTML code you want rendered. The agent then uses the appropriate tool within the MCP to send the request to the cloud service. 3. Finally, your agent returns the captured visual asset—whether it’s a PNG file, a PDF link, or status updates—ready for you to review. ## Frequently Asked Questions **How does Urlbox handle complex websites like those with JavaScript?** It handles dynamic content because it uses a cloud API that renders the page as if a real browser were viewing it. This means you get accurate screenshots even if the site runs heavy JavaScript. **Can I capture only part of a webpage using Urlbox? What tool do I use?** Yes, you can isolate elements with precision. Use the `render_selector` tool by providing a CSS selector (like '#footer') and it will capture just that specific section. **What is the difference between `capture_png` and `capture_pdf` using Urlbox?** `capture_png` gives you an image file for a single view, perfect for ads or proofs. `capture_pdf`, however, converts the whole page into a document format, ideal for reports and archives. **Does Urlbox support large-scale rendering jobs?** Yes. For very long URLs or complex renders that might time out, use `render_async`. This starts the job in the background and you can track its status using `get_render_status`. **Is there a way to list my billing details with Urlbox MCP?** You can check your usage stats by calling the `get_credit_usage` tool. This will show you how many credits you've used and what your current balance is.