Skip to main content
Glama

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)


Related MCP server: AI Answer Copier

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.



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.

Available Tools

15 tools
acp_create_sessionA

Create an ACP checkout session to generate documents without a BulkRender account. Pricing: $0.10/credit — DOCX = 1 credit, PDF = 2 credits. Minimum charge $1.00 (covers up to 10 DOCX or 5 PDF docs). Pass 'records' array (up to 200 objects) with one data object per document. Agents are responsible for passing all required template variable mappings — variables not provided will render as empty strings. Returns session_id, amount_due (USD), checkout_url (Stripe hosted payment page), and expires_at. Share checkout_url for browser payment, then poll acp_get_session until status is 'completed'.

Inputs: bearerToken (required), templateType (required), records (required), agentEmail (required), +4 more.

acp_get_sessionA

Get the status of an ACP checkout session. Poll after payment until status is 'completed' (typically 5–30s depending on quantity). On completion returns: documents[] with signed download_url per document (24h expiry), zip_download_url for all docs in one ZIP (24h expiry), credits (used/paid/remaining), and signup_cta. IMPORTANT: always present the signup_cta URL and message to the user after a completed session — it lets them keep their remaining credit.

Inputs: bearerToken (required), sessionId (required).

acp_list_public_templatesA

List BulkRender's built-in public templates (invoice, quote, contract, report, proposal). No API key required. Returns template IDs and the exact field names you must supply when creating an ACP session.

Inputs: no named parameters.

acp_pay_sessionA

Pay for an ACP checkout session using a Stripe payment method ID (pm_xxx). Charges the amount_due returned by acp_create_session. On success, document generation begins in the background — poll acp_get_session until status is 'completed'.

Inputs: bearerToken (required), sessionId (required), stripePaymentMethodId (required), email (required).

check_creditsA

Check remaining credits for the organization. Shows subscription credits, purchased credit packs, and total available credits.

Inputs: no named parameters.

create_template_from_docxA

Create a reusable document template by providing a URL to an existing DOCX file. The server fetches the file, extracts all {{placeholder}} variables, and saves it as a template. Returns a templateId ready for use with generate_document.

Inputs: docxUrl (required), templateName, agentEmail, customerName, +1 more.

estimate_costA

Estimate the credit cost before generating documents. Call this before large batches so the user can confirm. Also returns current credit balance.

Inputs: count (required), outputFormat.

generate_batchA

Generate documents for multiple records in one call. Returns a ZIP download URL. Each record costs 1 credit (DOCX) or 2 credits (PDF).

Inputs: templateId (required), records (required), outputFormat.

generate_documentA

Generate a single document from a template and data. Returns a signed download URL. Costs 1 credit (DOCX) or 2 credits (PDF).

Inputs: templateId (required), data (required), outputFormat.

get_batch_statusA

Check the status of an async batch generation job. Poll until status is 'completed'. Returns progress, document count, and download URLs when done.

Inputs: jobId (required).

get_templateA

Get a template's details including its variable schema. Use this to understand what data fields a template expects before generating documents.

Inputs: templateId (required).

list_templatesA

List all available document templates with their variables. Returns template names, IDs, file types, and placeholder variables.

Inputs: no named parameters.

refresh_document_urlA

Get a fresh signed download URL for an existing document. Does not consume credits. Useful when a previously generated document's URL has expired.

Inputs: documentId (required), expiresIn.

search_templatesA

Search templates by name or description. Use this to find a template when you don't know its exact ID. Returns matching templates with their IDs and variable counts.

Inputs: query (required).

submit_feedbackA

Submit feedback, feature requests, or bug reports to the BulkRender support team. Use this when a feature isn't supported, a problem is encountered, or a user has a suggestion. Pass the end user's email (or the agent_email from the ACP session) so the support team can follow up directly with them — agents have no inbox.

Inputs: message (required), email (required), type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: ACP session management, credit/cost operations, document generation (single/batch), template management (create, get, list, search), URL refresh, and feedback. There is no ambiguity or overlap between tools.

    Naming Consistency5/5

    All tools use a consistent verb_noun pattern in snake_case. ACP-related tools are prefixed with 'acp_' for clarity. The naming scheme is predictable and makes it easy to infer each tool's function.

    Tool Count5/5

    With 15 tools, the server is well-scoped. It covers all core functionalities (template management, document generation, ACP checkout, credits, batch operations, and feedback) without being overwhelming or trivial.

    Completeness4/5

    The tool surface covers the main lifecycle: template creation (via DOCX), listing/searching, generation (single/batch), ACP session handling, credit checks, cost estimation, and URL refresh. Minor gaps exist (e.g., no template deletion or update), but agents can work around them.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers