PixelForge
freema/pixelforge-mcp
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
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
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
