read_look

What it does

• Read-only
• Idempotent
• Account required

Match a design instead of inventing one. This returns the saved ShotOps look on a project — the device, background and caption styling somebody tuned in the web app — along with the latest version, the held version if there is one, and the whole version list. Styling only: no screenshots, no caption words, no credentials.

You can ask: “Show me the Look the designer settled on for Tidebook.”

Input

• projectstringoptionalat least 1 character

  Project id or exact name. Omit for the most recently edited project.

Result

• okbooleanoptional

• savedbooleanoptional

• projectobjectoptional

  • idstringrequired

  • namestringrequired

• versionnumberoptional

• lookobjectoptional

• layoutobjectoptional

• messagestringoptional

Example

That request maps to this call:

{
  "name": "read_look",
  "arguments": {
    "project": "Tidebook 2.4 launch"
  }
}

The look object, the version it came from, which version is held, and the list of versions with their timestamps.

Access and cost

• Needs an account. Not available to an anonymous hosted caller.
• Free. Reading spends no cloud credits.

When it refuses

The project has no saved look.

Nothing was ever saved on it. Compose a look yourself — describe_look has the catalog — and save_look once the user likes it.

The project name did not resolve.

Names are matched exactly. Use the project id from save_project or from the URL in the web app.

Where this fits

• Reading a project before you change it

What the agent is told

The title and description the server publishes on tools/list — this is the copy a model chooses between, reproduced verbatim.