Pdf Generator Api

What is Pdf Generator Api?

Pdf Generator Api is a Model Context Protocol (MCP) server for the PDF Generator API, generated from its OpenAPI v4 specification. It supports both stdio mode for local MCP clients (Claude Desktop, Claude Code, Cline, etc.) and HTTP mode for production deployment, marketplaces, and multiple clients.

How to use Pdf Generator Api?

Install and build with npm install and npm run build, then configure your MCP client with the command node and the path to the built index.js, plus environment variables API_BASE_URL and BEARER_TOKEN_JWT. For HTTP mode, run npm run start:http (port 3000) or use the provided Docker Compose file. Authentication requires a JWT token passed via environment variable or HTTP header.

Key features of Pdf Generator Api

• Supports stdio and HTTP transports
• Docker deployment support
• Configurable environment variables
• JWT authentication with token generation guidance
• Session idle timeout and CORS configuration
• Health check endpoint
• Regeneratable from OpenAPI specification
• Includes testing scripts

Use cases of Pdf Generator Api

• Integrate PDF generation into Claude Desktop or Claude Code
• Deploy a production MCP server accessible by multiple clients
• Automate PDF document creation in CI/CD pipelines
• Use as a local development proxy for the PDF Generator API

FAQ from Pdf Generator Api

What authentication is required?

You need a JWT token signed with your workspace ID, workspace identifier, and secret key from the PDF Generator API dashboard. In stdio mode pass it as BEARER_TOKEN_JWT; in HTTP mode include it in the Authorization header.

How do I generate a JWT token?

Use the jsonwebtoken library (Node.js) or the jsonwebtoken-cli npx one-liner with your workspace credentials and a chosen expiration time. Example: jwt.sign({ iss: 'YOUR_WORKSPACE_ID', sub: 'YOUR_WORKSPACE_IDENTIFIER' }, 'YOUR_SECRET_KEY', { algorithm: 'HS256', expiresIn: '24h' }).

What environment variables are available?

Key variables include API_BASE_URL (default https://us1.pdfgeneratorapi.com/api/v4), BEARER_TOKEN_JWT (for stdio), PORT (HTTP, default 3000), LOG_LEVEL, SESSION_TTL_MINUTES (HTTP, default 30), and CORS_ORIGIN (HTTP, default *).

Can I run it in production?

Yes, use HTTP mode with Docker or direct start. Set CORS_ORIGIN appropriately and consider using HTTPS. JWT tokens should have a shorter TTL (e.g., 1 hour) for production.

How do I regenerate the server after API changes?

Place the updated OpenAPI spec at docs/apiv4.json and run ./scripts/generate-mcp.sh. After regeneration, custom patches may need to be re-applied.