Skip to main content
Glama
Rendershot

@rendershot/mcp-server

Official
by Rendershot

@rendershot/mcp-server

Model Context Protocol (MCP) server for the Rendershot screenshot and PDF generation API. Lets AI agents (Claude, Cursor, etc.) capture screenshots and generate PDFs directly as tool calls.

Source: github.com/Rendershot/rendershot-mcp-server

Quick start

No installation needed — run with npx:

RENDERSHOT_API_KEY=your_key npx @rendershot/mcp-server

Related MCP server: MCP Browser Screenshot Server

Claude Desktop setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rendershot": {
      "command": "npx",
      "args": ["-y", "@rendershot/mcp-server"],
      "env": {
        "RENDERSHOT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor / VS Code setup

Add to your MCP settings:

{
  "rendershot": {
    "command": "npx",
    "args": ["-y", "@rendershot/mcp-server"],
    "env": {
      "RENDERSHOT_API_KEY": "your_api_key_here"
    }
  }
}

Environment variables

Variable

Required

Default

Description

RENDERSHOT_API_KEY

Yes

Your Rendershot API key

RENDERSHOT_BASE_URL

No

https://api.rendershot.io

API base URL (override for self-hosting)

Tools

take_screenshot

Capture a screenshot of a URL or HTML string. Returns a base64-encoded image.

Parameter

Type

Default

Description

url

string

Page URL to screenshot (one of url/html required)

html

string

Raw HTML to render (one of url/html required)

format

png | jpeg

png

Output image format

quality

1–100

85

JPEG quality (ignored for PNG)

viewport_width

1–3840

1280

Viewport width in pixels

viewport_height

1–2160

720

Viewport height in pixels

full_page

boolean

false

Capture the full scrollable page

wait_for

string

dom_content_loaded

load | dom_content_loaded | network_idle | commit | CSS selector

delay_ms

0–10000

0

Extra delay after page load (ms)

ai_cleanup

fast | thorough

Remove cookie banners/popups before capture. fast uses JS heuristics (1 credit); thorough adds an LLM pass (3 credits)

headers

{ [name]: value }

Custom HTTP headers sent with the render request. Max 30, values ≤ 2 KB. Host / Cookie / Content-Length / Sec-* / Connection rejected

cookies

array

Session cookies to inject. Each needs name, value, and one of domain / url. Optional: path, expires, http_only, secure, same_site (Lax | Strict | None). Max 50

basic_auth

{ username, password }

HTTP Basic auth. Sent on 401 challenge

generate_pdf

Generate a PDF from a URL or HTML string. Returns the PDF as a base64-encoded string.

Parameter

Type

Default

Description

url

string

Page URL (one of url/html required)

html

string

Raw HTML (one of url/html required)

format

A3 | A4 | Letter | Legal

A4

Paper size

orientation

portrait | landscape

portrait

Page orientation

print_background

boolean

true

Print background graphics/colors

wait_for

string

dom_content_loaded

Same as screenshot

delay_ms

0–10000

0

Extra delay after page load (ms)

ai_cleanup

fast | thorough

Same as screenshot

headers

{ [name]: value }

Same as screenshot

cookies

array

Same as screenshot

basic_auth

{ username, password }

Same as screenshot

bulk_render

Submit up to 20 screenshot or PDF jobs in one call. All jobs run in parallel and results include base64 output per job.

Parameter

Type

Description

jobs

array (1–20)

Array of job objects, each with type: "screenshot" or type: "pdf" plus the same fields as the individual tools

Returns a JSON object with credits_used, credits_remaining, and a results array containing index, result (base64), and any error per job.

check_balance

Check remaining API credits and plan details. No parameters.

Notes

  • All render calls use async mode internally and poll until the job completes (up to 5 minutes).

  • Screenshots return MCP image content — agents can display them inline.

  • PDFs return base64-encoded text; agents can save them to disk or pass them on.

  • Errors from the API (rate limits, credit exhaustion, invalid URLs) surface as MCP errors with the original error code.

Requirements

  • Node.js 18+

License

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Rendershot/rendershot-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server