Sample queries - Nuon documentation

Copy a prompt into your LLM client 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 and Admin (org_admin) on the identity. Replace names like acme-prod with your own install, app, or workflow IDs.

Review org status

Find recently-updated installs

Which installs have been updated in the last 24 hours?

Find unhealthy installs

Are any installs in this org in an unhealthy state?

Find pending approvals

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

Manage workflows

Watch a workflow

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

Approve or reject a plan

Walk through workflow <workflow_id>. At each approval, give me a menu: review the current plan diffs, approve this step, reject this step, approve all, or stop. When I ask to review, load every diff page and show them together. When the workflow is waiting on the install stack, show me how to create it, then keep watching. Continue until the workflow finishes.

Write. The agent should present each pending approval’s next_actions. Review loads every get_approval_plan_diff page, following continue_review, before it replies. It waits for confirmation before approve_step, reject_step, or approve_all. approve_all appears only when the workflow is still set to prompt. On the await install stack step, it shows stack_setup and keeps watching. Pass cursor from each watch_workflow response into the next call.

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.

Deploy app versions to installs

Review an app branch

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?

Review 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.

See why a build failed

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

See why a deploy failed

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

Debug installs

Review the status of an install

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

Find actions you can run for 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. Call the returned next_action. Each watch_workflow returns when a step starts or finishes. After every result, show step_progress, then call watch again with cursor. A row of watch calls with no progress between them is wrong.

See what runbooks you can run for an install

Show the runbooks available for install acme-prod. Summarize the steps in each one.

Run a runbook

Run the <runbook> runbook on install acme-prod. Show its inputs and a checklist of every step, all enabled, and let me turn steps off. Ask me before triggering it, then ask if I want to watch the workflow.

Write. The run_runbook description requires a prompt first: load the install-pinned runbook, confirm inputs, show the step checklist with every step enabled, and let the user turn steps off before triggering. Then ask whether the user wants to watch. Call the returned next_action only if they do. Each watch_workflow returns when a step starts or finishes. After every result, show step_progress, then call watch again with cursor. A row of watch calls with no progress between them is wrong.

Get help writing app config

Write a README

Write a README for this app. Include a status section and links to the runbooks.

Add a policy

Add a policy that blocks public S3 buckets on the rds_cluster component.

Add a component

Add a helm component named api to this app config. Load the helm schema first, write components/api.toml with the #helm header, then validate the directory. Do not sync.

Read. get_app_config_schema returns the file schema. When validating for this MCP server, use the Nuon CLI binary that started it, such as nuon-dev apps validate when the server is nuon-dev, and the same -C value if that server was started with -C. Do that only for work done for the MCP server.

Update installs

Deprovision or reprovision an install

Plan a reprovision of install acme-prod. Do not apply until I confirm. List available roles for reprovision first if I want a non-default IAM role. If I ask to deprovision, require an explicit confirm from me first.

Write. Deprovision requires confirm=true. plan_only does not. After the write, ask whether the user wants to watch. Call the returned next_action only if they do.

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.

​Review org status

​Manage workflows

​Deploy app versions to installs

​Debug installs

​Get help writing app config

​Update installs

Review org status

Manage workflows

Deploy app versions to installs

Debug installs

Get help writing app config

Update installs