bulktemplates-mcp

bulktemplates-mcp

An MCP (Model Context Protocol) server that exposes the BulkTemplates API as tools for AI agents. Let Claude and other MCP clients browse templates, render social media images, and kick off batch jobs — all without leaving the chat.

Features

• Browse 80+ social media image templates (1:1, 4:5, 9:16, 16:9, 3:1)
• Render a single image and get back an inline PNG
• Run batch jobs of up to 1,000 images at once
• Override fonts per render
• Works with Claude Desktop, Cursor, and any MCP-compatible client

Requirements

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

Quick start

BULKTEMPLATES_API_KEY=bk_... npx bulktemplates-mcp

Claude Desktop setup

Add the server to your claude_desktop_config.json:

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

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop after saving.

Cursor / VS Code setup

Add to your MCP settings (.cursor/mcp.json or equivalent):

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

Environment variables

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

Available tools

list_templates

Browse available templates. Use summary: true for a fast overview.

list_templates(summary: true)
list_templates(ids: "quote-card,tweet-style,event-card")

get_template

Fetch full details of a template — including every field name and type needed to render it. Call this before render_image to discover what data keys to provide.

get_template(id: "quote-card")

render_image

Render a template and return an inline PNG image.

render_image(
  templateId: "quote-card",
  data: { "quote": "Ship it.", "author": "Ada Lovelace" },
  fontFamily: "playfair-display"   // optional
)

list_fonts

List all available font families for use as fontFamily overrides.

list_fonts()

create_batch_job

Start an async batch job. Provide an array of data rows (max 1,000); each row renders to one PNG.

create_batch_job(
  templateId: "announcement",
  rows: [
    { "headline": "Product launch", "date": "May 1" },
    { "headline": "Webinar", "date": "May 8" }
  ]
)

Returns a job ID. Use poll_batch_job to track progress.

poll_batch_job

Check the status of a batch job. When status is "done", the response includes file paths to all rendered PNGs.

poll_batch_job(id: "job_abc123")

Example agent workflow

• Discover — list_templates(summary: true) to browse what's available
• Inspect — get_template(id: "quote-card") to see required fields
• Render — render_image(templateId: "quote-card", data: {...}) to get a PNG
• Scale — create_batch_job(...) then poll_batch_job(...) for bulk output

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 template IDs: quote-card, tweet-style, event-card, testimonial, product-launch, podcast-episode, linkedin-banner, youtube-thumb, breaking-news-red, magazine-cover, and many more.

License

MIT