Sample queries

Prompts to paste into an LLM client after Nuon MCP is connected.

Copy a prompt into Claude Code, Cursor, or Amp after MCP is connected. The client should pick tools from the catalog; you do not need to name them.

Write prompts need --allow-writes on the stdio proxy.

Replace names like acme-prod with your own install, app, or workflow IDs.

What's in this org?

What apps and installs are in this org? Summarize each install's app and status.

Variants: Show me installs for the payments app.

Status of an install

What's the status of install acme-prod? Include components, recent workflows, and anything unhealthy.

Pending approvals

Are there any pending workflow approvals in this org? For each one, tell me the install, workflow, and what is waiting.

Approve or reject a plan

Review the pending plan on workflow <workflow_id>. Summarize the change, then ask me before approving or rejecting it.

Write. The agent should inspect the workflow first and wait for your confirmation.

Why did this deploy fail?

Why did the latest deploy on install acme-prod fail? Pull the deploy and workflow step logs and quote the error.

Why did this build fail?

Why did the latest build for component <component> fail? Show the git ref and the relevant log lines.

Watch a workflow

Watch workflow <workflow_id> until it finishes. Tell me when the status changes and when it reaches a terminal state.

Actions on an install

What actions can I run on install acme-prod? For each one, say whether it can be triggered manually.

Run an action

Run the <action name> action on install acme-prod. Confirm the action with me before triggering it, then watch the workflow.

Write.

Runbooks

Show the runbooks for app <app>. Summarize the steps in each one.

Run a runbook

Run the <runbook> runbook on install acme-prod. Summarize its inputs and steps first, ask me before triggering it, then follow its workflow.

Write.

App branch overview

What's the latest on the default branch for app <app>? Did the last run succeed, what changed, and how far have install-group deploys gotten?

Requires the app-branches org feature.

Changes in a branch run or PR preview

What changed in the most recent run of the default branch for app <app>?

Variants: In the preview run for PR <number>, what changed? and Show progress for branch run <run_id>, including updated installs and what is left.

Preview a PR or git ref

Preview PR <number> for app <app> against install acme-prod. Use plan-only unless I ask you to apply. Follow the returned run_id and workflow_id, then summarize the result.

Write. Same as nuon apps branches preview. Ask before apply.

HTTP MCP cannot read the local workspace. For local toml, run nuon apps sync --branch <branch> --output agent first, then pass the resulting app_config_id.

Describe an install

Describe install acme-prod. Include what most recently updated it, its components, current health, and its rendered README.

Deprovision or reprovision

Plan a reprovision of install acme-prod. Do not apply until I confirm. If I ask to deprovision, require an explicit confirm from me first.

Write. Deprovision requires confirm=true. plan_only does not.

Inspect or update install inputs

What are the current inputs on install acme-prod? Propose an update for <input_name> and wait for my approval before writing it.

Write.

Retry a failed step

Workflow <workflow_id> failed. Tell me which step failed and whether it is retryable. If I say yes, retry it and watch until it finishes.

Write.

Cancel a workflow

Cancel in-progress workflow <workflow_id> on install acme-prod. Confirm with me first, then verify it stopped.

Write.