io.github.ayo-nci/bulkrender
Generate DOCX and PDF documents from AI assistants using BulkRender templates.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
bulkrender-mcpclaude mcp add bulkrender -e 'BULKRENDER_API_URL=<BULKRENDER_API_URL>' -- npx -y bulkrender-mcp@1.1.1
{
"mcpServers": {
"bulkrender": {
"command": "npx",
"args": [
"-y",
"bulkrender-mcp@1.1.1"
],
"env": {
"BULKRENDER_API_URL": "<BULKRENDER_API_URL>"
}
}
}
}
Environment variables
BULKRENDER_API_URLBulkRender API base URL. Defaults to https://api.bulkrender.com — only set for local development.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
bulkrender-mcp
BulkRender MCP server. Generate DOCX and PDF documents from Claude, Cursor, Windsurf, Cline, and any other MCP-compatible AI assistant.
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)
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
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.
Frequently asked questions
What is io.github.ayo-nci/bulkrender?
Generate DOCX and PDF documents from AI assistants using BulkRender templates.
How do I install io.github.ayo-nci/bulkrender?
It runs on your machine. In Claude Code: claude mcp add bulkrender -e 'BULKRENDER_API_URL=<BULKRENDER_API_URL>' -- npx -y bulkrender-mcp@1.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.ayo-nci/bulkrender need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.ayo-nci/bulkrender open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.ayo-nci/bulkrender?
It is published by ayo-nci. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.