mcpField
T
TemplateFoxPDF

TemplateFoxPDF

Local
github.com/TemplateFoxPDFProductivity0Updated 13w ago
Repository

About TemplateFoxPDF

TemplateFoxPDF connects AI assistants to the TemplateFox PDF generation API, letting them create PDFs from templates and dynamic data. Its tools also cover template fields, asynchronous jobs, and account credits.

Key features

  1. 01Generate PDFs from templates
  2. 02Queue asynchronous PDF jobs
  3. 03Check and list PDF jobs
  4. 04List templates and inspect fields
  5. 05View account credits and transactions

Use cases

  1. 01Create a PDF using template data
  2. 02Check the status of queued PDF generation

MCP support

Exposes TemplateFox API operations as MCP tools, including PDF generation, template discovery, job tracking, and account information. Supports stdio configuration and Streamable HTTP connections.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "templatefoxpdf": {
      "command": "npx",
      "args": [
        "-y",
        "@templatefox/mcp-server"
      ],
      "env": {
        "TEMPLATEFOX_API_KEY": "<TEMPLATEFOX_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @templatefox/mcp-server
Environment variables to set
TEMPLATEFOX_API_KEYSecretYour TemplateFox API key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@templatefox/mcp-server1.9.7

Tools

8

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
dataobjectYesKey-value data to render in the template. Keys must match template variables.
filenamestringNoCustom filename for the PDF (without .pdf extension). If not provided, defaults to 'document'. Only applies to `url` export type.
store_s3booleanNoUpload to your configured S3 bucket instead of CDN
s3_bucketstringNoOverride the default bucket configured in your S3 integration.
expirationintegerNoURL expiration in seconds. Min: 60 (1 min), Max: 604800 (7 days). Only applies to `url` export type.
export_typeenumNoExport format: `url` uploads to CDN and returns URL, `binary` returns raw PDF bytesurl | binary
pdf_variantenumNoGenerate a standards-compliant PDF variant. Use `pdf/a-3b` for archival compliance (most common). Use `pdf/a-3b` if you need file attachments (e.g. Factur-X). When not set, a standard PDF is generated.pdf/a-1b | pdf/a-2b | pdf/a-3b
s3_filepathstringNoCustom path prefix in your S3 bucket. Uses default prefix if not provided.
template_idstringYesTemplate short ID (12 characters)

Details

From the project README

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 VariableRequiredDescription
TEMPLATEFOX_API_KEYYesYour API key (starts with sk_). Get one at app.templatefox.com/dashboard/api-keys
TEMPLATEFOX_BASE_URLNoOverride API base URL (default: https://api.templatefox.com)

Available Tools

ToolDescription
generate_pdfGenerate a PDF from a template with dynamic data (1 credit)
generate_pdf_asyncQueue async PDF generation with optional webhook (1 credit)
get_pdf_job_statusCheck the status of an async PDF job
list_pdf_jobsList async PDF generation jobs
list_templatesList all available templates
get_template_fieldsGet the fields/variables for a template
get_account_infoCheck remaining credits and account info
list_transactionsView 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:

  1. Call list_templates to find available templates
  2. Call get_template_fields to discover required fields
  3. Call generate_pdf with the template ID and data
  4. Return the PDF download URL

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.