oJo — HTML to image and PDF
Turn HTML templates and JSON into hosted PDF or PNG links, with free live previews
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.ojo.so/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.ojo.so/mcp"
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media