About io.github.ayo-nci/bulkrender
io.github.ayo-nci/bulkrender is an MCP server in the Cloud category: generate DOCX and PDF documents from AI assistants using BulkRender templates.
Install
claude mcp add io-github-ayo-nci-bulkrender -- npx -y bulkrender-mcpnpx -y bulkrender-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (11)
check_creditsCheck remaining credits
Parameters not published.
create_template_from_docxCreate a reusable template from a DOCX URL
Parameters not published.
estimate_costEstimate credit cost before generating
Parameters not published.
generate_batchGenerate documents for multiple records (up to 500)
Parameters not published.
generate_documentGenerate a single document (DOCX or PDF)
Parameters not published.
get_batch_statusPoll batch job status and get download URLs
Parameters not published.
get_templateGet template details and variable schema
Parameters not published.
list_templatesList all templates
Parameters not published.
refresh_document_urlGet a fresh signed URL for an existing document
Parameters not published.
search_templatesSearch templates by name or tag
Parameters not published.
submit_feedbackSubmit feedback or a bug report
Parameters not published.
Ask AI
Ask AI about io.github.ayo-nci/bulkrender
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
bulkrender-mcp
BulkRender MCP server. Generate DOCX and PDF documents from any AI assistant that supports the Model Context Protocol (Claude, Cursor, Windsurf, Cline, and more).
Tools
| Tool | Description | Credits |
|---|---|---|
list_templates |
List all templates with their variables | 0 |
get_template |
Get template details and variable schema | 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 |
check_credits |
Check remaining credits | 0 |
Credit costs: DOCX = 1 credit, PDF = 2 credits.
Prerequisites
- A BulkRender account at bulkrender.com
- An API key (
br_live_...). Generate one from Settings, Platform API Keys (shown once, copy immediately) - Node.js 18+
Installation
Claude Code (CLI, recommended)
Run once in your terminal:
claude mcp add bulkrender --scope user --env BULKRENDER_API_KEY=br_live_YOUR_KEY_HERE -- npx bulkrender-mcp
Verify:
claude mcp list
# bulkrender ✓ Connected
Claude Desktop (Windows)
Edit C:\Users\<you>\AppData\Roaming\Claude\claude_desktop_config.json:
{
"mcpServers": {
"bulkrender": {
"command": "npx",
"args": ["-y", "bulkrender-mcp"],
"env": {
"BULKRENDER_API_KEY": "br_live_YOUR_KEY_HERE"
}
}
}
}
Restart Claude Desktop.
Claude Code (manual JSON)
Edit ~/.claude/mcp.json:
{
"mcpServers": {
"bulkrender": {
"command": "npx",
"args": ["-y", "bulkrender-mcp"],
"env": {
"BULKRENDER_API_KEY": "br_live_YOUR_KEY_HERE"
}
}
}
}
Cursor / Windsurf / Cline
Use the same mcpServers block above in your app's MCP config file. Location varies by app.
Configuration
| Variable | Required | Description |
|---|---|---|
BULKRENDER_API_KEY |
Yes | Your API key (br_live_<prefix>_<secret>) |
BULKRENDER_API_URL |
No | Override API base URL (default: https://api.bulkrender.com) |
Set BULKRENDER_API_URL=http://localhost:3000 for local development.
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"
The assistant calls list_templates to find the template UUID, then generate_document with the mapped data, and returns a signed download URL (valid 1 hour).
Batch generation:
"Generate invoices for these 3 clients: Acme Corp ($5,000), Beta Inc ($3,200), Gamma LLC ($7,800)"
Returns a signed ZIP download URL.
Check credits:
"How many BulkRender credits do I have left?"
Troubleshooting
| Problem | Solution |
|---|---|
Invalid API key |
Check key format: br_live_<prefix>_<secret>. Regenerate from Settings, Platform API Keys if lost. |
Template not found |
Use list_templates to get the UUID, or pass the slug directly (e.g. "sample-invoice"). Both are accepted. |
| Timeout on large batch | Batches over 10 records process asynchronously. Wait for the job to complete. |
| Server not connecting | Run claude mcp list to check status. Re-run claude mcp add command if missing. |
Rate Limits
All limits are enforced by the BulkRender API, not the MCP server itself.
| Endpoint type | Limit |
|---|---|
Document generation (generate_document, generate_batch) |
30 requests / minute per organization |
Template reads (list_templates, get_template, check_credits) |
30 requests / minute per organization |
When the limit is hit, the API returns HTTP 429. The MCP server surfaces this as a tool error. The AI assistant will see this and can retry after a short pause.
Batch jobs: generate_batch counts as one API request regardless of record count (up to 500 records).
Security
- API key is passed via environment variable, not stored by the MCP server
- All production communication uses HTTPS
- Signed download URLs expire after 1 hour. The underlying file remains available for your plan's retention period. Call the API again to get a fresh URL.
Links
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.