# oJo — HTML to image and PDF

> oJo — HTML to image and PDF is a freemium MCP server for files and documents. Turn HTML templates and JSON into hosted PDF or PNG links, with free live previews. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://ojo.so/docs/mcp-server
- **Repository:** https://github.com/ojodotso/mcp-server
- **MCP Registry name:** so.ojo/mcp-server
- **Categories:** files and documents, design and media
- **Listing updated:** 2026-11-14

## About

The design loop is the selling point. An agent can iterate on a layout through free, full-resolution previews and spend a credit only on the frame that is right. create_preview_link gzips the draft into the URL hash, so nothing reaches a server and the link can be shared with a human reviewer. For PDFs the preview shows the screen rendering, not page breaks.

Without an API key the local server runs in preview-only mode with just that one tool, needing no account. With a key it adds rendering of HTML or a saved template to a PNG (1 credit) or a PDF of up to 100 pages (1 credit per 20 pages), plus listing, reading, creating and updating templates. update_template overwrites, so API renders use the new version at once.

The remote server at https://mcp.ojo.so/mcp signs you in with an oJo account, which includes 30 free credits for 30 days with no card. The local @ojodotso/mcp-server package needs Node.js 20 or newer and suits CI and headless machines. A guiding prompt, author_ojo_template, teaches the Handlebars helpers.

## Features

- **Free live previews:** create_preview_link renders a draft at full resolution with no account and no credit cost.
- **HTML to PNG:** generate_image_from_html returns a public PNG URL for 1 credit.
- **HTML to PDF:** generate_pdf_from_html makes PDFs of up to 100 pages, at 1 credit per 20 pages.
- **Template rendering:** Render a saved template and override variables with modify.
- **Template management:** List, fetch, create and update reusable Handlebars templates.
- **Local or remote:** Use the hosted OAuth server or the npm stdio package.

## Good for

- Generate social cards or invoices from JSON data
- Let an agent refine a layout before paying for a render
- Produce multi-page PDFs from several templates
- Render images in CI without a browser sign-in
- Reuse one template across automation tools such as n8n

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://mcp.ojo.so/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.ojo.so/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.ojo.so/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.ojo.so/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.ojo.so/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.ojo.so/mcp"
    }
  }
}
```

## Tools

- `create_preview_link`: Builds a free full-resolution preview link for an HTML or Handlebars draft.
- `generate_image_from_html`: Renders HTML to a PNG and returns its public URL.
- `generate_image_from_template`: Renders an existing template to a PNG, with optional variable overrides.
- `generate_pdf_from_html`: Renders HTML to a PDF of up to 100 pages.
- `generate_pdf_from_template`: Renders a template, or several, to a PDF.
- `list_templates`: Lists the account's templates.
- `get_template`: Fetches a template's HTML and variable defaults.
- `create_template`: Creates a reusable template from HTML or Handlebars.
- `update_template`: Replaces a template's HTML under the same ID.

## FAQ

### Do I need an account to try it?

No. Without OJO_API_KEY the local server runs in preview-only mode with free, unlimited previews.

### What does a render cost?

A PNG costs 1 credit and a PDF costs 1 credit per 20 pages; previews are free.

### Are there free credits?

Signing in creates an account with 30 free credits for 30 days, no card.

### What are the requirements for the npm package?

Node.js 20 or newer; npx fetches it on first run.

### Is oJo — HTML to image and PDF free?

oJo — HTML to image and PDF has a free plan, with paid plans for more usage or features.

### How do I add oJo — HTML to image and PDF to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.ojo.so/mcp

### What are the best alternatives to oJo — HTML to image and PDF?

The closest alternatives to oJo — HTML to image and PDF are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/ojo-html-to-image-and-pdf
