About docjet-mcp
docjet-mcp is an MCP server for rendering branded PDFs and PNGs from DocJet templates or HTML with JSON data. It is for MCP client users who need document or social-image output, returning signed download URLs.
Key features
- 01Render branded PDFs
- 02Render PNG images
- 03Use templates or raw HTML
- 04List available templates
- 05Return signed download URLs
Use cases
- 01Create invoices from template data
- 02Generate report PDFs
- 03Produce certificates
- 04Render social cards
MCP support
It exposes DocJet rendering and template-listing tools to MCP clients over stdio. Rendering tools return signed download URLs.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y docjet-mcpDOCJET_API_KEYSecretDocJet API key (get one free at https://docjet.dev — POST /v1/signup)DOCJET_BASE_URLOverride the API base URL (default: https://api.docjet.dev)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
3Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| data | object | No | Template variables (Handlebars data object) |
| html | string | No | Raw HTML to render (max 512 KB) — alternative to template_id |
| template_id | string | No | Template ID from list_templates (provide template_id OR html) |
Details
From the project READMEdocjet-mcp
MCP server for DocJet — render branded PDF documents (invoices, reports, certificates) and PNG social images directly from any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf, ...).
Send a template ID or raw HTML plus JSON data; get back a signed download URL. Runs locally over stdio via npx — nothing to host.
Quick start
Add to your MCP client configuration:
{
"mcpServers": {
"docjet": {
"command": "npx",
"args": ["docjet-mcp"],
"env": {
"DOCJET_API_KEY": "binfra_your_key_here"
}
}
}
}
Get an API key at docjet.dev. To try it without signing up, use the public demo key (rate-limited to 3 req/min, 50 renders/month, shared by everyone):
binfra_9afb57dbb6478c441ad101129fca65847f5745403f9d718b3de6d934c9b63f88
Tools
| Tool | What it does |
|---|---|
render_pdf | Render a branded PDF. Input: template_id (or raw html) + data object. Returns a signed download URL. |
render_image | Render a PNG image (e.g. OG/social card). Input: template_id (or raw html) + data object. Returns a signed download URL. |
list_templates | List available templates: id, name, description, outputType. No API key needed. |
Example prompt once connected:
"List the DocJet templates, then render the invoice-ro template with client 'Demo SRL' and total 1000 as a PDF."
Environment variables
| Variable | Required | Description |
|---|---|---|
DOCJET_API_KEY | Yes | Your DocJet API key (binfra_ prefix). Sent as a Bearer token; never logged. |
DOCJET_BASE_URL | No | Override the API base URL (default https://api.docjet.dev). |
How it works
- Stdio transport using the official
@modelcontextprotocol/sdk(v1). render_pdf→POST /v1/render?response=url,render_image→POST /v1/image?response=url,list_templates→GET /v1/templates.- Template IDs are validated locally against
^[a-z0-9][a-z0-9-]{0,63}$before any network call. - API errors surface as MCP error content with the DocJet error code (e.g.
QUOTA_EXCEEDED,RATE_LIMITED).
Links
- API docs: docjet.dev/docs
- JS/TS SDK:
docjeton npm - Support: [email protected]
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.