# urlbox/urlbox-mcp-server [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/urlbox/urlbox-mcp-server/  
**GitHub Stars:** 4  
**npm Downloads (last month):** 93  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/urlbox-urlbox-mcp-server

## Description
A reliable MCP server for generating and managing screenshots, PDFs, and videos, performing AI-powered screenshot analysis, and extracting web content (Markdown, metadata, and HTML) via the Urlbox API.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "urlbox-mcp-server": {
    "command": "npx",
    "args": ["-y","@urlbox/screenshot-mcp"],
    "env": {
      "SECRET_KEY": ""
    }
  }
}
```

**Requires environment variables:** `SECRET_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# Urlbox MCP Server

[![image](https://github.com/urlbox/urlbox-mcp-server/blob/HEAD/urlbox-graphic.jpg)](https://www.urlbox.com)

MCP server for the [Urlbox](https://urlbox.com) Screenshot API. Enables your client to take screenshots, generate PDFs, extract HTML/markdown, and more from websites.

Visit [Urlbox](https://urlbox.com) for more information, and have a read of our [docs](https://urlbox.com) or chat with your LLM post install to get a good understanding of its options and capabilities.

[![MCP Badge](https://evanth.io/badge/mcp/urlbox-screenshot-mcp)](https://evanth.io/mcp/urlbox-screenshot-mcp)

## Setup

1. **Install dependencies and build:**
 
   ```bash
   npm install
   npm run build
   ```

2. **Get Urlbox API credentials:**
   - Sign up at [urlbox.com](https://urlbox.com)
   - Get your API Secret from the [ dashboard ](https://urlbox.com/dashboard)

3. **Set environment variables:**

> claude_desktop_config.json

```JSON 
{
  "mcpServers": {
    "screenshot": {
      "command": "npx",
      "args": ["-y", "@urlbox/screenshot-mcp"],
      "env": {
        "SECRET_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Usage

The server provides a `render` tool that can:
- Take screenshots in multiple formats (PNG, PDF, MP4 and more)
- Convert pages to HTML, markdown
- Extract metadata and cookies
- Save files locally to your downloads with `store_renders: true`

Claude will automatically use this when you ask it to screenshot websites or convert web content.


## Useful prompts

**Take a clean screenshot without ads or cookie banners:**
```
Take a screenshot of https://example.com but block ads and hide cookie banners
```

**Screenshot and save side renders like HTML/markdown:**
```
Take a screenshot of https://example.com and also save it as HTML and markdown. Download the result to my computer.
```

**Generate a PDF of the full page:**
```
Convert https://urlbox.com to a PDF and save it to my computer. Make sure to generate a PDF that has an outline and is tagged.
```