English Français العربية

Urlbox

Official registry Productivity

Screenshots, PDFs, video, markdown and page data from any website, via Urlbox.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http urlbox 'https://api.urlbox.com/mcp' --header 'Authorization: <Optional if your client signs in with OAuth. Otherwise '\''Bearer <key>'\'' with a Urlbox organisation API key or project secret key.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "urlbox": {
            "type": "http",
            "url": "https://api.urlbox.com/mcp",
            "headers": {
                "Authorization": "<Optional if your client signs in with OAuth. Otherwise 'Bearer <key>' with a Urlbox organisation API key or project secret key.>"
            }
        }
    }
}
NPM package @urlbox/screenshot-mcp
Claude Code 
claude mcp add urlbox -e 'URLBOX_API_KEY=<your urlbox_api_key>' -e 'URLBOX_DOWNLOAD_DIR=<URLBOX_DOWNLOAD_DIR>' -- npx -y @urlbox/screenshot-mcp@2.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "urlbox": {
            "command": "npx",
            "args": [
                "-y",
                "@urlbox/screenshot-mcp@2.0.0"
            ],
            "env": {
                "URLBOX_API_KEY": "<your urlbox_api_key>",
                "URLBOX_DOWNLOAD_DIR": "<URLBOX_DOWNLOAD_DIR>"
            }
        }
    }
}

Environment variables

  • URLBOX_API_KEY required secret Urlbox organisation API key (all tools) or project secret key (rendering tools).
  • URLBOX_DOWNLOAD_DIR Folder where save_render saves files. Defaults to ~/Downloads.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Urlbox Screenshot MCP Server
  2. Use the hosted server (recommended)
  3. Local bridge (this package)
  4. Upgrading from 1.x
  5. Example prompts
  6. Development
  7. License

Urlbox Screenshot MCP Server

Give your AI assistant a real browser for website screenshots. The Urlbox MCP server takes screenshots, makes PDFs and videos, extracts HTML, markdown and article text, compares pages, and manages your Urlbox projects, webhooks and usage.

Connect your client to https://api.urlbox.com/mcp. Nothing to install.

  • Claude (claude.ai and desktop): Settings, Connectors, Add custom connector, enter https://api.urlbox.com/mcp, then sign in to Urlbox.
  • ChatGPT: add a connector with the URL https://api.urlbox.com/mcp, then sign in to Urlbox.
  • Claude Code: claude mcp add --transport http urlbox https://api.urlbox.com/mcp, then run /mcp to sign in.
  • Codex: codex mcp add urlbox --url https://api.urlbox.com/mcp, then codex mcp login urlbox to sign in.
  • Cursor: add this to ~/.cursor/mcp.json:
    {
  "mcpServers": {
    "urlbox": {
      "url": "https://api.urlbox.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_URLBOX_API_KEY" }
    }
  }
}

Clients that can't sign in can send an API key as Authorization: Bearer <key>. An organisation API key (ubx_org_...) unlocks every tool. A project secret key works for the rendering tools only. Find your keys in the Urlbox dashboard.

Local bridge (this package)

Some clients can only start local servers. This package is a small local bridge: it runs on your machine over stdio and forwards everything to the hosted server, so you get exactly the same tools, always up to date.

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

Requires Node.js 20 or later.

VariableDescription
URLBOX_API_KEYYour organisation API key or project secret key.
SECRET_KEYAlso accepted, for configs written for 1.x. URLBOX_API_KEY wins if both are set.
URLBOX_DOWNLOAD_DIRWhere save_render saves files. Defaults to ~/Downloads.

The bridge adds one local tool, save_render, which downloads a render URL returned by any Urlbox tool and saves it to your computer. Just ask, for example "screenshot example.com and save it to my computer". Existing files are never overwritten.

Upgrading from 1.x

Your existing config keeps working: SECRET_KEY is still read and the package name and command are unchanged.

  • Tools now come from the hosted server, so there are many more of them, and they keep improving without an update.
  • render is still there. Its store_renders option and the download tool are replaced by save_render.
  • Files are saved to ~/Downloads instead of ~/Downloads/urlbox-renders. Set URLBOX_DOWNLOAD_DIR to keep the old location.
  • With a project secret key you get the rendering tools. Use an organisation API key to also manage projects, webhooks and usage.
  • Node.js 20 or later is required.

Example prompts

Development

npm install
npm test

The tests run the bridge against a local fake server, so they need no Urlbox account.

License

MIT

Frequently asked questions

What is Urlbox?

Screenshots, PDFs, video, markdown and page data from any website, via Urlbox.

How do I install Urlbox?

It runs as a remote server. In Claude Code: claude mcp add --transport http urlbox 'https://api.urlbox.com/mcp' --header 'Authorization: <Optional if your client signs in with OAuth. Otherwise '\''Bearer <key>'\'' with a Urlbox organisation API key or project secret key.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Urlbox need an API key?

Yes. It expects URLBOX_API_KEY, Authorization, which you set in its configuration.

Is Urlbox open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Urlbox?

It is published by urlbox. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.