docs(mcp): add Rendex MCP Server extension tutorial (#8541)

Signed-off-by: DanE <daniel@nexgroup.info>
2026-04-16 11:11:46 -07:00
parent e7a91c7d4f
commit 0766d34237
2 changed files with 154 additions and 0 deletions
@@ -0,0 +1,134 @@
+---
+title: Rendex Extension
+description: Add Rendex MCP Server as a goose Extension for Screenshots, PDFs, and HTML-to-Image Rendering
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller';
+import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions';
+
+This tutorial covers how to add the [Rendex MCP Server](https://github.com/copperline-labs/rendex-mcp) as a goose extension to capture screenshots, generate PDFs, and render HTML to images from any webpage or raw HTML — useful for archiving UIs, generating invoices and reports, producing OG images, and giving goose a reliable "see the web" capability without spinning up a full browser automation stack.
+
+## Configuration
+
+:::tip Quick Install
+<Tabs groupId="interface">
+  <TabItem value="ui" label="goose Desktop" default>
+  [Launch the installer](goose://extension?type=streamable_http&url=https%3A%2F%2Fmcp.rendex.dev%2Fmcp&id=rendex&name=Rendex&description=Capture%20screenshots%2C%20generate%20PDFs%2C%20and%20render%20HTML%20to%20images%20via%20AI%20agents&header=Authorization%3DBearer%20YOUR_RENDEX_API_KEY)
+  </TabItem>
+  <TabItem value="cli" label="goose CLI">
+  Add a `Remote Extension (Streaming HTTP)` extension type with:
+
+  **Endpoint URL**
+  ```
+  https://mcp.rendex.dev/mcp
+  ```
+  </TabItem>
+</Tabs>
+
+  **Custom Request Header**
+  ```
+  Authorization: Bearer <YOUR_RENDEX_API_KEY>
+  ```
+:::
+
+<Tabs groupId="interface">
+  <TabItem value="ui" label="goose Desktop" default>
+    <GooseDesktopInstaller
+      extensionId="rendex"
+      extensionName="Rendex"
+      description="Capture screenshots, generate PDFs, and render HTML to images via AI agents"
+      type="http"
+      url="https://mcp.rendex.dev/mcp"
+      envVars={[
+        { name: "Authorization", label: "Bearer YOUR_RENDEX_API_KEY" }
+      ]}
+      apiKeyLink="https://rendex.dev/dashboard/keys"
+      apiKeyLinkText="Rendex API key"
+    />
+  </TabItem>
+
+  <TabItem value="cli" label="goose CLI">
+    <CLIExtensionInstructions
+      name="Rendex"
+      description="Capture screenshots, generate PDFs, and render HTML to images via AI agents"
+      type="http"
+      url="https://mcp.rendex.dev/mcp"
+      timeout={300}
+      envVars={[
+        { key: "Authorization", value: "Bearer rdx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }
+      ]}
+      infoNote={
+        <>
+          Obtain your <a href="https://rendex.dev/dashboard/keys" target="_blank" rel="noopener noreferrer">Rendex API key</a> and paste it in as the <code>Bearer</code> token. Free tier includes 500 calls/month, no credit card required.
+        </>
+      }
+    />
+  </TabItem>
+</Tabs>
+
+## Example Usage
+
+Let's use the Rendex extension to generate an invoice PDF from raw HTML and archive a product page.
+
+### goose Prompt
+
+```
+1. Render this HTML as an A4 PDF with 1cm margins:
+
+   <!doctype html>
+   <html>
+     <body style="font-family: system-ui; padding: 40px;">
+       <h1>Invoice #0042</h1>
+       <p>Bill to: Acme Corp</p>
+       <table>
+         <tr><td>MCP server listing</td><td>$500.00</td></tr>
+         <tr><td>Total</td><td><b>$500.00</b></td></tr>
+       </table>
+     </body>
+   </html>
+
+2. Then take a full-page screenshot of https://news.ycombinator.com in dark mode
+
+3. Return both results so I can save them
+```
+
+### goose Output
+
+```
+I'll generate the invoice PDF first, then capture the HN page.
+
+[rendex_screenshot: format=pdf, pdfFormat=A4, pdfMargin={top: 1cm, ...}, html=<invoice markup>]
+✓ PDF captured successfully (12,344 bytes)
+  width: 1280  height: 800  capturedAt: 2026-04-15T12:34:56Z
+
+[rendex_screenshot: url=https://news.ycombinator.com, fullPage=true, darkMode=true]
+✓ Screenshot captured (PNG, 847KB)
+  width: 1280  height: 4,321  waitStrategy: networkidle2
+
+Both renders completed. You have:
+  1. Invoice PDF (A4, 12.3KB) — base64 in result 1
+  2. Dark-mode full-page screenshot of Hacker News (PNG, 847KB) — base64 in result 2
+```
+
+## Pricing
+
+Rendex is free to try — no credit card required for the free tier.
+
+| Plan | Calls/Month | Rate limit |
+|---|---|---|
+| Free | 500 | 10/min |
+| Starter | 10,000 | 60/min |
+| Pro | 100,000 | 300/min |
+| Enterprise | Custom | 1,000/min |
+
+Get an API key at [rendex.dev](https://rendex.dev).
+
+## Links
+
+- **Website**: [rendex.dev](https://rendex.dev)
+- **GitHub**: [copperline-labs/rendex-mcp](https://github.com/copperline-labs/rendex-mcp)
+- **npm**: [`@copperline/rendex-mcp`](https://www.npmjs.com/package/@copperline/rendex-mcp)
+- **Smithery**: [smithery.ai/server/copperline/rendex-mcp](https://smithery.ai/server/copperline/rendex-mcp)
+- **Official MCP Registry**: `io.github.copperline-labs/rendex-mcp`
@@ -633,6 +633,26 @@
      }
    ]
  },
+  {
+    "id": "rendex-mcp",
+    "name": "Rendex",
+    "description": "Capture screenshots, generate PDFs, and render HTML to images via AI agents",
+    "url": "https://mcp.rendex.dev/mcp",
+    "link": "https://github.com/copperline-labs/rendex-mcp",
+    "installation_notes": "This is a remote extension that requires a Rendex API key from https://rendex.dev/dashboard/keys as a Request Header e.g Authorization: Bearer <YOUR_RENDEX_API_KEY>. Free tier includes 500 calls/month, no credit card required.",
+    "is_builtin": false,
+    "endorsed": false,
+    "environmentVariables": [],
+    "headers": [
+      {
+        "name": "Authorization",
+        "description": "Bearer <YOUR_RENDEX_API_KEY>",
+        "required": true
+      }
+    ],
+    "show_install_command": false,
+    "type": "streamable-http"
+  },
  {
    "id": "repomix-mcp",
    "name": "Repomix",