PixelForge MCP server, CLI & SKILL.md.
Wire game-ready 4-direction character sprites straight from Cursor, Claude Code, Windsurf, or Codex. Zero Node dependencies, zero API keys to provision, unblocked free starter pack at $0, and explicit human-in-the-loop Stripe approval for $5 custom portrait packs.
https://pixel-forge.net), the $5 portrait-photo-to-4-direction-walk-cycle pipeline. Looking for RPG Maker database/map MCP servers or PixelLab's text-prompt MCP? Use PixelForge alongside them: PixelForge supplies the identity-locked player/NPC character walk pack (including drop-in processed/rpgmaker/$character.png and processed/phaser/atlas_96.json).Machine-readable endpoints (all unblocked in robots.txt)
https://pixel-forge.net/SKILL.mdhttps://pixel-forge.net/openapi.jsonhttps://pixel-forge.net/.well-known/mcp.json/static/mcp/pixelforge-mcp.mjs/samples/starter-pack.zip/llms.txt · /llms-full.txt · Accept: text/markdownQuickstart: Cursor, Claude Code & Windsurf (60 seconds)
pixelforge-mcp.mjs uses only Node 18+ built-ins (fs, zlib, fetch, readline) — no node_modules install bloat and auditable in one file.
# 1. Grab the single-file MCP server / CLI into your project curl -fsSLO https://pixel-forge.net/static/mcp/pixelforge-mcp.mjs # 2a. Register in Claude Code claude mcp add pixelforge -- node "$(pwd)/pixelforge-mcp.mjs" # 2b. Or run directly as a CLI to scaffold your player movement at $0 node pixelforge-mcp.mjs starter-pack ./assets/player
For Cursor or Windsurf, drop this into .cursor/mcp.json:
{
"mcpServers": {
"pixelforge": {
"command": "node",
"args": ["./pixelforge-mcp.mjs"]
}
}
}MCP tools exposed by @pixel-forge/mcp
| MCP Tool | Cost | Inputs | What It Returns / Writes |
|---|---|---|---|
| download_free_starter_pack | $0 (CC0) | dest_dir (optional) | Downloads & extracts schema-v2 starter-pack.zip (96px + 48px sheets, 32 PNG frames, $character.png, Phaser atlas_96.json, manifest.json, AGENT.md) so the agent can wire & test movement immediately. |
| create_sprite_job | Free pre-check ($5 on approval) | photo_path, optional notes, email | Validates single-person face before payment, creates a job, and returns job_id + checkout_url for the user to approve $5 in Stripe Checkout. |
| get_sprite_job_status | $0 | job_id | Polls GET /api/jobs/{job_id}/status until status === "complete" (~90–150s after payment) and returns QA metrics + retries remaining. |
| download_completed_pack | Included | job_id, dest_dir | Downloads sprite-package.zip and extracts all sheets, frames, strips, sidecars, manifest.json, and AGENT.md directly into dest_dir. |
Recommended agent loop: prototype free, swap face last
Scaffold at $0
Agent calls download_free_starter_pack, reads AGENT.md + manifest.json, and builds the complete Godot 4, Unity 6, Phaser 3, or RPG Maker player controller with real assets.
Human approves $5
When movement feels crisp, agent calls create_sprite_job with your selfie and hands you the Stripe Checkout URL. Zero stored cards or surprise API bills.
Zero-code asset swap
Agent calls download_completed_pack into the exact same folder. Because every pack shares identical dimensions, row order, and foot_baseline_y, zero engine code changes.
Direct cURL / HTTP workflow (no MCP required)
Any agent with curl or WebFetch can read /SKILL.md and call the REST endpoints directly:
# Create a sprite job from a local portrait (validates face before payment) curl -sS -X POST https://pixel-forge.net/api/jobs \ -H "Accept: application/json" \ -F "photo=@./portrait.jpg" \ -F "notes=wearing dark hoodie and glasses" # Poll status after user completes checkout_url curl -sS https://pixel-forge.net/api/jobs/<job_id>/status # Download finished schema-v2 sprite-package.zip curl -fsSL https://pixel-forge.net/api/jobs/<job_id>/download -o sprite-package.zip
Frequently asked questions
No. download_free_starter_pack works immediately at $0 with zero authentication. Custom portrait jobs return a standard checkout_url so the human developer approves the one-time $5 Stripe payment in their browser — your coding agent never touches raw card details or runaway token balances.
Yes — that is our recommended workflow. Run node pixelforge-mcp.mjs starter-pack ./assets/player (or download /samples/starter-pack.zip) to wire and test a complete schema-v2 pack at $0. Swap in a custom portrait pack later without changing a single line of animation code.
Yes. Every public page on pixel-forge.net honors Accept: text/markdown with clean Markdown and Link discovery headers, and browser agents running in Chrome WebMCP environments can invoke registered navigator.modelContext tools directly on the homepage and browser tools.
Scene/editor MCP servers manipulate your engine's project tree (creating Actors, events, or CharacterBody2D nodes), while @pixel-forge/mcp produces the actual character sprite art — including processed/rpgmaker/$character.png (144×192) that drops straight into RPG Maker MV/MZ's img/characters/ directory.
Put anyone into your game.
$5 · one photo · 4-direction walk pack (96px, 48px, RPG Maker & Phaser atlas) · 3 free retries · no subscription
Make a sprite — $5