MCP 服务器

rendoc

Generate professional PDFs from Claude, Cursor, and other AI tools. Create invoices, contracts, reports, and certificates from templates or inline HTML markup.

README

@rendoc/mcp-server

The rendoc MCP server lets AI assistants like Claude Desktop, Cursor, and any other MCP-compatible client generate professional PDF documents on demand. Connect your AI to rendoc and it can create invoices, contracts, reports, certificates, and any other PDF — from reusable templates or inline HTML/Handlebars markup — all from a natural language prompt.

Turn "Generate an invoice for Acme Corp, 40 hours of consulting at €85/h" into a delivered PDF in seconds.

Use Cases

Use Case	Example Prompt
Invoices	"Generate an invoice for client X with these line items..."
Contracts	"Draft a freelance contract for TechStart SL, €18,000 fee, 50% upfront..."
Certificates	"Issue a course completion certificate for María González..."
Reports	"Create a March 2026 sales report with these KPIs..."
Bulk generation	"Generate certificates for all 50 attendees in this CSV"
Custom documents	Anything you can describe in HTML + data

See detailed walkthroughs in examples/.

Features

7 tools for document generation, template management, and usage tracking
Template-based or inline — save reusable templates or pass markup on the fly
Handlebars syntax — use {{variables}}, {{#each}}, {{#if}} in your markup
Multiple paper sizes — A4, Letter, Legal, A3, A5, portrait or landscape
Schema validation — templates can declare a JSON Schema so the AI can't pass invalid data
Zero config — just set RENDOC_API_KEY and go
Lightweight — ~35 KB unpacked, pure TypeScript, only 2 runtime dependencies
Verified on Glama — security, quality, and license checks passed

Quick Setup for Claude Desktop

Add this to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "rendoc": {
      "command": "npx",
      "args": ["-y", "@rendoc/mcp-server"],
      "env": {
        "RENDOC_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop. The rendoc tools will appear in the MCP tools menu.

Quick Setup for Claude Code

Add this to your project or global settings (.claude/settings.json):

{
  "mcpServers": {
    "rendoc": {
      "command": "npx",
      "args": ["-y", "@rendoc/mcp-server"],
      "env": {
        "RENDOC_API_KEY": "your-api-key"
      }
    }
  }
}

Quick Setup for Cursor

Add to ~/.cursor/mcp.json (or your project's .cursor/mcp.json):

{
  "mcpServers": {
    "rendoc": {
      "command": "npx",
      "args": ["-y", "@rendoc/mcp-server"],
      "env": {
        "RENDOC_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Tool	Description	Key Parameters
`generate_document`	Generate a PDF from a template or inline markup	`template_id` or `markup`, `data`, `paper_size?`, `orientation?`, `filename?`
`list_templates`	List available document templates	`category?`
`preview_template`	Inspect a template's markup, styles, and schema	`template_id`
`create_template`	Create a new reusable template	`name`, `slug`, `markup`, `schema`, `category?`, `styles?`, `sample_data?`, `paper_size?`, `orientation?`, `is_public?`
`delete_template`	Delete a template by ID	`template_id`
`get_document`	Get details of a generated document	`document_id`
`get_usage`	View monthly API usage statistics	(none)

Each tool returns structured JSON with download URLs, document IDs, and metadata the assistant can act on.

Get an API Key

Sign up at rendoc.dev
Go to the API Keys dashboard
Create a new key and copy it into your MCP client config

Environment Variables

Variable	Required	Default	Description
`RENDOC_API_KEY`	Yes	—	Your rendoc API key for authentication
`RENDOC_API_URL`	No	`https://rendoc.dev`	Base URL for the rendoc API (useful for self-hosted instances)

Examples

Detailed walkthroughs with real prompts and tool calls:

01 — Invoice from inline markup — single-shot invoice generation
02 — Freelance contract template — create once, reuse forever
03 — Certificate from saved template — multi-step tool discovery
04 — Monthly sales report — rich visualizations with CSS
05 — Bulk generation from dataset — 50 PDFs from one prompt

How It Works

┌──────────────┐   MCP/stdio    ┌────────────────────┐   HTTPS   ┌─────────────┐
│ Claude Code  │ ─────────────▶ │ @rendoc/mcp-server │ ────────▶ │ rendoc API  │
│ / Desktop    │                │   (this package)    │           │  (PDF gen)  │
└──────────────┘ ◀───────────── └────────────────────┘ ◀──────── └─────────────┘
        ▲         tool results                        download URL
        │
        └── User prompt: "Generate an invoice for..."

The MCP server translates natural language tool calls from your AI assistant into authenticated REST requests to the rendoc API, and returns structured responses with PDF download URLs.