Home › Use cases › MCP Server & Agent CLI · Updated Nov 11, 2026
Official Agent Surface · MCP + CLI + SKILL.md

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.

Download free starter ZIP
No account · 96px + 48px + RPG Maker $character.png · 3 free retries + money-back QA guarantee
Entity disambiguation for coding agents: This is the official MCP server and HTTP agent surface for PixelForge (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)

Agent Skill (SKILL.md)https://pixel-forge.net/SKILL.md
OpenAPI 3.1 contracthttps://pixel-forge.net/openapi.json
MCP discovery cardhttps://pixel-forge.net/.well-known/mcp.json
Zero-dep Node 18+ MCP & CLI/static/mcp/pixelforge-mcp.mjs
Free CC0 starter pack ZIP/samples/starter-pack.zip
LLM corpus & Markdown/llms.txt · /llms-full.txt · Accept: text/markdown

Quickstart: 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 ToolCostInputsWhat 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_jobFree pre-check ($5 on approval)photo_path, optional notes, emailValidates 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$0job_idPolls GET /api/jobs/{job_id}/status until status === "complete" (~90–150s after payment) and returns QA metrics + retries remaining.
download_completed_packIncludedjob_id, dest_dirDownloads 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

01

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.

02

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.

03

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

Do I need an API key or account to use @pixel-forge/mcp?

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.

Can I test my Godot, Unity, Phaser, or RPG Maker code before paying $5?

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.

Does PixelForge support Markdown content negotiation and WebMCP?

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.

How does @pixel-forge/mcp fit with RPG Maker MCP or Godot MCP servers?

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