instruktlabs/kiln/kiln-hosted

Work with hosted Kiln

Use the connected Kiln tools for the requested asset work. Account connection and sign-in belong to the host and Kiln website; never ask for a password, token or code in chat. If the connection is unavailable, explain that step without pretending a local installation can access the hosted account.

Read the program contract before authoring new source. kiln_discover retrieves geometry helpers, examples and input shapes; kiln_capabilities reports hosted runtime facts. Use the tool schemas currently exposed by this connection. Renderer setup and local CLI instructions in general engine references are not steps for this hosted workflow.

Create and review

Match the brief's subject, scale, style and destination. Standalone assets need no project. Use geometry recipes for construction, curved surfaces and joints that must fit or move; search Discovery for unfamiliar helper contracts. Preserve experimental labels and limitations in the catalog. The authoring frame is metres, +X forward, +Y up, +Z right.

Submit new source once to kiln_validate or kiln_render, then copy the returned programRef exactly for later reads, edits and views, including after a failed build. Use kiln_source to obtain exact anchors and kiln_edit for revisions; keep the new reference and inspect build success separately from edit success.

Inspect returned images and structural findings against the brief. Select camera views that answer a concrete shape, joint, interior or motion question. Use exact returned part paths and numeric inspection for required fit or clearance. Read viewFidelity: a CPU fallback can establish shape, not PBR material appearance. Do not claim material quality or destination performance from a passing structural check or an unavailable view.

Hosted calls use quotas. Do not repeat an unchanged render without a new review question. On admission refusal or a quota error, report the limit and preserve existing references; do not switch accounts or keep retrying to evade it.

Materials and saved work

For library materials, use kiln_material_search with scope: 'all', 'presets' or 'saved', and kiln_material_get to read exact saved resources. kiln_material_create accepts a definition with kind: 'preset' or 'procedural'; kiln_material_import retains an imported resource. Read their current schemas and Discovery shapes; supply known provenance and licensing rather than inventing it. Carry the same materialId/revisionId dependency pins through each render, edit, inspection and save that needs them. A program reference alone does not supply material context.

Use kiln_assets_collections to list destinations and kiln_assets_search to browse saved assets. Omit collection to search all configured collections, or select one explicitly. kiln_assets_get reads a selected revision and its downloads; kiln_assets_restore returns its exact source reference for editing. Preserve the collection, asset ID and revision ID together. The hosted presentation uses these domain operations from the shared engine contract; follow their advertised schemas.

Deliver the requested result

For a requested saved or downloadable asset, save the reviewed final programRef with kiln_save, using the requested collection or the documented default. For a revision, supply its asset ID and parent revision so earlier work stays intact. Use the same material dependencies and reviewed backdrop. Do not save every draft or save a preview-only exploration unless the user requested persistence.

Use kiln_present on the exact saved revision when the host supports an interactive viewer, including ChatGPT; a text download link alone does not display that viewer. Use kiln_export for the requested files or editable bundle. Return actual download links from the result; they require the owning browser account and expire. Get fresh links by reopening the saved revision when needed. Present an interactive card only when the host supports it; otherwise use the supplied links/resources. Never invent public links or claim native attachment support.

Report the result, what was reviewed and any remaining limitation. Unsaved work expires after seven days. Saved assets remain within quota until deleted; account and deletion controls are on the Kiln website, not additional hidden MCP tools.