@pixeldojo/mcp 0.9.0 → 0.10.0

package/README.md

@@ -46,28 +46,40 @@ Restart your agent. You'll see 16 new tools.
 
 | Skill | What it does |
 |---|---|
-| `pixeldojo:generate` | Any prompt → image or video. Picks the best model, or pass any apiId. |
-| `pixeldojo:edit` | Change an existing image with a text instruction (multi-image capable). |
-| `pixeldojo:character` | Consistent characters across shots. |
-| `pixeldojo:storyboard` | Multi-shot scenes from one brief. |
-| `pixeldojo:upscale` | Enhance any image, up to 16×. |
-| `pixeldojo:audio` | Full audio scenes: dialogue + effects + music in one clip (Seed Audio 1.0). |
-| `pixeldojo:library` | Search your media library: saved My Media + recent generations. |
-| `pixeldojo:save` | Save a result to My Media permanently (outputs otherwise expire in 24h). |
-| `pixeldojo:save_workflow` / `run_workflow` / `list_workflows` | Save a multi-step chain once, run it by name from any chat. |
-| `pixeldojo:upload` | Local file → 24h temp URL, for reference inputs. |
-| `pixeldojo:from_url` | Product page URL → structured product info. Free. |
-| `pixeldojo:campaign` / `campaign_status` | One product URL → hero + lifestyle set + optional video. |
-| `pixeldojo:status` | Poll long-running jobs after a 30s sync handoff. |
+| `pixeldojo_generate` | Any prompt → image or video. Picks the best model, or pass any apiId. |
+| `pixeldojo_edit` | Change an existing image with a text instruction (multi-image capable). |
+| `pixeldojo_character` | Consistent characters across shots. |
+| `pixeldojo_storyboard` | Multi-shot scenes from one brief. |
+| `pixeldojo_upscale` | Enhance any image, up to 16×. |
+| `pixeldojo_audio` | Full audio scenes: dialogue + effects + music in one clip (Seed Audio 1.0). |
+| `pixeldojo_library` | Search your media library: saved My Media + recent generations. |
+| `pixeldojo_save` | Save a result to My Media permanently (outputs otherwise expire in 24h). |
+| `pixeldojo_save_workflow` / `run_workflow` / `list_workflows` | Save a multi-step chain once, run it by name from any chat. |
+| `pixeldojo_upload` | Local file → 24h temp URL, for reference inputs. |
+| `pixeldojo_from_url` | Product page URL → structured product info. Free. |
+| `pixeldojo_campaign` / `campaign_status` | One product URL → hero + lifestyle set + optional video. |
+| `pixeldojo_status` | Poll long-running jobs after a 30s sync handoff. |
 
 Generation skills take a `model` field for whitelist-checked overrides. Pass
 any apiId from the [API Platform catalog](https://pixeldojo.ai/api-platform).
 
+**References.** `image_url` is for stills, `video_url` for a source clip, and
+an audio URL can ride along in either. Each lands in the field the chosen
+model actually declares for that kind of media. A clip or a track with no
+`model` named routes to an engine that can read one; naming a model that
+can't gets you the working engine plus a one-line note saying so.
+
+**Model-specific settings.** Anything the shared inputs don't cover — a seed,
+a negative prompt, a resolution tier, a quality toggle — goes in `params`
+under that model's own field name, in the same call that names the `model`
+(`{"model": "seedance-2-reference", "params": {"resolution": "1080p"}}`). A
+wrong field comes back named with its allowed values and nothing is charged.
+
 ## How long jobs work
 
 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
+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.
 
@@ -89,7 +101,7 @@ or stderr.
 ## Telemetry
 
 Every API call sets `x-pixeldojo-source: mcp/<version>` and
-`x-pixeldojo-skill: pixeldojo:<name>` headers so PixelDojo's Tool Health
+`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.