English Français العربية

io.github.ayo-nci/bulkrender

السجل الرسمي مؤرشف الإنتاجية

Generate DOCX and PDF documents from AI assistants using BulkRender templates.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package bulkrender-mcp
Claude Code 
claude mcp add bulkrender -e 'BULKRENDER_API_URL=<BULKRENDER_API_URL>' -- npx -y bulkrender-mcp@1.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bulkrender": {
            "command": "npx",
            "args": [
                "-y",
                "bulkrender-mcp@1.1.1"
            ],
            "env": {
                "BULKRENDER_API_URL": "<BULKRENDER_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • BULKRENDER_API_URL BulkRender API base URL. Defaults to https://api.bulkrender.com — only set for local development.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. bulkrender-mcp
  2. Quickstart
  3. Connect your AI assistant
  4. Tools
  5. Usage examples
  6. Troubleshooting
  7. Rate limits
  8. Links
  9. Migrating from the npm package

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
  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)
ToolDescriptionCredits
list_templatesList all templates0
get_templateGet template details and variable schema0
search_templatesSearch templates by name or tag0
generate_documentGenerate a single document (DOCX or PDF)1–2
generate_batchGenerate documents for multiple records (up to 500)1–2 each
get_batch_statusPoll batch job status and get download URLs0
check_creditsCheck remaining credits0
refresh_document_urlGet a fresh signed URL for an existing document0
estimate_costEstimate credit cost before generating0
create_template_from_docxCreate a reusable template from a DOCX URL0
submit_feedbackSubmit feedback or a bug report0

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.

ToolDescriptionCost
acp_list_public_templatesList built-in templates (invoice, quote, contract, report, proposal)Free
acp_create_sessionCreate a checkout session and get a Stripe payment URL—
acp_pay_sessionCharge a Stripe payment method directly (developer path)Min $1.00
acp_get_sessionPoll session status, get download URLs when completeFree

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

ProblemSolution
Server not connectingRegenerate your MCP URL from Settings, Integrations
Template not foundUse list_templates to get the correct UUID
Timeout on large batchBatches over 10 records process async — poll get_batch_status
429 Too Many RequestsRate limit hit — retry after a short pause

Rate limits

EndpointLimit
Document generation30 requests / minute per organisation
Template reads, credits30 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.

الأسئلة الشائعة

ما هو io.github.ayo-nci/bulkrender؟

Generate DOCX and PDF documents from AI assistants using BulkRender templates.

كيف أثبّت io.github.ayo-nci/bulkrender؟

يعمل على جهازك. في Claude Code: claude mcp add bulkrender -e 'BULKRENDER_API_URL=<BULKRENDER_API_URL>' -- npx -y bulkrender-mcp@1.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ayo-nci/bulkrender إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.ayo-nci/bulkrender مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.ayo-nci/bulkrender؟

ينشره ayo-nci. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.