Sprixen MCP Server

What it is

Sprixen runs a native Model Context Protocol server with 47 tools, reachable over Streamable HTTP at https://api.sprixen.com/v1/mcp. Every tool call authenticates with your API key in the header Authorization: Bearer spx_live_... and runs through the same controllers, DTO validation, credit accounting and ownership checks as the REST API and the app itself, an agent calling generate_sprite gets exactly what a human clicking Generate would get.

Get a key

New to Sprixen: create a free account (6 credits, no card) and land straight on the key screen with the install command ready.

Keys look like spx_live_{random} and are shown once, at creation. Manage and revoke keys any time under Settings › API.

Install

Pick your client, paste your key (or leave the placeholder and swap it in after), copy the snippet.

claude mcp add --transport http sprixen https://api.sprixen.com/v1/mcp \
  --header "Authorization: Bearer spx_live_YOUR_KEY"

Teach your agent

Connecting the server gets the tools listed; it doesn't teach the agent the workflow (create one project per game, generate the character before animations, poll instead of resubmitting, export at the end). Install the Sprixen skill so your agent knows this up front.

Claude Code / any agent reading SKILL.md

mkdir -p ~/.claude/skills/sprixen && curl -fsSL https://sprixen.com/skills/sprixen/SKILL.md \
  -o ~/.claude/skills/sprixen/SKILL.md

Cursor rule

mkdir -p .cursor/rules && curl -fsSL https://sprixen.com/agents/sprixen.mdc \
  -o .cursor/rules/sprixen.mdc

Codex / generic agents (AGENTS.md)

curl -fsSL https://sprixen.com/agents/AGENTS.md >> AGENTS.md

Prefer reading the raw source first? /skills/sprixen/SKILL.md and /agents/AGENTS.md are plain Markdown, open them in a browser or fetch them from any script.

Starter project

A minimal Phaser 3 game with no art in it. Open the folder in Claude Code or Cursor, connect the MCP server above, and ask for a character, the agent generates it, exports it, and drops it into assets/character/.

Godot addon

A Godot 4 editor addon that asks for your Sprixen key and imports generated characters as SpriteFrames directly into your project. Download the addon (drop into res://addons/sprixen/and enable it under Project Settings › Plugins).

Tools

The catalogue below covers the most-used shortcuts. Everything else in the product, RPG adventures, parallax, Sprixen Live, VFX Foundry setup and more, is reachable through list_api_operations / describe_api_operation / call_api.

Credits and limits

Errors

Every error carries a stable code and an actionable hint, an agent should branch on code, never parse message. A hint always says what to do next, and sometimes a URL to hand to the human it's working for.

{
  "statusCode": 402,
  "message": "Insufficient credits: animation costs 4 and you have 1.",
  "error": "Payment Required",
  "code": "INSUFFICIENT_CREDITS",
  "hint": {
    "action": "upgrade",
    "url": "https://sprixen.com/settings/billing",
    "details": { "required": 4, "available": 1 }
  }
}

On INSUFFICIENT_CREDITS, stop and tell the human the upgrade URL, don't retry, and don't silently downgrade to a cheaper operation without asking.

FAQ