@pixeldojo/mcp

PixelDojo MCP server. One install for Claude Code, Cursor, OpenClaw, and any other Model Context Protocol host.

Five named tools, 130+ models, async by default.

Quick start

# 1. Get an API key
open https://pixeldojo.ai/api-platform/api-keys

# 2. Set it
export PIXELDOJO_API_KEY=pd_your_api_key_here

# 3. See install snippets for your editor
npx @pixeldojo/mcp init

Add to your editor's MCP config (e.g. ~/.config/claude-code/mcp.json):

{
  "mcpServers": {
    "pixeldojo": {
      "command": "npx",
      "args": ["-y", "@pixeldojo/mcp"],
      "env": {
        "PIXELDOJO_API_KEY": "pd_your_api_key_here"
      }
    }
  }
}

Restart your agent. You'll see five new tools.

Named skills

| Skill | What it does | Default model | |---|---|---| | pixeldojo:generate | Any prompt → image or video | google-nano-banana | | pixeldojo:character | Consistent characters across shots | ideogram-character | | pixeldojo:storyboard | Multi-shot scenes from one brief | veo-3.1 | | pixeldojo:upscale | Enhance any image | magnific-upscaler | | pixeldojo:status | Poll long-running jobs after a 30s sync handoff | — |

Each skill takes a model field for whitelist-checked overrides. Pass any apiId from the API Platform catalog.

How long jobs work

The four generation skills wait synchronously for up to 30 seconds. If the job is still running, they return { jobId, statusUrl } and the LLM follows up by calling pixeldojo:status with the same jobId. Polling uses exponential backoff (1s → 2s → 4s → 8s, capped) to keep load low on long jobs like LoRA training and 60-second video generation.

Errors

Every error includes the next action:

• Missing key → "Set PIXELDOJO_API_KEY. Get one at pixeldojo.ai/api-platform/api-keys."
• 401 → same.
• 402 / insufficient credits → "Top up at pixeldojo.ai/api-platform/buy-credits."
• 429 → "Rate limit hit. Try again in a few seconds."
• Wrong model override → lists the allowed models for the skill.

Privacy

API keys (pd_xxx tokens) are never written to logs. The redaction layer strips any matching token from every log message before it reaches stdout or stderr.

Telemetry

Every API call sets x-pixeldojo-source: mcp/<version> and x-pixeldojo-skill: pixeldojo:<name> headers so PixelDojo's Tool Health dashboard can attribute traffic separately. No personal data is sent beyond what the API call itself requires.

License

MIT.