The official BulkTemplates SDK for Node.js — programmatic image generation API and MCP server in one package. Browse 80+ social media templates, render PNGs, and run batch jobs from your code or AI agent.

Two ways to use it

	Programmatic SDK	MCP Server
Use case	Scripts, apps, agents via code	Claude Desktop, Cursor, any MCP client
Import	`import { BulkTemplates } from 'bulktemplates'`	`npx bulktemplates-mcp`

Requirements

Node.js ≥ 18
A BulkTemplates API key — get one at bulktemplates.com/api

Installation

npm install bulktemplates

Programmatic SDK

import { BulkTemplates } from 'bulktemplates';

const bt = new BulkTemplates({ apiKey: 'bk_...' });

Templates

// Browse all templates (lightweight)
const list = await bt.templates.list({ summary: true });

// Filter by IDs
const picked = await bt.templates.list({ ids: 'quote-card,tweet-style' });

// Full template definition — shows field names needed for rendering
const tpl = await bt.templates.get('quote-card');

Render an image

// Returns a Buffer containing the PNG
const png = await bt.images.image('quote-card', {
  quote: 'Ship it.',
  author: 'Ada Lovelace',
});

// Save to disk
import { writeFileSync } from 'fs';
writeFileSync('out.png', png);

// Override font
const png2 = await bt.images.image('quote-card', data, {
  fontFamily: 'playfair-display',
});

Batch jobs

// Start a batch (max 1,000 rows)
const job = await bt.batch.create('announcement', [
  { headline: 'Product launch', date: 'May 1' },
  { headline: 'Webinar',        date: 'May 8' },
]);

// Poll until done
let status = await bt.batch.poll(job.id);
while (status.status !== 'done') {
  await new Promise(r => setTimeout(r, 2000));
  status = await bt.batch.poll(job.id);
}
console.log(status.files); // paths to rendered PNGs

Fonts

const fonts = await bt.fonts.list();
// [{ id: 'inter', name: 'Inter' }, { id: 'playfair-display', name: 'Playfair Display' }, ...]

Error handling

import { BulkTemplates, AuthenticationError, NotFoundError, RateLimitError } from 'bulktemplates';

try {
  const png = await bt.images.image('quote-card', data);
} catch (err) {
  if (err instanceof AuthenticationError) console.error('Bad API key');
  if (err instanceof NotFoundError)       console.error('Template not found');
  if (err instanceof RateLimitError)      console.error('Slow down');
}

MCP Server

Use with Claude Desktop, Cursor, or any MCP-compatible client. The server exposes 6 tools: list_templates, get_template, render_image, list_fonts, create_batch_job, poll_batch_job.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bulktemplates": {
      "command": "npx",
      "args": ["-y", "bulktemplates"],
      "env": {
        "BULKTEMPLATES_API_KEY": "bk_YOUR_KEY_HERE"
      }
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "bulktemplates": {
      "command": "npx",
      "args": ["-y", "bulktemplates"],
      "env": {
        "BULKTEMPLATES_API_KEY": "bk_YOUR_KEY_HERE"
      }
    }
  }
}

Run directly

BULKTEMPLATES_API_KEY=bk_... npx bulktemplates-mcp

API reference

`BulkTemplates(config)`

Option	Type	Required	Default
`apiKey`	`string`	Yes	—
`baseUrl`	`string`	No	`https://bulktemplates.com`

Resources

Resource	Method	Description
`bt.templates`	`list(opts?)`	List templates. `opts.summary` for lightweight, `opts.ids` to filter
`bt.templates`	`get(id)`	Full template definition with field names
`bt.images`	`image(templateId, data, opts?)`	Render PNG → `Buffer`. `opts.fontFamily` to override font
`bt.batch`	`create(templateId, rows)`	Start async batch job (max 1,000 rows)
`bt.batch`	`poll(id)`	Check job status; `files` array available when `status === 'done'`
`bt.fonts`	`list()`	All available font IDs

Error classes

Class	HTTP status	When thrown
`BulkTemplatesError`	any	Base class
`AuthenticationError`	401	Invalid or missing API key
`NotFoundError`	404	Template or job not found
`RateLimitError`	429	Too many requests
`ValidationError`	422	Bad request payload

Environment variables (MCP server)

Variable	Required	Default	Description
`BULKTEMPLATES_API_KEY`	Yes	—	Your API key
`BULKTEMPLATES_API_BASE`	No	`https://bulktemplates.com`	Override base URL

Template categories

80+ templates across social media, B2B, editorial, lifestyle, fitness, commerce, and events. Aspect ratios: 1:1 · 4:5 · 9:16 · 16:9 · 3:1

Example IDs: quote-card, tweet-style, event-card, testimonial, product-launch, podcast-episode, linkedin-banner, youtube-thumb, breaking-news-red, magazine-cover and many more.