@rendshot/mcp
MCP server for RendShot — expose HTML-to-image rendering, URL screenshots, and template management as tools for AI agents.
Installation
npm install -g @rendshot/mcp
Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"rendshot": {
"command": "npx",
"args": ["-y", "@rendshot/mcp"],
"env": {
"RENDSHOT_API_KEY": "rs_live_..."
}
}
}
}
Claude Code
claude mcp add rendshot -- npx -y @rendshot/mcp
Set the API key in your environment:
export RENDSHOT_API_KEY=rs_live_...
Cursor / VS Code
Add to MCP settings:
{
"rendshot": {
"command": "npx",
"args": ["-y", "@rendshot/mcp"],
"env": {
"RENDSHOT_API_KEY": "rs_live_..."
}
}
}
Tools
| Tool | Description |
|---|---|
generate_image |
Render HTML/CSS or a template to an image |
screenshot_url |
Take a screenshot of any URL |
list_templates |
Browse published templates with filtering |
get_template |
Get template details and variable definitions |
create_template |
Create a new reusable template |
generate_image
Render HTML to an image, or use a template with variables:
"Generate an image from this HTML: <h1>Hello World</h1>"
"Use template tpl_abc123 with title='Launch Day'"
| Parameter | Type | Required | Description |
|---|---|---|---|
html |
string |
* | HTML to render (XOR with template_id) |
template_id |
string |
* | Template ID (XOR with html) |
variables |
object |
— | Template variables |
css |
string |
— | CSS styles |
width |
number |
— | Width (1–4096, default 1080) |
height |
number |
— | Height (1–4096, default 1080) |
format |
png | jpg |
— | Output format |
quality |
number |
— | JPEG quality (1–100) |
deviceScale |
1 | 2 | 3 |
— | Device pixel ratio |
screenshot_url
"Screenshot https://example.com at 1440x900"
"Take a full-page screenshot of https://github.com"
| Parameter | Type | Required | Description |
|---|---|---|---|
url |
string |
yes | URL to screenshot |
width |
number |
— | Viewport width |
height |
number |
— | Viewport height |
fullPage |
boolean |
— | Capture full page |
format |
png | jpg |
— | Output format |
list_templates
"Show me xiaohongshu templates"
"Search templates for 'blog cover'"
| Parameter | Type | Description |
|---|---|---|
platform |
string |
Filter by platform |
category |
string |
Filter by category |
q |
string |
Search query |
limit |
number |
Results per page |
get_template
"Get details for template tpl_abc123"
create_template
"Create a template named 'Blog Header' with this HTML and a title variable"
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
RENDSHOT_API_KEY |
yes | — | Your API key (rs_live_...) |
RENDSHOT_API_URL |
no | https://api.rendshot.ai |
API base URL |
License
MIT
