The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the TemplateFox MCP Server listing page.
MCP (Model Context Protocol) server for the TemplateFox PDF generation API. Generate PDFs from templates directly through AI assistants like Claude, Cursor, and Windsurf.
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Then set the environment variable TEMPLATEFOX_API_KEY in your shell.
Use the same npx -y @templatefox/mcp-server command in your MCP server configuration, with TEMPLATEFOX_API_KEY in the environment.
Then use templatefox-mcp-server as the command instead of npx.
| Environment Variable | Required | Description |
|---|---|---|
TEMPLATEFOX_API_KEY | Yes | Your API key (starts with sk_). Get one at app.templatefox.com/dashboard/api-keys |
TEMPLATEFOX_BASE_URL | No | Override API base URL (default: https://api.templatefox.com) |
| Tool | Description |
|---|---|
generate_pdf | Generate a PDF from a template with dynamic data (1 credit) |
generate_pdf_async | Queue async PDF generation with optional webhook (1 credit) |
get_pdf_job_status | Check the status of an async PDF job |
list_pdf_jobs | List async PDF generation jobs |
list_templates | List all available templates |
get_template_fields | Get the fields/variables for a template |
get_account_info | Check remaining credits and account info |
list_transactions | View credit transaction history |
The MCP server also supports HTTP transport via Streamable HTTP, suitable for remote and cloud deployments.
MCP clients must pass the API key via HTTP header:
or:
Run the server in HTTP mode by setting the PORT environment variable:
Or with Docker:
The MCP endpoint is available at http://localhost:8080/mcp and a health check at http://localhost:8080/health.
Once configured, you can ask your AI assistant:
"List my PDF templates and generate an invoice using the Invoice Template with customer name 'John Doe' and amount 150.00"
The assistant will:
list_templates to find available templatesget_template_fields to discover required fieldsgenerate_pdf with the template ID and dataMIT