io.github.TemplateFoxPDF/mcp-server
MCP server for TemplateFox PDF generation API - Generate PDFs from templates via AI assistants
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@templatefox/mcp-serverclaude mcp add io-github-templatefoxpdf-mcp-server -e 'TEMPLATEFOX_API_KEY=<your templatefox_api_key>' -- npx -y @templatefox/mcp-server@1.9.7
{
"mcpServers": {
"io-github-templatefoxpdf-mcp-server": {
"command": "npx",
"args": [
"-y",
"@templatefox/mcp-server@1.9.7"
],
"env": {
"TEMPLATEFOX_API_KEY": "<your templatefox_api_key>"
}
}
}
}
Environment variables
TEMPLATEFOX_API_KEYrequired secret Your TemplateFox API key
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
TemplateFox MCP Server
MCP (Model Context Protocol) server for the TemplateFox PDF generation API. Generate PDFs from templates directly through AI assistants like Claude, Cursor, and Windsurf.
Installation
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"templatefox": {
"command": "npx",
"args": ["-y", "@templatefox/mcp-server"],
"env": {
"TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
}
}
}
}
Claude Code
claude mcp add templatefox -- npx -y @templatefox/mcp-server
Then set the environment variable TEMPLATEFOX_API_KEY in your shell.
Cursor / Windsurf
Use the same npx -y @templatefox/mcp-server command in your MCP server configuration, with TEMPLATEFOX_API_KEY in the environment.
Global Install (alternative)
npm install -g @templatefox/mcp-server
Then use templatefox-mcp-server as the command instead of npx.
Configuration
| 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) |
Available Tools
| 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 |
Remote Server (HTTP)
The MCP server also supports HTTP transport via Streamable HTTP, suitable for remote and cloud deployments.
Connect via URL
https://mcp-server-599407781746.us-central1.run.app/mcp
MCP clients must pass the API key via HTTP header:
Authorization: Bearer sk_your_api_key_here
or:
x-api-key: sk_your_api_key_here
Self-host
Run the server in HTTP mode by setting the PORT environment variable:
PORT=8080 TEMPLATEFOX_API_KEY=sk_your_key node dist/index.js
Or with Docker:
docker build -t templatefox-mcp .
docker run -p 8080:8080 templatefox-mcp
The MCP endpoint is available at http://localhost:8080/mcp and a health check at http://localhost:8080/health.
Example Usage
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:
- Call
list_templatesto find available templates - Call
get_template_fieldsto discover required fields - Call
generate_pdfwith the template ID and data - Return the PDF download URL
Links
License
MIT
Frequently asked questions
What is io.github.TemplateFoxPDF/mcp-server?
MCP server for TemplateFox PDF generation API - Generate PDFs from templates via AI assistants
How do I install io.github.TemplateFoxPDF/mcp-server?
It runs on your machine. In Claude Code: claude mcp add io-github-templatefoxpdf-mcp-server -e 'TEMPLATEFOX_API_KEY=<your templatefox_api_key>' -- npx -y @templatefox/mcp-server@1.9.7. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.TemplateFoxPDF/mcp-server need an API key?
Yes. It expects TEMPLATEFOX_API_KEY, which you set in its configuration.
Is io.github.TemplateFoxPDF/mcp-server open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.TemplateFoxPDF/mcp-server?
It is published by TemplateFoxPDF. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.