REST API v1 & Streamable HTTP MCP
RenderHub API & MCP Documentation
Base URL: https://render.softwarehub.vn · Authenticate using Authorization: Bearer rh_live_...,
X-API-Key: rh_live_..., or ?api_key=rh_live_.... Every successful render deducts 1 credit and returns X-Credits-Remaining.
1. HTML or URL to PDF
POST /v1/pdf → returns application/pdf
{
"html": "<h1>Invoice</h1>", // or "url": "https://example.com"
"format": "A4", // A4 | Letter | Legal | Tabloid
"landscape": false,
"printBackground": true,
"margin": { "top": "12mm", "right": "12mm", "bottom": "12mm", "left": "12mm" },
"headerHtml": "<div style='font-size:10px'>Header</div>",
"footerHtml": "<div style='font-size:10px'>Page <span class='pageNumber'></span></div>"
}
2. Clean Website Screenshot
POST /v1/screenshot → returns image/png or image/jpeg
{
"url": "https://example.com", // or "html": "..."
"width": 1280, // 320 - 1920
"height": 800, // 240 - 1440
"fullPage": false,
"type": "png", // png | jpeg
"quality": 85, // 10 - 100 (jpeg only)
"deviceScaleFactor": 1, // 1 | 2
"blockBanners": true, // removes cookie/GDPR popups
"darkMode": false
}
3. Dynamic Open Graph Image (1200×630 PNG)
GET /v1/og or POST /v1/og → cached 10 minutes, returns image/png
GET https://render.softwarehub.vn/v1/og?title=Release+v2.4&subtitle=2x+faster+rendering&badge=Changelog&theme=dark&accent=%236366f1&brand=Acme&api_key=rh_live_YOUR_KEY
Supported themes: dark, light, gradient, terminal.
4. Native MCP Server (Claude Desktop, Cursor, n8n & AI Agents)
Endpoint: POST https://render.softwarehub.vn/mcp (Streamable HTTP JSON-RPC 2.0, protocol 2025-03-26).
capture_screenshot
Captures clean PNG with cookie banners removed; returns base64 image block.
render_pdf
Converts HTML or URL to PDF; returns base64 PDF resource + 5-min download link.
generate_og_image
Renders 1200×630 social PNG card for blogs, launches, and reports.
{
"mcpServers": {
"renderhub": {
"type": "http",
"url": "https://render.softwarehub.vn/mcp",
"headers": {
"Authorization": "Bearer rh_live_YOUR_API_KEY"
}
}
}
}