docjet-mcp

docjet-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: docjet on npm
• Support: [e-mail]

License

MIT