@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

1. Sign up at rendoc.dev
2. Go to the API Keys dashboard
3. 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.

Contributing

Contributions are welcome. See CONTRIBUTING.md for development setup and PR guidelines.

For security issues, please see SECURITY.md and email [email protected] — do not open a public issue.

Links

• Website: rendoc.dev
• Docs: rendoc.dev/docs
• npm Package: @rendoc/mcp-server
• Glama Listing: glama.ai/mcp/servers/@yoryocoruxo-ai/rendoc-mcp-server
• Official SDKs: @rendoc/sdk (TypeScript), rendoc (Python)

License

MIT — see LICENSE.