Content
# bulkrender-mcp
[](https://glama.ai/mcp/servers/ayo-nci/bulkrender-mcp)
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](https://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:
```json
{
"mcpServers": {
"bulkrender": {
"url": "YOUR_MCP_URL"
}
}
}
```
### Claude Code (CLI)
```bash
claude mcp add bulkrender --scope user -- npx mcp-remote YOUR_MCP_URL
```
Verify:
```bash
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](https://bulkrender.com)
- [API Documentation](https://bulkrender.com/docs/api)
- [GitHub](https://github.com/ayo-nci/bulkrender-mcp)
---
## 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:
```json
{
"mcpServers": {
"bulkrender": {
"command": "npx",
"args": ["-y", "bulkrender-mcp"],
"env": { "BULKRENDER_API_KEY": "br_live_..." }
}
}
}
```
Replace it with:
```json
{
"mcpServers": {
"bulkrender": {
"url": "YOUR_MCP_URL"
}
}
}
```
Get your MCP URL from **Settings, Integrations, AI Assistants (MCP)** in your BulkRender dashboard.
