Skip to main content

run_lifecycle_operation

Executes a StackQL EXEC lifecycle operation -- the non-CRUD provider actions (start/stop a VM, rotate a key, trigger a workflow, etc.). Real side effects.

Gated by the server mode:

ModeLifecycle EXEC
read_onlyrefused
safe (default)needs approval (elicitation)
delete_safeneeds approval
full_accessallowed

When approval is needed and the client did not advertise elicitation, the call is refused.

See also: [ MCP overview ] [ run_mutation_query ] [ describe_method ] [ EXEC language spec ]


Inputs

ArgumentRequiredDescription
sqlYesA StackQL EXEC statement targeting a lifecycle method.

Output

RendererShape
KV{messages: [...], timestamp}

Example

Try this prompt with any elicitation-capable MCP client with the StackQL MCP server registered:

The Compute instance web-01 in us-central1-a  
(project my-project) is stuck. Please stop it.

The MCP client will surface an approval prompt before the operation is dispatched, unless the server is running in full_access mode.

Here's an example in Claude Desktop: