cp77wb-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
cp77wb saved-build tools are dry-run by default (write=true to persist); live mutation tools are previews by default (apply=true to execute after reviewing selection/plan).
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wb_treeC | Read a World Builder build hierarchy. |
| wb_getC | Read project stats or one World Builder element by path. |
| wb_findC | Search World Builder names, paths, modules, assets and NodeRefs. |
| wb_validateC | Validate World Builder-specific references, NodeRefs and caches. |
| wb_refsC | List NodeRef definitions and known World Builder references. |
| wb_moveC | Translate an object/group. Dry-run unless write=true. |
| wb_rotateB | Rotate an object/group around its origin or explicit pivot. Dry-run unless write=true. |
| wb_scaleA | Scale an object/group hierarchy. Existing scale fields only by default. Dry-run unless write=true. |
| wb_generate_noderefC | Generate a World Builder-compatible NodeRef. Dry-run unless write=true. |
| wb_duplicateB | Duplicate an object/group with unique names and repaired internal references. Dry-run unless write=true. |
| wb_arrayB | Create a linear array; count includes source. Dry-run unless write=true. |
| wb_radial_arrayC | Create an XY radial array; count includes source. Dry-run unless write=true. |
| wb_alignB | Align independent objects/groups on x/y/z. Dry-run unless write=true. |
| wb_distributeA | Evenly distribute 3+ independent objects/groups on x/y/z. Dry-run unless write=true. |
| wb_gridB | Create a 3D rectangular array; counts include source. Dry-run unless write=true. |
| wb_scatterB | Deterministically scatter copies inside an offline box. Dry-run unless write=true. |
| wb_path_arrayC | Place reference-safe copies along a polyline or WB marker group. Dry-run unless write=true. |
| wb_polygon_scatterB | Deterministically scatter copies inside an XY polygon. Dry-run unless write=true. |
| wb_volume_scatterB | Scatter copies inside box/cylinder/sphere volumes. Dry-run unless write=true. |
| wb_asset_pool_spawnC | Spawn a deterministic weighted pool of exact indexed World Builder assets. Dry-run unless write=true. |
| wb_rng_createC | Create a native World Builder Randomized Nested Group. Dry-run unless write=true. |
| wb_generate_roomB | Generate a rectangular room shell from verified indexed assets. Dry-run unless write=true. |
| wb_generate_corridorB | Generate a corridor shell from verified indexed assets. Dry-run unless write=true. |
| wb_generate_marketB | Generate a market grid from a deterministic weighted asset pool. Dry-run unless write=true. |
| wb_device_connectC | Connect two saved World Builder device nodes with a unique target NodeRef. Dry-run unless write=true. |
| wb_elevator_wireB | Wire an existing elevator, terminals and floor markers; patch saved instance data when available. Dry-run unless write=true. |
| wb_compat_scanC | Scan World Builder version/features/module schema and optionally compare a saved build against that exact source/install. |
| wb_prefab_renderA | Render ${parameter} placeholders in a JSON WB prefab/build template. Returns rendered JSON unless output is supplied. |
| wb_assets_buildC | Build/rebuild a local SQLite/FTS asset catalog from a World Builder installation/source tree. |
| wb_assets_searchC | Search a cp77wb asset catalog built from World Builder's real spawnable lists. Use returned #IDs for deterministic spawning. |
| wb_assets_infoB | Read asset-catalog metadata or one exact asset ID. |
| wb_spawn_assetB | Insert one exact/search-resolved indexed asset into a saved-build group. Ambiguous text queries fail. Dry-run unless write=true. |
| wb_favorites_listC | List World Builder native Favorite categories (reusable object/group prefabs). |
| wb_favorite_addC | Add an object/group to World Builder Favorites as a reusable prefab. Preview-only unless write=true. |
| wb_logsC | Read/tail World Builder, CET and related Cyberpunk mod logs from a game root (or entSpawner directory). |
| wb_live_pingC | Ping the optional cp77wb CET file-RPC companion and report v0.5 spatial/history capabilities. |
| wb_live_stateC | Read current World Builder/CET state through the optional live bridge. |
| wb_live_playerC | Read the live player transform through the optional CET bridge. |
| wb_live_cameraC | Read the live FPP camera transform through the optional CET bridge. |
| wb_live_selectionC | Read current World Builder selection through the optional CET bridge. |
| wb_live_historyB | Read World Builder's active undo/redo state and whether history-safe live mutation is available. |
| wb_live_pathsC | Search paths/names in the currently loaded World Builder hierarchy. |
| wb_live_raycastC | Raycast through World Builder's live scene intersection system; camera mode uses the current FPP camera. |
| wb_live_selectB | Select exact paths in the active World Builder UI. Preview unless apply=true. |
| wb_live_moveB | Move the current World Builder selection as one WB history action. Preview unless apply=true. |
| wb_live_rotateA | Rotate the current World Builder selection as one WB history action; multi-selection rotates around its center. Preview unless apply=true. |
| wb_live_scaleB | Scale current selection around its selection pivot or explicit pivot as one WB history action. Refuses non-scaleable leaves unless allow_partial=true. Preview unless apply=true. |
| wb_live_snapB | Drop/snap the current selection to the live scene surface along a direction, collapsed into one WB undo action. Preview unless apply=true. |
| wb_live_batchB | Apply move/rotate/scale/snap operations to the current selection as one World Builder undo transaction. Preview unless apply=true. |
| wb_live_duplicateB | Duplicate the current WB selection with optional per-copy offset. v0.5 remaps cloned NodeRefs and known internal references by default. Preview unless apply=true. |
| wb_live_surface_scatterB | Create deterministic copies around one selected source and drop each copy onto the live scene surface; one undo removes the whole scatter. Preview unless apply=true. |
| wb_live_deleteB | Delete the current World Builder selection through WB history. Preview unless apply=true. |
| wb_live_spawn_assetC | Spawn one exact indexed WB asset directly into the active editor, optionally in front of the camera and dropped to the surface. Preview unless apply=true. |
| wb_live_saveB | Save all saveable top-level active World Builder roots through WB's native save() path. Preview unless apply=true. |
| wb_live_reloadB | Reload one top-level active WB root from data/objects while preserving an undoable pre-reload state. Preview unless apply=true. |
| wb_live_undoB | Undo one World Builder history action. Preview/history check unless apply=true. |
| wb_live_redoB | Redo one World Builder history action. Preview/history check unless apply=true. |
| wb_semantic_buildC | Build deterministic local semantic tags/facets over an existing World Builder asset catalog. |
| wb_semantic_searchC | Search the local asset catalog by semantic role/style/material/condition and depot-path text. |
| wb_bounds_setB | Attach explicit local XYZ bounds to one indexed asset for collision-aware planning. |
| wb_bounds_importC | Import explicit asset bounds records into the catalog. |
| wb_bounds_infoC | Read explicit/effective asset bounds and heuristic fallback metadata. |
| wb_collisionsC | Approximate saved-build collision scan using yaw-aware oriented bounds; heuristic results are marked approximate. |
| wb_plan_compileC | Compile a declarative cp77wb-plan/1 specification into exact indexed spawn operations without editing a build. |
| wb_plan_previewB | Compile a construction plan, apply it to a clone, validate it and report approximate collisions with the existing build. |
| wb_plan_applyB | Apply a declarative construction plan to a saved build. Dry-run unless write=true. |
| wb_generate_fenceB | Generate repeated verified fence segments and optional posts along a path. Dry-run unless write=true. |
| wb_generate_roadC | Generate repeated road tiles and optional edge assets along a path. Dry-run unless write=true. |
| wb_generate_cableB | Generate a repeated cable/pipe segment chain along a path without guessing mesh stretching. Dry-run unless write=true. |
| wb_export_inspectC | Validate/summarize a World Builder *_exported.json before conversion. |
| wb_export_xlC | Generate the ArchiveXL structure implied by a World Builder export without writing files. |
| wb_build_prepareC | Preview or create a WolvenKit workspace around a WB export. write=false by default. |
| wb_build_statusC | Check expected streamingblock/sector/device outputs after WolvenKit Object Spawner import. |
| wb_build_native_importB | Preview or run the template-bundle + WolvenKit JSON-deserialize import directly into a prepared workspace. run=false by default. |
| wb_build_backendsC | Detect WolvenKit CLI/importer availability and report the Linux-native conversion boundary. |
| wb_build_packB | Preview or run WolvenKit CLI/cp77tools pack after verified Object Spawner import. run=false by default. |
| wb_build_packageC | Preview or assemble a game-layout distribution folder/ZIP from a built archive. write=false by default. |
| wb_build_verifyC | Verify a prepared game-layout package and optional conflicts with an installed game. |
| wb_build_deployB | Preview or deploy a game-layout folder into Cyberpunk. apply=false by default; overwrite required for conflicting existing files. |
| wb_build_doctorC | Verify package structure/conflicts and summarize issue-like World Builder/CET/framework log lines. |
| wb_native_template_planC | Plan or write a WolvenKit template-capture wscript for exactly the RED types used by an export. write=false by default. |
| wb_native_template_verifyC | Verify a captured cp77wb RED type template bundle covers every type required by a World Builder export. |
| wb_native_jsonB | Generate WolvenKit JSON intermediates mirroring the WB importer from a captured template bundle. write=false by default. |
| wb_native_preflightC | Probe WolvenKit CLI/cp77tools for the convert deserialize JSON-to-CR2W capability. |
| wb_native_convertC | Preview or execute conversion of prepared WolvenKit JSON intermediates to CR2W using a verified CLI. run=false by default. |
| wb_native_importC | Prepare/import a WB export through template-bundle + WKit JSON deserialize backend. run=false by default. |
| wb_native_verifyC | Verify converted sector/block/device files exist and carry CR2W magic. |
| wb_worker_buildB | Preview or build the bundled .NET 10 WolvenKit worker. run=false by default; optional log_file captures full dotnet publish output. |
| wb_worker_preflightC | Run the worker self-test; authoritative native is true only when RED default serialization and JSON-to-CR2W both pass. |
| wb_worker_inspectC | Inspect discovered WolvenKit assemblies, serializer/writer API signatures and API profile without requiring the round-trip self-test to pass. |
| wb_worker_doctorC | Collect .NET/worker diagnostics and optionally write a support ZIP for deferred compatibility testing. |
| wb_worker_bundleC | Preview or create exact RED default templates directly through the verified .NET worker. run=false by default. |
| wb_worker_importB | Preview or import a WB export directly through the verified .NET WolvenKit worker, without WScript template capture. run=false by default. |
| wb_build_worker_importC | Preview or populate a prepared workspace/source/archive through the verified .NET WolvenKit worker. run=false by default. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 94 tools
The set contains many near-duplicate families—wb_move vs wb_live_move, wb_scale vs wb_live_scale, wb_duplicate vs wb_live_duplicate, and several scatter/array variants—so an agent must carefully distinguish saved-build edits from live-editor actions. The build/native/worker import pipeline also has multiple overlapping entries such as wb_native_import, wb_build_native_import, wb_worker_import, and wb_build_worker_import. Descriptions help, but tool boundaries are still easy to misselect.
All tools are snake_case with a consistent wb_ prefix and readable subsystem names such as live, build, native, worker, and assets. However, verb/noun ordering is inconsistent: wb_assets_search and wb_build_prepare versus wb_spawn_asset and wb_plan_apply, plus bare noun-style names like wb_tree and wb_refs. The set is readable but not fully predictable.
At 94 tools this is far beyond a well-scoped MCP surface, even for a broad World Builder automation domain. The set is fragmented into highly granular live/offline and pipeline variants that could be consolidated or grouped behind fewer tools.
The surface covers an unusually full lifecycle: asset cataloging, semantic search, bounds and collision checks, planning, generation, live editing, export inspection, native conversion, packaging, verification, and deployment. Remaining gaps are minor—for example, offline saved-build deletion/rename and favorite removal are not clearly exposed—but core workflows are well covered.