Spritesheet Forge MCP hosted

A remote Model Context Protocol server for game-dev spritesheet workflows. Connect it to Claude or any MCP-compatible AI client to pack, split, trim, and animate sprites through natural language — no local tools required.

MCP endpoint: https://mcp.clawstudiouo.com/mcp  |  GitHub: LAXY9887/Game-Dev.-Spritesheet-Forge

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "spritesheet-forge": {
      "type": "http",
      "url": "https://mcp.clawstudiouo.com/mcp"
    }
  }
}

Claude Code (CLI)

claude mcp add spritesheet-forge --transport http https://mcp.clawstudiouo.com/mcp

On first use, your MCP client will open a GitHub login page. Approve access and the session is stored for 30 days — no further action needed.

Authentication

Uses GitHub OAuth 2.1 with PKCE. MCP clients (Claude Desktop, Claude Code) run the flow automatically.

To get a Bearer token manually (for curl, benchmark scripts, or custom integrations):

curl -O https://mcp.clawstudiouo.com/get-token.py && python3 get-token.py

The script registers an OAuth client, opens your browser for GitHub login, prints the token, and saves it to ~/.spritesheet-forge-token. Requires Python 3 (pre-installed on macOS/Linux).

Token lifetime: 30 days. OAuth discovery: /.well-known/oauth-authorization-server

File Input Rules

All file / files parameters accept three input types:

Tool Output Format

Every tool returns a JSON object in content[0].text:

{
  "url": "https://mcp.clawstudiouo.com/output/output-abc123.png",
  "expires_at": "2026-05-05T13:00:00.000Z",
  "content_type": "image/png",
  "size_bytes": 516432,
  "quota": { "used": 4, "limit": 100, "reset_at": "2026-06-01T00:00:00.000Z" }
}

Pass url directly as file input to the next tool. The output URL is also a direct browser-viewable download link.

Available Tools

server_info — Runtime configuration

Returns upload URL, TTL, file size limits, and encoding rules. Call this first when working with large files or building chained workflows. No parameters required.

gif_to_spritesheet — GIF → spritesheet PNG

gif_to_frames — GIF → individual PNGs (ZIP)

spritesheet_to_animation — Spritesheet PNG → animated GIF/WebP

Grid mode: provide columns + rows. Cell mode: provide cell_width + cell_height.

frames_to_animation — PNG frames → animated GIF/WebP

png_to_spritesheet — Multiple PNGs → spritesheet

split_spritesheet — Spritesheet → frames + atlas JSON

Grid mode: provide columns + rows. Cell mode: provide cell_width + cell_height.

trim_png — Crop transparent edges

Agent Workflow Guide

Chaining tool outputs

Pass the url from one tool directly as file input to the next — no re-encoding needed. Example chain:

gif_to_spritesheet → split_spritesheet → frames_to_animation

The server reads chained URLs directly from its own storage with no HTTP overhead.

Token for the upload endpoint

MCP clients (Claude Desktop, Claude Code) store their token in an encrypted internal store — there is no config file or keychain entry you can read. Run the one-line helper instead:

curl -O https://mcp.clawstudiouo.com/get-token.py && python3 get-token.py

This downloads and runs the OAuth helper script (Python 3, no dependencies). It opens a GitHub login page, then prints and saves the token to ~/.spritesheet-forge-token. Pass the token to the agent: "Here is my upload token: Bearer <token>"

If the user cannot obtain a token, ask them to provide the file as a public HTTPS URL instead.

TTL in long workflows

All output URLs expire 1 hour after creation. If a multi-step workflow spans more than one hour, re-run the step that produced the stale URL rather than retrying with it.

Limits & Quotas

Common Errors

GitHub — MIT License