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"
      }
    }
  }
}