Skip to main content
Glama

toolbag-mcp

An MCP server for Marmoset Toolbag 5. It lets an MCP client such as Claude Code, Claude Desktop or Cursor drive a running Toolbag through typed tools: inspect and change the scene, materials and textures, set up and run bake projects, place lights and cameras, render images. Free Python runs only when you allow it in Toolbag.

Early stage: built and tested against Toolbag 5.0.2 on Windows. Not affiliated with Marmoset LLC; "Marmoset" and "Toolbag" are their trademarks.

How it works

Two parts, one package:

  • A Toolbag plugin (plugin/) that runs inside Toolbag. It listens on 127.0.0.1 (port 18770 by default) and executes named actions on Toolbag's main thread.

  • The MCP server (toolbag_mcp) that runs outside Toolbag, talks to the plugin over HTTP and exposes the actions as MCP tools over stdio.

Toolbag runs plugin code at full speed only while its window has focus. So the server brings Toolbag forward while a call waits for it (Windows), but stays out of your way: it switches only after 1.5 s without keyboard or mouse input, hands the focus back as soon as a longer action is running, and never takes it from a window you picked during the call. While you type, the call waits; a visible Toolbag answers in the background too, only slower (seconds per call).

Scripts that use the client directly can keep Toolbag in front across many calls instead of flashing it for each one:

from toolbag_mcp.client import ToolbagClient

client = ToolbagClient()
with client.holding_focus():
    for name in ("a", "b", "c"):
        client.call("object.get", {"ref": name})

Related MCP server: omni-kit-mcp

Requirements

  • Marmoset Toolbag 5.0.x on Windows (tested with 5.0.2.2). Toolbag 4 and macOS are untested.

  • Python 3.10 or newer and uv for the server. The plugin needs nothing beyond Toolbag's own Python.

Install

The package is not on PyPI; this Git repository is the release channel.

  1. Install the toolbag-mcp command with uv:

    uv tool install git+https://github.com/LandgrafRalle/toolbag-mcp

    Pin a release by appending @v0.1.0 to the URL; uv tool upgrade toolbag-mcp updates later. Without installing, uvx --from git+https://github.com/LandgrafRalle/toolbag-mcp toolbag-mcp ... runs any command below; from a checkout, uv run toolbag-mcp ... does.

  2. Install the plugin into Toolbag's user plugin folder (%LOCALAPPDATA%\Marmoset Toolbag 5\plugins\Toolbag MCP), as a junction to the package or with --copy as a copy of the files:

    toolbag-mcp install

    Run this from a normal shell: packaged (Microsoft Store) apps see %LOCALAPPDATA% redirected, and a junction made from inside one of them is invisible to Toolbag.

  3. In Toolbag: Edit, Plugins, Refresh, then Plugins, Toolbag MCP. A small window shows the port, the call counter and the switch "Allow Python execution". Toolbag can also start the plugin directly: toolbag.exe "<path to>\plugin\__main__.py".

  4. Register the server with your MCP client. toolbag-mcp register prints the lines for your installation; for example for Claude Code:

    claude mcp add --scope user --transport stdio toolbag -- toolbag-mcp

    Claude Desktop and Cursor take the same command in their JSON config: {"mcpServers": {"toolbag": {"command": "toolbag-mcp", "args": []}}}. If a client does not find the command, give it the full path (uv tool dir --bin prints the folder) or the uvx --from ... form.

  5. Check the setup: toolbag-mcp doctor. It verifies the installed plugin, finds the Toolbag window, reads the plugin's state file and does one round trip.

Another port: install --port 18771 writes it to ~/.toolbag-mcp/config.json; the plugin window has a port field too. The plugin writes its port and per-start token to ~/.toolbag-mcp/plugin.json, which the server reads for every call.

Tools

Tool names as the client sees them, by family:

Family

Tools

Diagnostics

status, capabilities, preferences_get, preferences_set

Scene and objects

scene_info, scene_new, scene_load, scene_save, scene_list_objects, scene_tree, scene_import_model, scene_export, scene_bounds, object_get, object_find, object_rename, object_duplicate, object_delete, object_group, object_set_parent, object_set_visible, object_set_transform, object_attributes, object_set_attributes, object_create, selection_get, selection_set, selection_clear, camera_frame, mesh_set_backfaces

Materials

material_list, material_get, material_create, material_duplicate, material_delete, material_assign, material_set_group, material_set_subroutine, material_set_field, material_set_texture, material_set_cutout, material_import, material_export

Baker

baker_list, baker_get, baker_create, baker_add_group, baker_quick_load, baker_set_settings, baker_set_maps, baker_set_cage, baker_set_visible, baker_isolate, baker_bake, baker_bake_psd, baker_bake_to, baker_map_path, baker_load_preset, baker_save_preset, baker_set_texture_set, baker_set_udim_tile, baker_replace_low, baker_skew_preview, baker_skew_clear_preview, baker_skew_apply

Lights, sky, fog, cameras

light_list, light_create, sky_get, sky_set, sky_load, sky_save, sky_set_background_image, sky_compute_procedural, fog_get, fog_set, camera_list, camera_get, camera_create, camera_set, camera_set_active, camera_post_effect_file

Render and timeline

render_get, render_set, render_set_cameras, render_set_passes, render_image, render_images, render_videos, render_export_viewer, timeline_get, timeline_set

Python and lifecycle

execute_python (only while allowed in the plugin window), toolbag_quit

Resources: toolbag://scene, toolbag://materials, toolbag://baker, toolbag://cameras, toolbag://render.

Objects are referenced by uid or exact name; scene_tree, scene_list_objects and object_find give them. object_attributes shows every setting of any object with its value, object_set_attributes changes them, nested settings included ({"lens": {"dofStop": 2.8}} on a camera). In bake scenes, toggle visibility through baker_set_visible and baker_isolate, never on single meshes: that corrupts bakes.

Edge protect sets Toolbag's skew masks without painting them. The rule: full skew correction everywhere, averaged cage directions only in bands along UV seams and open borders, hard edges and soft edges that bend more than a threshold angle; each band has its own width in bake pixels, 0 switches it off. baker_skew_preview shows the masks as base colour on the low materials (black = averaged), baker_skew_apply writes them. Toolbag's Python API cannot set skew masks, so the server saves the scene as a new <scene>_skew.tbscene, writes the masks into that file and loads it; the original file stays untouched.

From the shell: toolbag-mcp actions lists every action with its parameters, toolbag-mcp call scene.info runs one.

Safety

  • The plugin listens on the loopback address only. Every request needs a marker header, the token generated at this plugin start and a Host of 127.0.0.1 or localhost. CORS preflights are never answered, so a web page cannot reach it.

  • execute_python runs only while "Allow Python execution" is ticked in the plugin window. The switch is off at every start and is not persisted.

  • Everything else is a fixed, validated action. Actions write files only where you tell them to. scene_new, scene_load and toolbag_quit drop unsaved changes without a prompt; clients see them flagged as destructive.

  • The server talks to nothing but the plugin's loopback port.

Troubleshooting

  • toolbag-mcp doctor first.

  • No answer: Toolbag must not sit behind a modal dialog or be minimized. While you keep typing, calls wait for a pause (see above); TOOLBAG_MCP_NO_FOCUS=1 turns the focus handling off entirely, calls then rely on Toolbag answering in the background.

  • "Nothing accepts connections" while Toolbag runs: it is busy (loading or saving a large scene stops the plugin for that time). "No longer running": Toolbag closed or crashed; Windows records crashes in the event log (Application, source "Application Error").

  • Save before scene_new or scene_load on large scenes: Toolbag 5.0.2 has crashed in newScene there (see docs/pitfalls.md).

  • A second Toolbag instance cannot bind the port; its plugin window says so.

  • Never run Toolbag MCP together with another plugin that sets onPeriodicUpdate (doctor lists them): Toolbag then runs neither.

  • Verified traps of Toolbag's Python API, with the differences between 5.0.2 and the docs: docs/pitfalls.md.

Development

uv sync
uv run pytest           # tests against a fake mset, no Toolbag needed
uv run ruff check .
uv build                # wheel with the plugin folder inside

Test assets: blender --background --factory-startup --python tests/make_test_assets.py -- <folder>. CI runs lint, tests and the build on Windows and Ubuntu.

License

MIT, copyright (c) 2026 LandgrafRalle.

Available Tools

93 tools
baker_add_groupC

Add an empty bake group (with Low and High nodes) to a bake project.

Inputs: name (required), baker. Returns: object

baker_bakeB

Bake with the project's current settings and write the enabled maps next to outputPath ('_.'). Synchronous, can take minutes.

Inputs: baker. Returns: object

baker_bake_psdC

Bake all enabled maps into one layered PSD at the output path.

Inputs: baker. Returns: object

baker_bake_toA

Trial bake of selected maps (default ['normals']) into a separate file, e.g. 'C:/tmp/test.png' gives 'C:/tmp/test_normals.png', at the given size and samples. The project's settings and map switches are restored afterwards; settings are temporary extras such as {"smoothCage": false}.

Inputs: path (required), maps, baker, width, +3 more. Returns: object

baker_createC

Create a new bake project.

Inputs: name. Returns: object

baker_getB
Read-onlyIdempotent

One bake project in full: groups with Low (cage offsets, meshes) and High nodes, settings, maps with options, texture sets, UDIM tiles and the expected output files.

Inputs: maps, baker. Returns: object

baker_isolateC

Show only these bake groups and hide all others.

Inputs: groups (required), baker. Returns: object

baker_listB
Read-onlyIdempotent

All bake projects with their groups and output path.

Inputs: no named parameters. Returns: object

baker_load_presetC

Load a saved baker preset by name.

Inputs: name (required), baker. Returns: object

baker_map_pathB
Read-onlyIdempotent

Toolbag's own output path for a map by display name ('Normals', 'Ambient Occlusion', 'Height'), optionally for a texture set name or UDIM tile ('1001').

Inputs: map_name (required), baker, tile_suffix. Returns: object

baker_quick_loadA

Load a model through the Quick Loader: objects named '_low' and '_high' pair into one group per stem. A mismatch leaves a group without High and an empty bake, so check the returned groups.

Inputs: path (required), baker. Returns: object

baker_replace_lowA

Swap the geometry of a group's single low mesh for the mesh in a model file (new UVs, fixed topology) while keeping group, cage and material. Save the scene first if you rely on stored cage directions.

Inputs: path (required), group (required), baker. Returns: object

baker_save_presetB

Save the bake project's configuration as a named preset.

Inputs: name (required), baker. Returns: object

baker_set_cageC

Cage offsets per bake group (all groups when omitted). estimate lets Toolbag estimate first, explicit min/max then override.

Inputs: baker, groups, estimate, cage_alpha, +3 more. Returns: object

baker_set_mapsB

Switch maps on or off by suffix ('normals', 'ao', 'height', 'curvature', 'position', 'thickness', 'bentnormals', ...) and set map options, e.g. {"normals": {"flipY": true}, "ao": {"rayCount": 1024, "ignoreGroups": false}}. Returns the enabled maps.

Inputs: baker, enable, disable, options. Returns: object

baker_set_settingsB

Set bake project settings: outputPath, outputWidth, outputHeight, outputBits (8, 16, 32), outputSamples, edgePadding ('None', 'Moderate', 'Extreme'), edgePaddingSize, outputSoften, smoothCage, ignoreBackfaces, useHiddenMeshes, ignoreTransforms, fixMirroredTangents, tileMode (0 single, 1 texture sets, 2 UDIM), geometryMode (0 high to low, 1 low to low, 2 UV match).

Inputs: settings (required), baker. Returns: object

baker_set_texture_setB

Enable and size one texture set by index or name (tileMode 1).

Inputs: index (required), baker, width, height, +1 more. Returns: object

baker_set_udim_tileB

Enable and size one UDIM tile by index or name such as '1001' (tileMode 2).

Inputs: index (required), baker, width, height, +1 more. Returns: object

baker_set_visibleB

Show or hide bake groups, or their Low and High nodes separately. The safe way to toggle meshes in a bake scene.

Inputs: low, high, baker, groups, +1 more. Returns: object

baker_skew_applyA

Edge protect: write skew masks by edge rule (see baker_skew_preview, same parameters) into the bake groups. The Python API cannot set skew masks, so the scene is saved as a new file, the masks go into that file and Toolbag loads it. path is that new file (never overwritten); default <scene>_skew.tbscene next to the current scene, which then must have been saved once. The original scene file stays untouched.

Inputs: path, baker, groups, bend_px, +5 more. Returns: object

baker_skew_clear_previewA

End the skew mask preview: the low materials get their albedo map and colour back.

Inputs: no named parameters. Returns: object

baker_skew_previewA

Edge protect: compute skew masks by edge rule and show them as base colour on the low materials (black = averaged cage, white = corrected). Full correction everywhere except bands along UV seams and open borders (seam_px), hard edges (hard_px) and soft edges bending more than bend_deg degrees (bend_px); widths in bake pixels, 0 switches a band off, soft_px adds a falloff. Nothing is written into the scene: check the look, adjust, then baker_skew_apply. baker_skew_clear_preview restores the materials.

Inputs: baker, groups, bend_px, hard_px, +4 more. Returns: object

camera_createA

Create a camera with optional transform and attributes; activate makes it the viewport and render camera.

Inputs: name, activate, position, rotation, +1 more. Returns: object

camera_frameA

Frame one object, or the whole scene without ref, in the current camera.

Inputs: ref. Returns: object

camera_getB
Read-onlyIdempotent

One camera in full (the active one by default): transform, mode, fov, focal length, lens (depth of field, distortion, flares, motion blur), limits and postEffect (tone mapping, exposure, contrast, bloom, vignette, grain).

Inputs: ref. Returns: object

camera_listA
Read-onlyIdempotent

All cameras with mode, field of view, focal length and which one is active.

Inputs: no named parameters. Returns: object

camera_post_effect_fileB

Load a camera post effect preset from a file, or save the current one (save=true).

Inputs: path (required), ref, save. Returns: object

camera_setA

Set camera attributes (the active camera by default): fov, focalLength, mode, {"lens": {"dofMode": 1, "dofStop": 2.8, "dofFocusDistance": 50}}, {"postEffect": {"toneMappingMode": "aces", "exposure": 1.2, "bloomBrightness": 0.1}}, {"limits": {...}}.

Inputs: attributes (required), ref. Returns: object

camera_set_activeB

Make a camera the active viewport and render camera.

Inputs: ref (required). Returns: object

capabilitiesA
Read-onlyIdempotent

Everything the running Toolbag exposes in mset plus the plugin's action list, for version differences between Toolbag builds.

Inputs: no named parameters. Returns: object

execute_pythonA
Destructive

Run Python inside Toolbag with mset imported; only while the user has ticked "Allow Python execution" in the Toolbag MCP window. The namespace persists between calls; assign result to return a value; print() output comes back as log.

Inputs: code (required), timeout. Returns: object

fog_getB
Read-onlyIdempotent

The scene's fog with its attributes, or exists: false when there is none.

Inputs: ref. Returns: object

fog_setA

Set fog attributes (color, density, opacity, volumeType 'fit'/'vertical', heightMin, heightMax, falloffMin, falloffMax); creates the fog object when the scene has none.

Inputs: attributes (required), ref, create. Returns: object

light_createA

Create a light: 'omni', 'spot' or 'directional', with optional transform and attributes such as brightness, color [r, g, b], castShadows, width, lengthX, lengthY, spotAngle, useTemperature, temperature (object_attributes lists what this Toolbag build has; 5.02 has no shape or physical units).

Inputs: name, position, rotation, attributes, +1 more. Returns: object

light_listA
Read-onlyIdempotent

All lights (sky child lights included) with type, brightness, colour, shadows, shape and transform.

Inputs: no named parameters. Returns: object

material_assignB

Assign a material to objects, by default including their children.

Inputs: name (required), refs (required), include_children. Returns: object

material_createB

Create a material with Toolbag's default shaders.

Inputs: name (required). Returns: object

material_deleteB
Destructive

Delete a material; its objects fall back to the default material.

Inputs: name (required). Returns: object

material_duplicateC

Duplicate a material; optional name for the copy.

Inputs: name (required), new_name. Returns: object

material_exportB

Export a material to a .tbmat file.

Inputs: name (required), path (required). Returns: object

material_getB
Read-onlyIdempotent

One material in full: each slot (albedo, surface, microsurface, reflectivity, transparency, ...) with shader and field values, textures as path and sRGB flag, and the objects it is assigned to.

Inputs: name (required), fields. Returns: object

material_importB

Import a material file (.tbmat, MTL, or named texture files).

Inputs: path (required), name. Returns: object

material_listB
Read-onlyIdempotent

All materials with group, number of assigned objects and the shader per slot.

Inputs: name_contains. Returns: object

material_set_cutoutB

Alpha-tested transparency from a mask image: transparency slot to Cutout, 'Use Albedo Alpha' off, channel (0 = R) and the mask as Alpha Map, re-read from disk.

Inputs: name (required), alpha_map (required), srgb, channel, +2 more. Returns: object

material_set_fieldA

Set a number, boolean, enum or color field of a material slot (field names from material_get). For texture fields use material_set_texture.

Inputs: name (required), slot (required), field (required), value (required). Returns: object

material_set_groupB

Move a material into a material group ('' for none).

Inputs: name (required), group. Returns: object

material_set_subroutineB

Set the shader of a material slot, e.g. ('transparency', 'Cutout'), ('reflectivity', 'Metalness'), ('surface', 'Normals'). Slots: subdivision, displacement, surface, microsurface, albedo, diffusion, transmission, reflectivity, reflection, clearcoat reflection, clearcoat microsurface, clearcoat reflectivity, occlusion, emissive, transparency, texture. Returns the slot's field names.

Inputs: name (required), slot (required), shader (required). Returns: object

material_set_textureA

Put an image file into a texture field (e.g. slot 'albedo', field 'Albedo Map'; slot 'surface', field 'Normal Map'). The field is cleared first so a changed file is re-read. srgb and mipmaps default to the previous texture's settings. An empty path clears the field.

Inputs: name (required), path (required), slot (required), field (required), +4 more. Returns: object

mesh_set_backfacesA

Show back faces (cull back faces off) on all meshes or the given ones, as a two-sided shader would render them. Per object; lost on re-import.

Inputs: refs, show. Returns: object

object_attributesB
Read-onlyIdempotent

Every plain attribute of an object with its current value, type-specific: light, camera (lens, limits, postEffect expanded), sky, fog, shadow catcher, backdrop, mesh. These are the names object_set_attributes takes.

Inputs: ref (required). Returns: object

object_createB

Create a scene object by class: LightObject, CameraObject, FogObject, SkyBoxObject, ShadowCatcherObject, BackdropObject, SceneObject (a group), TransformObject, BakerObject; with optional name, transform, parent and attributes set right away.

Inputs: object_type (required), name, parent, position, +2 more. Returns: object

object_deleteC
Destructive

Delete objects from the scene.

Inputs: refs (required). Returns: object

object_duplicateB

Duplicate an object with its children; optional name for the copy.

Inputs: ref (required), name. Returns: object

object_findB
Read-onlyIdempotent

Objects whose name contains name (case-insensitive), or equals it with exact.

Inputs: name (required), exact, limit. Returns: object

object_getC
Read-onlyIdempotent

Everything about one object: transform, pivot, bounds, mesh/camera/light settings, submeshes with their materials.

Inputs: ref (required). Returns: object

object_groupC

Put objects under a new group, optionally named.

Inputs: refs (required), name. Returns: object

object_renameC

Rename an object.

Inputs: ref (required), name (required). Returns: object

object_set_attributesA

Set attributes of any object by name: {"brightness": 3, "color": [1, 0.9, 0.8]} for a light, {"lens": {"dofStop": 2.8}} or {"lens.dofStop": 2.8} for a camera, {"density": 0.2} for fog, {"opacity": 0.5} for a shadow catcher.

Inputs: ref (required), attributes (required). Returns: object

object_set_parentA

Re-parent an object; without parent it moves to the scene root.

Inputs: ref (required), parent. Returns: object

object_set_transformA

Set position, rotation (degrees), scale or pivot (each three numbers) of a transform object; omitted ones stay.

Inputs: ref (required), pivot, scale, position, +1 more. Returns: object

object_set_visibleA

Show or hide groups, lights, cameras or bake nodes. Refuses submeshes always and meshes unless allow_mesh is true: in bake scenes those flags corrupt bakes or crash Toolbag on load. For bake scenes use baker_set_visible or baker_isolate.

Inputs: refs (required), visible (required), allow_mesh. Returns: object

preferences_getB
Read-onlyIdempotent

Toolbag application preferences, all or the given keys (e.g. autoTextureReload, defaultTangentMethod, rayTraceBackend).

Inputs: keys. Returns: object

preferences_setA

Set one Toolbag application preference (see preferences_get for keys).

Inputs: key (required), value (required). Returns: object

render_export_viewerC

Export a Marmoset Viewer (.mview) archive of the scene.

Inputs: path (required), title, width, author, +4 more. Returns: object

render_getB
Read-onlyIdempotent

The render object: options (renderer, ray tracing, shadows, occlusion, wireframe, watermark), image and video output settings (outputPath, format, width, height, samples, transparency), and the cameras and passes enabled for export.

Inputs: no named parameters. Returns: object

render_imageB

Render one image with the active camera (or the given one) using the render object's settings; width, height and sampling default to those settings. With path the file is written (format by extension). Can take minutes with ray tracing.

Inputs: path, width, camera, height, +3 more. Returns: object

render_imagesB

Render all enabled cameras and passes into the image output folder (render_get: images.outputPath). Returns the files written.

Inputs: width, height, sampling, transparency. Returns: object

render_setB

Change render settings: options ({"renderer": "raytrace", "rayTraceBounces": 4, "shadowQuality": "High"}), images ({"outputPath": "C:/out", "format": "PNG", "width": 1920, "height": 1080, "samples": 256, "transparency": true}), videos (same keys).

Inputs: images, videos, options. Returns: object

render_set_camerasC

Choose which cameras render on render_images and render_videos.

Inputs: enable, disable. Returns: object

render_set_passesA

Switch render passes on or off by name (render_get lists them).

Inputs: enable, disable. Returns: object

render_videosC

Render the animation into the video output folder (render_get: videos.outputPath). Can take long.

Inputs: width, height, sampling, transparency. Returns: object

scene_boundsB
Read-onlyIdempotent

Bounds of the whole scene as [min_xyz, max_xyz] plus the unit scale.

Inputs: no named parameters. Returns: object

scene_exportA

Export the scene; the format follows the extension: .fbx, .obj, .glb/.gltf, .usd/.usda/.usdc/.usdz, .dae. options are exporter flags such as {"materials": false, "triangulate": true, "embedassets": true}.

Inputs: path (required), options. Returns: object

scene_import_modelA

Import a model file (FBX, OBJ, glTF, USD, ...) into the scene with the scene's import settings. Returns the imported root and the new objects.

Inputs: path (required). Returns: object

scene_infoC
Read-onlyIdempotent

Scene path, unit scale, bounds, object counts by type, bake projects, selection.

Inputs: no named parameters. Returns: object

scene_list_objectsB
Read-onlyIdempotent

Flat list of scene objects (uid, name, type, parent, visibility, transform). object_type filters by class: MeshObject, SubMeshObject, BakerObject, BakerTargetObject, LightObject, CameraObject, SkyBoxObject, FogObject, SceneObject (groups). parent restricts to the descendants of one object.

Inputs: limit, parent, object_type, name_contains, +1 more. Returns: object

scene_loadA
Destructive

Load a .tbscene file. Unsaved changes in the current scene are lost without a prompt; save a large scene first (Toolbag 5.0.2 has crashed tearing big bake scenes down).

Inputs: path (required), download_missing_library_assets. Returns: object

scene_newA
Destructive

New empty scene. Unsaved changes are lost without a prompt. Save a large scene first: Toolbag 5.0.2 has crashed here on big bake scenes.

Inputs: no named parameters. Returns: object

scene_saveA

Save the scene to its current file, or to path (save as). Overwrites without asking.

Inputs: path. Returns: object

scene_treeB
Read-onlyIdempotent

Object hierarchy as nested nodes, depth levels deep (deeper levels show the child count only). Good first look at an unknown scene.

Inputs: root, depth. Returns: object

selection_clearA

Deselect everything.

Inputs: no named parameters. Returns: object

selection_getC
Read-onlyIdempotent

The currently selected objects.

Inputs: no named parameters. Returns: object

selection_setC

Select exactly these objects.

Inputs: refs (required). Returns: object

sky_compute_proceduralB

Switch the sky to procedural mode (sun by time, day and location) and recompute it.

Inputs: ref. Returns: object

sky_getC
Read-onlyIdempotent

The sky: mode, brightness, rotation, background, procedural sun settings and its child lights.

Inputs: ref. Returns: object

sky_loadA

Load a sky: a .tbsky file replaces the whole sky, an image (.hdr, .exr, .png, .jpg) becomes the panorama.

Inputs: path (required), ref. Returns: object

sky_saveC

Save the sky as a .tbsky archive.

Inputs: path (required), ref. Returns: object

sky_setB

Set sky attributes: brightness, rotation (degrees), mode ('color', 'sky', 'blurred sky', 'ambient sky'), backgroundColor, blur, and for a procedural sky time, day, latitude, longitude, turbidity, sunBrightness.

Inputs: attributes (required), ref. Returns: object

sky_set_background_imageB

Use an image as the sky's background; an empty path clears it.

Inputs: ref, path. Returns: object

statusA
Read-onlyIdempotent

Toolbag version, graphics adapter, scene path, counts and plugin state (port, Python switch, call counter). Start here: it tells whether the plugin is reachable.

Inputs: no named parameters. Returns: object

timeline_getB
Read-onlyIdempotent

Animation timeline: time, frame, total frames, frame rate, selection, speed.

Inputs: no named parameters. Returns: object

timeline_setA

Set the timeline: time in seconds or frame, total frames, frame rate (resamples keyframes), selection range, playback speed; play=true/false starts or stops playback.

Inputs: play, time, frame, frame_rate, +4 more. Returns: object

toolbag_quitA
Destructive

Quit Toolbag. Unsaved changes are lost without a prompt; the plugin answers and Toolbag closes right after.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 93 tools

    Disambiguation4/5

    Tools are organized into clear domain prefixes (scene_, object_, material_, baker_, camera_, sky_, fog_, render_, timeline_), so most selections are obvious. A few genuine overlaps exist: object_create vs light_create/camera_create, object_set_attributes vs camera_set/sky_set, and scene_list_objects vs object_find vs scene_tree; descriptions mostly disambiguate (e.g. object_set_visible explicitly defers to baker_set_visible/baker_isolate for bake scenes), but the create/attribute-set duplication could still cause misselection.

    Naming Consistency4/5

    The dominant convention is prefix_noun_verb (material_set_texture, baker_set_maps, camera_set_active), applied consistently across domains. Deviations are limited to a handful of bare or legacy names (status, capabilities, execute_python, toolbag_quit), which are readable but break the pattern.

    Tool Count2/5

    93 tools is far beyond any comfortable agent working set, even for a full 3D DCC application. The breadth (baking, skew masks, sky, fog, render, timeline) justifies many of them, but a large tail of hyper-specific tools (baker_skew_preview/apply/clear_preview, baker_map_path, camera_post_effect_file, baker_set_udim_tile) bloats the surface when execute_python could absorb rare cases.

    Completeness5/5

    Coverage is exceptional: full lifecycle for scenes, objects, materials, bake projects, cameras, sky, fog, lights, rendering, and timeline, plus presets and export paths. The execute_python escape hatch means there are effectively no dead ends for operations the tool set omits (e.g. material renaming).

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects MCP-compatible clients to a live Blender scene for AI-assisted 3D workflows, enabling inspection and controlled operations on objects, materials, cameras, lights, render settings, animation, UVs, Geometry Nodes, imports, exports, and Python execution.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables driving Omniverse Kit apps (Isaac Sim, Isaac Lab) over MCP, allowing agents to control simulations, run Python, and call namespace-scoped tools via a single bridge.
      1
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Typed DCC-MCP control for Marmoset Toolbag 4.03+ and 5.x, enabling shell-capable agents to interact with Toolbag scenes via a shared CLI and MCP gateway.
      37 PyPI
      3
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to drive Blockbench Desktop locally for Minecraft model, UV, texture, animation, and export workflows. It provides typed operations, high-level task workflows, native controls, and inspection/verification tools over an authenticated loopback connection.
      3
      -