@pixeldojo/mcp 0.1.0

package/README.md

@@ -0,0 +1,84 @@
+# @pixeldojo/mcp
+
+PixelDojo MCP server. One install for Claude Code, Cursor, OpenClaw, and any
+other [Model Context Protocol](https://modelcontextprotocol.io) host.
+
+Five named tools, 130+ models, async by default.
+
+## Quick start
+
+```bash
+# 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`):
+
+```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](https://pixeldojo.ai/api-platform).
+
+## 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.

package/bin/pixeldojo-mcp.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// Tiny launcher. The real CLI logic lives in dist/cli.js (built by tsup).
+// This file stays intentionally minimal so we don't bundle anything heavy
+// for `npx @pixeldojo/mcp` cold-start latency.
+import('../dist/cli.js').then((m) => m.main()).catch((err) => {
+  // eslint-disable-next-line no-console
+  console.error('[pixeldojo-mcp] Failed to start:', err && err.message ? err.message : err);
+  process.exit(1);
+});