API reference

The engine API.

Every operation Hue Draw can perform, and the vocabulary Hue Grow speaks from — read as data, not documentation about the data.

Base & auth

One MCP endpoint, not a REST surface — the tool is named in the body. The same seat token used on the index API: the engine and the index are one account, never two.

POST https://api.chromaticcoherence.ai/mcp

Authorization: Bearer <seat_token>

Content-Type: application/json

{"method":"tools/call","params":{"name":"cc_grow"}}

The three calls

cc_shelf · free

The shelf, and any scene on it

The org’s library of grown work. With no arguments: every scene, plus your own canvas. With a scene_id: that scene’s log, whole and in order. Reading is free — growing is what meters.

{
  "scene_id": 12
}

cc_grow · 4 units

Speak, and it grows

A plain-word description grown onto your canvas, appended to your org’s existing world.

{
  "prompt": "a low reef",
  "scene": "reef-study"
}

cc_use · 4 units

Grow from an asset

Name a scene from the shelf and its live operations land on your canvas under your name. The source is never touched.

{
  "from_scene": 12
}

Refusals

Ask for something the vocabulary cannot reach and the engine says so, verbatim, rather than inventing it.

{
  "grounded": false,
  "kind": "unground",
  "unmatched": ["rainstorm", "wets"],
  "recorded": true,
  "persisted": false,
  "note": "None of your words reach the engine's vocabulary yet.
           Your ask is recorded as hunger — the roadmap grows
           from exactly this."
}