{
  "markdown": "# TemplateFox MCP Server\n\nMCP (Model Context Protocol) server for the [TemplateFox](https://templatefox.com) PDF generation API. Generate PDFs from templates directly through AI assistants like Claude, Cursor, and Windsurf.\n\n## Installation\n\n### Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"templatefox\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@templatefox/mcp-server\"],\n      \"env\": {\n        \"TEMPLATEFOX_API_KEY\": \"sk_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add templatefox -- npx -y @templatefox/mcp-server\n```\n\nThen set the environment variable `TEMPLATEFOX_API_KEY` in your shell.\n\n### Cursor / Windsurf\n\nUse the same `npx -y @templatefox/mcp-server` command in your MCP server configuration, with `TEMPLATEFOX_API_KEY` in the environment.\n\n### Global Install (alternative)\n\n```bash\nnpm install -g @templatefox/mcp-server\n```\n\nThen use `templatefox-mcp-server` as the command instead of `npx`.\n\n## Configuration\n\n| Environment Variable | Required | Description |\n|---|---|---|\n| `TEMPLATEFOX_API_KEY` | Yes | Your API key (starts with `sk_`). Get one at [app.templatefox.com/dashboard/api-keys](https://app.templatefox.com/dashboard/api-keys) |\n| `TEMPLATEFOX_BASE_URL` | No | Override API base URL (default: `https://api.templatefox.com`) |\n\n## Available Tools\n\n| Tool | Description |\n|---|---|\n| `generate_pdf` | Generate a PDF from a template with dynamic data (1 credit) |\n| `generate_pdf_async` | Queue async PDF generation with optional webhook (1 credit) |\n| `get_pdf_job_status` | Check the status of an async PDF job |\n| `list_pdf_jobs` | List async PDF generation jobs |\n| `list_templates` | List all available templates |\n| `get_template_fields` | Get the fields/variables for a template |\n| `get_account_info` | Check remaining credits and account info |\n| `list_transactions` | View credit transaction history |\n\n## Remote Server (HTTP)\n\nThe MCP server also supports HTTP transport via Streamable HTTP, suitable for remote and cloud deployments.\n\n### Connect via URL\n\n```\nhttps://mcp-server-599407781746.us-central1.run.app/mcp\n```\n\nMCP clients must pass the API key via HTTP header:\n\n```\nAuthorization: Bearer sk_your_api_key_here\n```\n\nor:\n\n```\nx-api-key: sk_your_api_key_here\n```\n\n### Self-host\n\nRun the server in HTTP mode by setting the `PORT` environment variable:\n\n```bash\nPORT=8080 TEMPLATEFOX_API_KEY=sk_your_key node dist/index.js\n```\n\nOr with Docker:\n\n```bash\ndocker build -t templatefox-mcp .\ndocker run -p 8080:8080 templatefox-mcp\n```\n\nThe MCP endpoint is available at `http://localhost:8080/mcp` and a health check at `http://localhost:8080/health`.\n\n## Example Usage\n\nOnce configured, you can ask your AI assistant:\n\n> \"List my PDF templates and generate an invoice using the Invoice Template with customer name 'John Doe' and amount 150.00\"\n\nThe assistant will:\n1. Call `list_templates` to find available templates\n2. Call `get_template_fields` to discover required fields\n3. Call `generate_pdf` with the template ID and data\n4. Return the PDF download URL\n\n## Links\n\n- [TemplateFox Documentation](https://templatefox.com/docs)\n- [API Reference](https://api.templatefox.com/docs)\n- [Get API Key](https://app.templatefox.com/dashboard/api-keys)\n- [GitHub](https://github.com/TemplateFoxPDF/mcp-server)\n\n## License\n\nMIT\n",
  "bytes": 3419,
  "sha": "15537225762f1f9bc56a46979017cb540d18cc0d3d5904245895fb83e183e2ff",
  "repo_slug": "templatefoxpdf/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_templatefoxpdf_mcp_server_0beb95c2/readme"
}