# Urlbox MCP

> Urlbox is your professional MCP for capturing and auditing web visuals. It lets your agent take pixel-perfect screenshots of any URL—from standard desktop views to mobile layouts and high-resolution retina captures. You can also generate a clean, shareable PDF document of an entire website page, making it ideal for QA testing, design reviews, or archiving dynamic content without ever touching a browser's developer tools.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** screenshots, web-rendering, pdf-generation, automation, high-fidelity

## Description

Running web visual checks used to be a pain—you needed multiple tabs open and specialized software just to get proof that a site looked right on different devices. Now, you can hand the entire process off to your agent using this MCP. Your AI client handles all the complexity: it captures high-fidelity images of specific sections or renders entire pages top-to-bottom. Need to check how a landing page looks on an iPhone? Just ask for a mobile capture. Want proof for a design pitch? You can generate a professional PDF from any site. This means whether you're doing visual QA or building out content archives, your agent acts as the rendering engine. By connecting this MCP through Vinkius, you keep all your web data and metadata centralized, letting you focus on the audit results instead of the clicks.

## Tools

### get_metadata
Retrieves basic information like titles and descriptions for a given URL without generating an image.

### generate_pdf
Converts the entire content of a specified web page into a professional PDF document.

### take_full_page_screenshot
Captures an image that shows every bit of content on a URL, scrolling from top to bottom.

### take_mobile_screenshot
Takes a screenshot simulating the view and layout of the website on a smartphone screen.

### take_retina_screenshot
Retrieves an ultra-high-resolution image suitable for professional design critique.

### take_screenshot
Captures a standard PNG screenshot of the visible area of a specific URL.

## Prompt Examples

**Prompt:** 
```
Render a high-fidelity screenshot of https://vinkius.com.
```

**Response:** 
```
I've rendered the screenshot! You can access the pixel-perfect image via the provided URL. Would you like a retina version or a mobile layout capture as well?
```

**Prompt:** 
```
Take a mobile screenshot of https://github.com.
```

**Response:** 
```
Mobile capture initiated! I've retrieved the image showing how GitHub renders on a smartphone. Would you like to compare it with a desktop retina capture?
```

**Prompt:** 
```
Convert https://www.bbc.com into a PDF.
```

**Response:** 
```
Conversion complete! I've generated a professional PDF of the BBC homepage. You can download the document using the provided URL. Would you like me to capture any other site?
```

## Capabilities

### Capture standard website images
Takes a basic PNG screenshot of any specific URL.

### Audit full-page content
Captures the complete, scrollable view of an entire web page from top to bottom.

### Verify mobile responsiveness
Generates a screenshot using specific mobile user agents, showing how the site appears on a phone.

### Get high-resolution design proofs
Retrieves super-high-fidelity retina screenshots for professional visual audits.

### Convert pages to documents
Turns the content of a web page into a single, clean PDF file ready for sharing.

### Extract basic site data
Retrieves essential metadata about a given URL without rendering an image.

## Use Cases

### Checking a new homepage layout
The designer asks their agent, 'Show me the full-page view of the staging site and also give me a mobile version.' The agent uses `take_full_page_screenshot` and `take_mobile_screenshot` to provide two different, accurate visual proofs in one go.

### Documenting an old website
The operations lead needs to archive a site that is going offline. They ask the agent to 'Convert this entire URL into a PDF.' The agent uses `generate_pdf` and delivers a single, professional document for records.

### Verifying branding consistency
The QA specialist needs proof that the main product page looks identical across different resolutions. They use `take_retina_screenshot` to generate an ultra-high-res image suitable for a strict design audit.

### Initial content validation
Before rendering any images, the agent first runs `get_metadata` on suspicious URLs. This confirms if the site exists and provides basic data points (like titles) before committing to a lengthy render process.

## Benefits

- Stop manually capturing screenshots. You can use `take_mobile_screenshot` or `take_full_page_screenshot` to prove responsive design works across every screen size instantly.
- Never lose content context again. Instead of just a small PNG, use `generate_pdf` to archive the whole site as one clean document for easy sharing and offline reading.
- Get superior visual proof for clients or stakeholders using `take_retina_screenshot`. This delivers image quality far beyond standard screen captures.
- Audit sites quickly without needing full browser access. The `get_metadata` tool lets your agent pull basic data points about a URL first, saving render time.
- Streamline QA testing by having your agent automatically compare views using multiple tools like `take_screenshot` and `take_mobile_screenshot`, all in one conversation.

## How It Works

The bottom line is that you get accurate visual records and structured data without needing to manually click through browser settings.

1. Subscribe to this MCP and provide your Urlbox API Key.
2. Tell your AI client the specific action you need (e.g., 'Take a mobile screenshot of X URL').
3. The agent executes the render, returning the image link or PDF file for immediate use.

## Frequently Asked Questions

**How does Urlbox MCP handle mobile testing?**
You use the `take_mobile_screenshot` tool. This simulates a phone view using specific user agents, so you get an accurate image of how your site looks on a smartphone without needing to physically browse it.

**Can Urlbox MCP turn multiple pages into one file?**
The `generate_pdf` tool converts a single URL's content into a professional PDF. To handle many pages, you would need to loop through the URLs and run this conversion for each one.

**Is take_retina_screenshot better than take_screenshot?**
Yes, `take_retina_screenshot` is designed for professional design audits. It provides a much higher pixel density image compared to the standard capture, which is crucial when verifying fine details.

**Does Urlbox MCP just give me an image link?**
It gives you multiple outputs depending on what you ask for. For instance, if you request a PDF, it returns a downloadable file; if you only ask for metadata, you get structured data back.

**What is the best way to audit a website with Urlbox MCP?**
Start by running `get_metadata` to check basic info. Then, follow up with both `take_full_page_screenshot` and `take_mobile_screenshot` to get comprehensive visual coverage.