Guides · Shopify + AI

BulkRender with Shopify via AI agent.

Use the BulkRender MCP server inside Claude (Claude.ai, Claude Desktop, or Claude Code) to turn Shopify order and product data into polished documents, without writing an integration. More MCP clients coming soon.

Overview

How It Works

The BulkRender MCP server exposes document generation as tools that any MCP-compatible AI agent can call. You describe what you want in plain language. The agent fetches your Shopify data, maps it to your template variables, and calls BulkRender to produce the files.

Step 1
Connect MCP
Connect BulkRender to Claude.ai, Claude Desktop, or Claude Code.
Step 2
Upload template
Point the agent at your DOCX file. It creates the template and returns an ID.
Step 3
Generate docs
Tell the agent where your order or product data lives. It fetches, fills, and renders in one call.

No Shopify app, no webhook, no custom code. The agent is the integration layer.

Setup

Connect the MCP Server

BulkRender ships a hosted MCP server. There are two ways to connect: sign in with your BulkRender account (recommended for Claude.ai and Claude Desktop), or generate a personal MCP URL from Settings, Integrations for CLI and config-file tools.

Claude.ai and Claude Desktop (recommended)

Go to Settings, Connectors, Add custom connector and paste the BulkRender endpoint. Claude opens a BulkRender sign-in page: log in, approve access, done.

BulkRender endpoint
https://api.bulkrender.com/mcp

You'll see BulkRender tools listed in the tool picker. Manage or disconnect apps any time from Settings, Integrations, Connected apps.

Claude Code (CLI)

Generate a personal MCP URL first (see below), then add it:

$ Terminal
claude mcp add --transport http bulkrender YOUR_MCP_URL --scope user

Cursor / Windsurf / Cline: coming soon

BulkRender speaks standard MCP, but we have only fully tested Claude clients so far. Verified setup guides for other MCP clients are coming soon.

Get your MCP URL

Log in to app.bulkrender.com, go to Settings, Integrations, open AI Assistants (MCP), and click Generate MCP URL. Copy it immediately, shown once.

No account yet?

AI agents can use the public walk-in endpoint https://api.bulkrender.com/mcp/acp with no account. Browse built-in templates with acp_list_public_templates, then pay per session with acp_create_session: $0.10 per credit, $1.00 minimum, up to 200 records, download links valid 24 hours. Custom templates like the examples below need a free account.

Example 1

Certificate of Authenticity from Orders

Shopify Plus merchants selling limited editions, fine art, or branded goods often include a certificate of authenticity with each order. This example generates one PDF certificate per order line item in a single agent conversation.

1. Create your DOCX template

Design a certificate in Word. Use {{double brace}} placeholders for each data field:

certificate-template.docx (placeholder variables)
{{customer_name}}
{{order_number}}
{{product_title}}
{{sku}}
{{edition_number}}
{{purchase_date}}
{{certificate_id}}

Upload the file to Google Drive or Dropbox and copy the direct download link.

2. Ingest the template via MCP

Tell your agent:

Agent prompt
Use create_template_from_docx with this URL:
https://drive.google.com/uc?export=download&id=YOUR_FILE_ID

Name it "Certificate of Authenticity".

The agent returns a templateId. Save it, or just leave it in the conversation context.

3. Point the agent at your orders and generate

Tell the agent where the order data lives. If it has a Shopify connection (the Shopify MCP server, or Admin API access with your store domain and an access token), it fetches the orders itself. No connection? Export orders as CSV from Shopify Admin (Orders, Export) and paste that in: the agent maps CSV columns to template variables just as well. Then prompt:

Agent prompt
Fetch order #1042 from my Shopify store.
(No Shopify connection? Say: "Here is my order export:"
and paste the CSV from Shopify Admin, Orders, Export.)

For each line item, generate a PDF certificate using the
templateId you just created. Map the fields like this:
- customer_name  → billing_address.name
- order_number   → order_number (prefix with #)
- product_title  → line_items[].title
- sku            → line_items[].sku
- edition_number → line_items[].properties["Edition Number"]
- purchase_date  → created_at (format as Month DD, YYYY)
- certificate_id → generate a UUID

Use generate_batch with outputFormat "pdf".

The agent calls generate_batch and returns a ZIP download link containing one certificate per line item. Each PDF costs 2 credits.

Example 2

Wholesale Catalog from Product Metafields

Shopify Plus merchants selling to retailers often need a branded wholesale price list or product sheet. Product metafields hold the structured data; BulkRender turns it into a polished catalog page per product.

1. Set up your product metafields

In Shopify Admin, create a metafield namespace (e.g. wholesale) with fields your catalog needs:

Shopify metafield keys (namespace: wholesale)
wholesale.unit_price       # e.g. "£4.50"
wholesale.min_order_qty    # e.g. "12"
wholesale.lead_time        # e.g. "5-7 working days"
wholesale.country_of_origin
wholesale.hs_code

2. Create the catalog page template

Design a one-page-per-product DOCX layout and use these placeholders:

catalog-page-template.docx
{{product_title}}
{{variant_sku}}
{{retail_price}}
{{wholesale_price}}
{{min_order_qty}}
{{lead_time}}
{{description}}
{{country_of_origin}}
{{hs_code}}

3. Point the agent at your products and generate

Tell the agent to pull products from your store (Shopify MCP server or Admin API, GraphQL or REST). If it has no Shopify access, export products as CSV from Shopify Admin (Products, Export) and paste that in. Note: CSV exports do not include metafields, so for metafield-driven catalogs an Admin API connection is the way to go. Then prompt:

Agent prompt
Fetch all active products from my Shopify store,
including the "wholesale" metafields.
(Or: "Here is my product export:" and paste the CSV.)

First, ingest this template:
https://drive.google.com/uc?export=download&id=YOUR_FILE_ID

Then generate one DOCX catalog page per product using
generate_batch. Map fields like this:
- product_title     → title
- variant_sku       → variants[0].sku
- retail_price      → variants[0].price (format with currency)
- wholesale_price   → metafields.wholesale.unit_price
- min_order_qty     → metafields.wholesale.min_order_qty
- lead_time         → metafields.wholesale.lead_time
- description       → body_html (strip HTML tags)
- country_of_origin → metafields.wholesale.country_of_origin
- hs_code           → metafields.wholesale.hs_code

The agent calls generate_batch and returns a ZIP with one DOCX page per product. Merge them in Word for a complete catalog, or distribute individually to buyers.

Scaling up

generate_batch accepts up to 500 records per call. For catalogs larger than 500 products, tell the agent to split into chunks and call generate_batch once per chunk.

Tips

Tips for Shopify Workflows

  • Let the agent inspect the template first: After create_template_from_docx, ask the agent to call get_template so it can see the variable schema before mapping. This prevents mismatched field names.
  • Use check_credits before large batches: Tell the agent to call check_credits before generating. It will warn you if your balance is too low. Each DOCX costs 1 credit; each PDF costs 2 credits.
  • Keep one template per document type: Create separate templates for certificates, invoices, and catalogs rather than one generic template. Narrower variable sets make agent prompts simpler and reduce errors.
  • Refresh expired download links: Signed download URLs expire after 1 hour by default. Call refresh_document_url with a documentId to get a fresh URL without consuming credits.
  • Automate via Shopify Flow: For fully automatic generation on new orders, combine Shopify Flow (order created trigger) with a webhook calling the BulkRender REST API directly. Use the MCP approach for ad-hoc or one-off batches.

Ready to start?

Create an account, upload your first template, and generate your first document in under five minutes.