Reference

account_status

Whether this connection may produce store-ready output — asked before a long render.

View as Markdown

What it does

  • Read-only
  • Idempotent
  • No account needed

The pre-flight. It reports whether an account is signed in, its plan, trial and remaining cloud credits, what a preview costs on this connection, and — the field to branch on — whether production output is available: full-resolution renders and every bundle. When it is not, the reply carries a machine-readable next step and a sentence to relay. Call it first when the user asks for the real files, because a refusal after a long render wastes their time.

You can ask: “Check whether this connection can produce a store-ready bundle.”

It takes no arguments

Call it with an empty arguments object. There is nothing to configure, and nothing you pass changes what comes back.

Result

  • okbooleanrequired

  • connectionstringoptional

    one oflocalhosted

  • authenticatedbooleanoptional

  • planstringoptional

  • creditsobjectoptional

  • productionobjectoptional

    • availablebooleanrequired

  • messagestringoptional

Example

That request maps to this call:

{
  "name": "account_status",
  "arguments": {}
}

Whether this connection is hosted or local, whether it is signed in, the plan and trial state, the remaining cloud credits, the preview mode, and the production block with its next step and message.

Access and cost

  • Open to everyone on both doors: no account needed, and it answers honestly when there is none.
  • Free, and deliberately so: it spends no cloud credits, uses up no free preview, uploads nothing and writes nothing. Admitting it to the anonymous tier cannot be used to get free work out.
  • Previewing never depends on it, so keep rendering previews regardless of what it says.

When it refuses

It says production output is unavailable.
Relay the message and do the next step it names — sign in, choose a plan, upgrade or retry. Do not retry the production call until that step is done.
Cloud credits are exhausted.
That is a different condition from an entitlement refusal, with a different remedy. The reply distinguishes them; do not describe one as the other.
It reports a local connection.
Local rendering is free and unmetered, so cloud credits are not the constraint there. What is still gated is production output.

Where this fits

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.

Check what this connection can do

Free: whether this connection may render full-resolution panels and bundles, the plan, and the credit balance. A render checks this itself.