Check the connection and report Painter, Python API, and project status.

Look at Painter. view="3d" is the model; view="window" includes the whole UI.

See every side: orbit the camera, capture each yaw angle, then restore the view.

zoom above 1 moves closer. A negative elevation looks up from below. focus is the [x, y, z] point to orbit, for close-ups of one part; it defaults to the model's center.

See one flattened channel as a flat texture, for example Roughness or Normal.

Close the open project; refuses unsaved work unless discard_unsaved=true.

Export the project mesh, with any Auto UV result, inside SP_MCP_EXPORT_ROOTS.

Return the current project path and texture-set names.

Validate a new project, typed import settings, context switch, and backup.

Back up an optional current project, create a typed project, and verify its file.

Read terminal state and file verification for an asynchronous project creation.

Overwrite and verify the current saved project after explicit confirmation.

Open an approved .spp, requiring a backup when the current project is dirty.

Report runtime-supported channels, blend modes, and version-sensitive features.

Audit texture sets, channels, layer hygiene, and outdated resources.

Inspect enabled bakers, UV tiles, and mesh-map assignments without starting a bake.

Inspect editable common parameters and one baker's typed property metadata.

Transactionally configure Texture Set, UV tile, common, and per-baker settings.

Assign sandboxed high-poly/cage meshes and related common baker settings.

Set or clear a Resource-typed common/per-baker input transactionally.

Capture a portable JSON baking preset without filesystem-backed properties.

Apply a captured baking preset transactionally after explicit confirmation.

Validate selected Texture Sets, mesh inputs, UV tiles, and expected mesh maps.

Preflight and start a cancellable multi-Texture-Set bake with result manifests.

Start an asynchronous mesh-map bake after explicit confirmation.

Return progress and terminal status for the latest or selected bake job.

Request cooperative cancellation of a running bake job.

Validate a mesh reload and preview texture-set and backup impact.

Back up and asynchronously reload a mesh after explicit confirmation.

Return status and texture-set changes for the latest mesh reload job.

List layers with stable UIDs, types, visibility, and optional group children.

Search layers by partial name, exact node type, and visibility.

Capture a detailed layer/effect snapshot with a deterministic SHA-256 digest.

Compare two layer snapshots by UID and report added, removed, and changed nodes.

Inspect a layer's Mesh/UVTile geometry mask and available elements.

Set a geometry mask using mesh names or standard UDIM numbers.

Create a Fill Layer, optionally with sRGB base color [r,g,b].

position is top, or above, below or inside reference_uid.

Create a layer group at the top, or above, below or inside reference_uid.

Create a Paint Layer at the top, or above, below or inside reference_uid.

Validate a recipe, resolve channels, and preview backup/mutation scope without editing.

Create a nested recipe atomically, optionally saving an approved .spp backup first.

Insert a Smart Material at the top, inside parent_uid, or relative to reference_uid.

Apply a Smart Mask resource to a layer using transactional mask insertion.

Set a Fill Layer's base color using its UID and sRGB [r,g,b] values.

Inspect a Fill layer's projection mode and common UV transformation.

Inspect a Fill layer's material or per-channel color/resource sources.

Inspect image inputs on Fill, Fill Effect, Generator, or Filter sources.

Connect a resource to a procedural image input or reset it to its default.

Inspect parameters and presets of a Fill, Fill Effect, Generator or Filter.

Use it to tune generators such as edge wear. Effect UIDs come from snapshot_layer_tree.

Update parameters of a Fill, Fill Effect, Generator or Filter; rolls back on failure.

Apply a named preset of a Fill, Fill Effect, Generator or Filter source.

List Anchor Point effects with owner and Texture Set context.

Connect an Anchor Point to one Fill channel or the complete material source.

Assign a Painter resource to one Fill channel, a whole material or a mask Fill.

A Fill inside a mask has no channels, so leave channel out for one.

Set Fill, UV, or Triplanar projection with transactional transform updates.

Configure UV, triplanar, planar, spherical, or cylindrical projection details.

Set and enable multiple uniform Fill channels, such as Roughness or Metallic.

Replace a Fill or Paint layer's active channel set by UID.

Add/update or remove a layer mask; backgrounds are reported by get_capabilities.

Insert Fill, Paint, Generator, Filter, Levels, Anchor, or Smart Mask into a mask.

Insert Fill, Paint, Generator, Filter, Levels or Anchor into a layer's content.

Tune a Levels effect, for example to push a mask's contrast.

channel picks what a content Levels affects, such as BaseColor or Roughness.

Rename a layer or group by UID.

Set visibility, opacity, or blend mode; channel defaults to BaseColor.

Select one or more layers in Painter by UID.

List built-in and shelf export presets without exporting files.

Resolve an export preset and preview its map names without writing files.

List curated engine export profiles and whether their Painter presets are available.

Validate an export and list exact output files without writing them.

Export textures inside SP_MCP_EXPORT_ROOTS and verify every output file.

Preview an engine-profile texture export without writing files.

Run a curated export profile inside SP_MCP_EXPORT_ROOTS and verify outputs.

Import and verify a sandboxed resource inside the open Painter project.

List Painter shelves with paths, write capability, and crawling state.

Import and verify a safe resource in an editable shelf or the user shelf.

Start event-observed discovery for one Painter shelf after confirmation.

Read persistent state for the latest or selected shelf refresh job.

Import and verify a sandboxed resource for the current Painter session.

List resources referenced by the open project.

Search Painter resources and return identifiers, type, category, and usages.

query uses Painter's shelf syntax: words such as "rust", or filters such as "u:generator", "u:smartmaterial rust", "u:basematerial" or "p:starter_assets". Underscores in a resource name don't match; search one word of it.

Plan project-resource replacements without modifying the project.

Atomically replace all outdated resources after explicit confirm=true.

Save a verified .spp copy inside SP_MCP_PROJECT_ROOTS without relocating the project.

Export a group as a verified Smart Material inside SP_MCP_EXPORT_ROOTS.

Export a layer mask as a verified Smart Mask inside SP_MCP_EXPORT_ROOTS.

Delete a layer or group by UID. This modifies the open project.

Execute raw Painter Python only when SP_MCP_ALLOW_EXECUTE_PYTHON=1.

Variables survive between calls. Assign to result to return a value; printed text comes back as output.