bulkrender-mcp

BulkRender MCP server. Generate DOCX and PDF documents from Claude, Cursor, Windsurf, Cline, and any other MCP-compatible AI assistant.

Connect your AI assistant

Claude.ai

Settings, Integrations, Add custom integration, paste your MCP URL.

Claude Desktop / Cursor / Windsurf / Cline

Add to your MCP config file:

{
  "mcpServers": {
    "bulkrender": {
      "url": "YOUR_MCP_URL"
    }
  }
}

Claude Code (CLI)

claude mcp add bulkrender --scope user -- npx mcp-remote YOUR_MCP_URL

Verify:

claude mcp list
# bulkrender   ✓ Connected

Tools

Authenticated tools (requires MCP URL)

Tool	Description	Credits
`list_templates`	List all templates	0
`get_template`	Get template details and variable schema	0
`search_templates`	Search templates by name or tag	0
`generate_document`	Generate a single document (DOCX or PDF)	1–2
`generate_batch`	Generate documents for multiple records (up to 500)	1–2 each
`get_batch_status`	Poll batch job status and get download URLs	0
`check_credits`	Check remaining credits	0
`refresh_document_url`	Get a fresh signed URL for an existing document	0
`estimate_cost`	Estimate credit cost before generating	0
`create_template_from_docx`	Create a reusable template from a DOCX URL	0
`submit_feedback`	Submit feedback or a bug report	0

Credit costs: DOCX = 1 credit, PDF = 2 credits.

Walk-in tools (no account required)

For agents acting on behalf of end users who have no BulkRender account. Pay per session via Stripe.

Tool	Description	Cost
`acp_list_public_templates`	List built-in templates (invoice, quote, contract, report, proposal)	Free
`acp_create_session`	Create a checkout session and get a Stripe payment URL	—
`acp_pay_session`	Charge a Stripe payment method directly (developer path)	Min $1.00
`acp_get_session`	Poll session status, get download URLs when complete	Free

Walk-in minimum charge: $1.00 (covers up to 10 DOCX or 5 PDF docs).

Public MCP URL (no account, walk-in tools only): https://mcp.bulkrender.com/mcp/acp

Rate limits

Endpoint	Limit
Document generation	30 requests / minute per organisation
Template reads, credits	30 requests / minute per organisation

generate_batch counts as one request regardless of record count.

Links

Migrating from the npm package

The standalone npm package (npx bulkrender-mcp with BULKRENDER_API_KEY) is no longer supported. Use the hosted MCP URL instead — no install, no env vars, just paste the URL from your dashboard.

If you have the old config:

{
  "mcpServers": {
    "bulkrender": {
      "command": "npx",
      "args": ["-y", "bulkrender-mcp"],
      "env": { "BULKRENDER_API_KEY": "br_live_..." }
    }
  }
}

Replace it with:

{
  "mcpServers": {
    "bulkrender": {
      "url": "YOUR_MCP_URL"
    }
  }
}

Get your MCP URL from Settings, Integrations, AI Assistants (MCP) in your BulkRender dashboard.

Quickstart

Sign up at bulkrender.com
Go to Settings, Integrations, AI Assistants (MCP)
Click Generate MCP URL — copy it immediately, shown once
Paste into your AI assistant (see below)

Usage examples

List templates:

"List my BulkRender templates"

Generate a document:

"Generate an invoice using the Invoice Template for Acme Corp, invoice #1234, dated 2025-01-15, amount $5,000"

Batch generation:

"Generate invoices for these 3 clients: Acme Corp ($5,000), Beta Inc ($3,200), Gamma LLC ($7,800)"

Troubleshooting

Problem	Solution
Server not connecting	Regenerate your MCP URL from Settings, Integrations
`Template not found`	Use `list_templates` to get the correct UUID
Timeout on large batch	Batches over 10 records process async — poll `get_batch_status`
`429 Too Many Requests`	Rate limit hit — retry after a short pause