
PixelForge
Forge pixel art sprites, animations, tilesets and game assets with Google Gemini.
- GitHub stars
- 6
- tools
- 8
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Nov 6, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
forge_spriteGenerate a single pixel art sprite with automatic post-processing (crop, bg removal, downscale, square padding).
Generate a single pixel art sprite with automatic post-processing (crop, bg removal, downscale, square padding).
No parameter schema in public metadata yet.
forge_animationGenerate animation frames as individual, ready-to-use frame PNGs.
Generate animation frames as individual, ready-to-use frame PNGs.
No parameter schema in public metadata yet.
forge_backgroundGenerate a full game background — no cropping, outputs the image as-is.
Generate a full game background — no cropping, outputs the image as-is.
No parameter schema in public metadata yet.
forge_thumbnailGenerate a game thumbnail/screenshot. Pass references for visual consistency with your sprites.
Generate a game thumbnail/screenshot. Pass references for visual consistency with your sprites.
No parameter schema in public metadata yet.
forge_tilesetGenerate a seamless, tileable square texture for terrain, floors and walls. No background removal — the texture fills the whole canvas.
Generate a seamless, tileable square texture for terrain, floors and walls. No background removal — the texture fills the whole canvas.
No parameter schema in public metadata yet.
forge_item_kitGenerate up to 16 related sprites in one batch. Items are drawn together on a grid for visual consistency, then split into individual PNGs.
Generate up to 16 related sprites in one batch. Items are drawn together on a grid for visual consistency, then split into individual PNGs.
No parameter schema in public metadata yet.
process_spritePost-process an existing PNG — background removal, auto-crop, sprite sheet splitting.
Post-process an existing PNG — background removal, auto-crop, sprite sheet splitting.
No parameter schema in public metadata yet.
optimize_spriteDownscale oversized AI images to true pixel art resolution using area-averaging (not blurry bilinear).
Downscale oversized AI images to true pixel art resolution using area-averaging (not blurry bilinear).
No parameter schema in public metadata yet.
Sponsors
Configuration
GEMINI_API_KEY*secretGoogle Gemini API key (https://aistudio.google.com/apikey)
Readme
pixelforge-mcp
MCP server that forges pixel art sprites & game assets using Google Gemini — generate, crop, split & process, all from your AI assistant.
Features
- AI-powered generation — sprites, animations, backgrounds, thumbnails, tilesets and item kits via Google Gemini
- Smart post-processing — background removal, auto-crop, pixelation downscale, square padding
- Chroma key transparency —
background: "chromakey"generates on pure green and keys it out in HSV space for clean edges - Sprite sheet splitting — auto-detect and split sheets into individual frames
- Style presets — neon, retro, gameboy, snes, clean
- Pure PNG pipeline — zero-dependency PNG encoder/decoder, no native modules
- Reference matching — pass existing sprites to match visual style
Installation
Claude Code (CLI)
claude mcp add pixelforge npx pixelforge-mcp@latest \
--env GEMINI_API_KEY=your-api-key
Claude Code (Plugin)
/plugin marketplace add freema/pixelforge-mcp
/plugin install pixelforge-mcp
Restart Claude Code to load the MCP server (check with /mcp).
Claude Desktop
Details
- Repository
- github.com/freema/pixelforge-mcp
- Categories
- AI & LLM Tools, Design & Creative
- Package
pixelforge-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active