ayo-nci/bulkrender-mcp

ayo-nci/bulkrender-mcp MCP server

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

Quickstart

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

---

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

---

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

---

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

• BulkRender
• API Documentation
• GitHub

---

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.