Boxpdf logo

Boxpdf

Provides MCP resources with boxpdf documentation and PDF layout templates for agent-assisted TypeScript development.

Install Boxpdf

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "boxpdf": {
      "command": "npx",
      "args": [
        "-y",
        "boxpdf"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The boxpdf MCP server exposes documentation and templates for the boxpdf TypeScript PDF layout library as MCP resources. It is launched through the package CLI with `npx -y boxpdf mcp` and is designed to help agents reference layout APIs and scaffold examples. Reach for it when an agent needs guidance creating receipts, resumes, certificates, or other PDFs with boxpdf; it is not a general-purpose PDF generation tool.

Use cases

  • Find the right boxpdf layout primitive for a TypeScript PDF
  • Scaffold a receipt or resume template into an application
  • Look up boxpdf pagination and table APIs
  • Review examples for PDF form fields and themes

Key features

  • Documentation exposed as MCP resources
  • Templates for receipts, resumes, and certificates
  • Examples for boxpdf layout and pagination APIs
  • CLI-based MCP startup
  • References for PDF forms, tables, themes, and links

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

6/6 checks healthy over the last 45d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · boxpdf (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars18Stargazers on the source repository.
npm downloads644Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.

How Boxpdf works

What boxpdf does

The boxpdf MCP server provides agents with access to documentation and template resources for the boxpdf PDF layout library. The underlying library is a declarative box-layout DSL built over pdf-lib and supports portable JavaScript environments including Node 20+, Cloudflare Workers, Deno, and browsers.

Templates cover receipts, boarding passes, resumes, order confirmations, and certificates. Each template is a single file that can be copied into an application.

How it works

The MCP process is started through the boxpdf command-line interface. Agents connect to that process and use its resource-only content rather than invoking a broad set of runtime PDF operations through MCP. The resources describe the library API and provide example files for common document formats.

The referenced library creates PDFs with pdf-lib. Its higher-level flow API manages the document lifecycle and returns saved bytes, while an explicit rendering path lets application code own the PDF document and save options. Layout features include pagination, headers and footers, table row fragmentation, wrapping, flex-style sizing, borders, backgrounds, transforms, themes, PDF links, and layout-aware AcroForm widgets.

Setup and configuration

Run the resource server with the package CLI:

Terminal
claude mcp add boxpdf -- npx -y boxpdf mcp

For applications that use the library itself, install the current package name and its peer dependency:

Terminal
npm install @boxpdf/writer pdf-lib

The legacy boxpdf package remains supported, and both package names expose the same API and CLI. Templates can also be scaffolded directly into an application with commands such as npx boxpdf init receipt --out src/pdf/receipt.ts; npx boxpdf list displays available templates.

Tools and capabilities

As a resource-only MCP server, boxpdf is intended to supply reference material rather than expose documented action tools. Its resources support agent tasks such as:

  • Finding the correct layout primitive for a PDF component.
  • Reviewing theme, typography, pagination, and table APIs.
  • Starting a document from a receipt, resume, certificate, or similar template.
  • Checking examples for flowToPdf, renderFlow, standard fonts, and AcroForm fields.
  • Comparing the modern @boxpdf/writer package name with the legacy boxpdf package.

The library documentation covers text wrapping and truncation, mixed inline paragraphs, images, tables, hyperlinks, form controls, streaming generation, and built-in themes. Custom fonts require the fontkit path when using loadFont or embedInter.

Limitations and notes

PDF creation happens in application code using the boxpdf library.

The library requires Node 20 or newer when run in Node. pdf-lib is a peer dependency, and custom font workflows may additionally require @pdf-lib/fontkit.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Boxpdf

boxpdf is an MCP server that connects agents to documentation and templates for the boxpdf TypeScript PDF layout library. Its main resources cover layout primitives, pagination, themes, tables, links, and AcroForm fields, along with templates for receipts, boarding passes, resumes, order confirmations, and certificates.

Run `claude mcp add boxpdf -- npx -y boxpdf mcp` to register it with the Claude CLI. The server is distributed through the npm package and exposes resource-only documentation and template content.

No direct PDF generation capability is documented for the MCP component. It provides resources for the boxpdf library; your application uses `flowToPdf` or `renderFlow` and pdf-lib to create PDF output.

It includes resources for receipts, boarding passes, resumes, order confirmations, and certificates. The repository describes each template as a single file that can be scaffolded into an application with the boxpdf CLI.

The documented setup uses the Claude CLI command to add the resource-only MCP server.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBoxpdf AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/boxpdf?style=directory)](https://allmcps.com/mcp/boxpdf)
HTML Embed
<a href="https://allmcps.com/mcp/boxpdf"><img src="https://allmcps.com/api/badge/boxpdf?style=directory" alt="Boxpdf on AllMCPs" /></a>