spritecook-mcp

Connect your AI agent (Cursor, VS Code, Claude, Codex, Grok Build, and others) to SpriteCook for AI-powered pixel art and game asset generation.

Quick Setup

npx spritecook-mcp setup

This will:

1. Detect your installed AI clients, including Grok Build
2. Authenticate with an API key where required; Grok Build uses host-managed OAuth
3. Configure MCP connections automatically
4. Install an optional agent skill for smarter AI integration

The optional skills include current guidance for asynchronous job polling, canonical sprite_url output, model discovery, GPT-Image-2 quality settings, guided character workflows, saved presets, multi-image style guide references, local-file uploads, background cleanup, asset organization and recovery, and Godot-ready character exports.

What You Get

After setup, your AI agent can generate pixel art and game assets directly:

"Generate a 64x64 pixel art sword sprite"

"Create a character sprite sheet for my platformer game"

"Make a set of potion icons with transparent backgrounds"

"Use my character preset for a new idle sprite"

"Import this local boss PNG, then animate it with a slow idle motion"

"Remove the background from this character asset and give me the transparent PNG"

"Rename the generated sword asset to Iron Sword Pickup"

Manual Configuration

If you prefer to configure manually, add this to your editor's MCP config:

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "spritecook": {
      "url": "https://api.spritecook.ai/mcp/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (.vscode/settings.json):

{
  "mcp": {
    "servers": {
      "spritecook": {
        "type": "http",
        "url": "https://api.spritecook.ai/mcp/",
        "headers": { "Authorization": "Bearer YOUR_API_KEY" }
      }
    }
  }
}

Grok Build (.grok/config.toml or ~/.grok/config.toml):

[mcp_servers.spritecook]
url = "https://api.spritecook.ai/mcp/oauth"
enabled = true
tool_timeout_sec = 6000

Open /mcps in Grok Build and authenticate spritecook. Grok stores and refreshes OAuth credentials without exposing them to the model. If tools do not appear, run grok mcp doctor spritecook and grok inspect.

The repository also includes a root .mcp.json for a Grok Build marketplace submission. Publishing the marketplace listing is a separate release step.

Environment Variables

• SPRITECOOK_API_URL - Override the API base URL (for local development)

Links

• SpriteCook - AI game asset generator
• API Documentation - Full API reference
• Get API Key - Sign up and manage API keys