mcp-pixel-img
Allows fetching records from an Airtable datasource and writing back generated image data via webhook.
Allows fetching records from a Baserow datasource for use in image generation templates.
Allows listing available Google Fonts for use in HTML/CSS templates.
Allows fetching records from a Supabase datasource for use in image generation templates.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-pixel-imgGenerate an image from template 'social' with text=Hello and background=blue"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-pixel-img
MCP server for pixel-img — expose the pixel-img API as MCP tools over HTTP/SSE for remote hosting (Coolify, Railway, Fly.io, etc.).
What is this?
pixel-img is a Next.js API that generates images (PNG/JPEG/WEBP) from HTML/CSS templates using Puppeteer. This MCP server wraps that API so Claude can use it directly as tools — generate social media visuals, bulk-process Airtable records, manage templates and galleries, and more.
Unlike the built-in stdio MCP (bundled inside pixel-img), this server uses SSE transport so it can be hosted remotely and shared across multiple Claude instances.
Related MCP server: Banana Image MCP
Tools exposed
Tool | Description |
| List templates with optional search/category/favorite filters |
| Get a template by ID |
| Create a new template (supports |
| Update an existing template |
| Generate an image from raw HTML/CSS |
| Generate from a saved template, with optional Airtable write-back |
| Generate one image per datasource record, save to gallery |
| List configured datasources (Airtable, Baserow, Supabase) |
| Fetch all records from a datasource |
| Get a specific record by index or field value |
| List image galleries |
| Create a new gallery |
| List social media presets with dimensions |
| List available Google Fonts |
| Check pixel-img instance status |
Deploy on Coolify
1. Add the repo to Coolify
Source:
https://github.com/Oliviercreativ/mcp-pixel-imgBuild pack: Dockerfile
Port:
3001
2. Set environment variables
Variable | Required | Description |
| Yes | Your pixel-img base URL (e.g. |
| Yes | Your |
| Recommended | Bearer token to protect the SSE endpoint |
| Optional | For Airtable write-back via webhook |
| Optional | Default: |
3. Deploy
Coolify will build the Docker image and start the server. The SSE endpoint will be available at:
https://your-coolify-domain/sseConnect Claude to this server
Add this to your ~/.claude.json (Claude Code):
{
"mcpServers": {
"pixel-img": {
"type": "sse",
"url": "https://your-coolify-domain/sse",
"headers": {
"Authorization": "Bearer YOUR_MCP_SECRET"
}
}
}
}If MCP_SECRET is not set, omit the headers block.
Quick start with npx
PIXEL_IMG_URL=https://pixel-img.vercel.app \
PIXEL_IMG_API_KEY=your_api_password \
MCP_SECRET=your_secret \
npx mcp-pixel-imgRun locally (from source)
# Clone and install
git clone https://github.com/Oliviercreativ/mcp-pixel-img
cd mcp-pixel-img
npm install
# Configure
cp .env.example .env
# Edit .env with your values
# Development (hot reload)
npm run dev
# Production build
npm run build
npm startThe server listens on http://localhost:3001 by default.
Endpoints
Endpoint | Description |
| SSE stream — Claude connects here |
| MCP message relay |
| Health check (no auth required) |
Architecture
Claude Code / Claude.ai
│ SSE connection
▼
mcp-pixel-img (this server, hosted on Coolify)
│ REST API calls (Bearer token)
▼
pixel-img API (hosted on Vercel)
│
▼
Neon Postgres + Puppeteer/ChromiumLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Oliviercreativ/mcp-pixel-img'
If you have feedback or need assistance with the MCP directory API, please join our Discord server