Skip to content
MCP server

oJo — HTML to image and PDF

Turn HTML templates and JSON into hosted PDF or PNG links, with free live previews

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.9.0
Listing updated
3 days ago

About oJo — HTML to image and PDF

oJo — HTML to image and PDF is a freemium MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.ojo.so/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.ojo.so/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • OJO_API_KEYoJo API key — create one at https://ojo.so/dashboard/api. Optional: without it the server runs in preview-only mode, where create_preview_link renders free full-resolution previews with no account.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free previews; 30 free credits for 30 days; renders use credits, price per credit not listed

Prices change. Check ojo.so before you buy.

oJo — HTML to image and PDF 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 to oJo — HTML to image and PDF

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media