batch_execute
[PRO] Execute multiple commands in a single batch. Each command is an object with "tool" name and "args". Commands execute sequentially; optionally continue on error.
LABSCO SUMMARY
The AI can finally see inside Studio, not just hand you code.
The bridge is the whole point: without it an agent can only generate snippets you paste in, but WEPPY lets it create instances, edit scripts and shape terrain live, with the result visible in Studio immediately. The multi-Place support is the distinctive part — open several Studio windows for Lobby, Shop and Game and tell the agent which Studio ID to target, so one request can update Places that would otherwise each need context re-explained. Note much of the surface is PRO-gated.
What it is
The WEPPY MCP server, which connects an AI agent to the WEPPY Roblox Studio plugin so it can read and modify the DataModel directly: 24 tools spanning instances, scripts, UI, environment, assets, playtest control and arbitrary Luau execution. Many tools are marked [PRO].
What you get
- The scene graph read and written: query_instances gets, finds and waits for instances, mutate_instances creates, deletes, clones, moves, renames and pivots them, and manage_properties gets and sets properties, attributes and tags
- manage_scripts works script source directly — read, write, create, delete and edit lines — and execute_luau runs arbitrary Luau in the Studio sandbox (with unsafe services blocked)
- manage_ui builds and verifies in-game UI (ScreenGui, Frame, TextLabel), and manage_lighting configures lighting, atmosphere, sky and terrain properties
- Environment and motion: manage_tween for smooth animation, manage_audio, manage_animation, manage_physics collision groups, manage_effects for particles, and manage_terrain for fill, clear and material operations
- spatial_query does raycasts, ground-finding and placement checks, and manage_camera and manage_selection control the view and what is selected
- Assets: manage_assets inserts models by ID and searches the creator store, and manage_open_cloud_assets uploads through Roblox Open Cloud and returns an asset URI to apply
- Workflow: manage_studio controls the playtest lifecycle and automated test runs, workspace_state snapshots and syncs the workspace, manage_sync handles project sync, and batch_execute runs several commands in one call
- manage_logs reads and polls filtered output logs, and system_info reports connection status and usage tier
Requirements
Roblox Studio with the WEPPY Studio plugin installed — the server talks to the plugin, which is what actually touches Studio. Install via the one-line script from weppyai.com/en/install (install.sh on macOS/Linux, install.ps1 on Windows), which also sets up the client's agent plugin where supported. Asset upload uses Roblox Open Cloud credentials. Many tools are gated behind a PRO tier; system_info reports which tier you are on.
Setup effort
Follow the published steps
USE CASES
01
Building a scene by describing it
Create the instances, set their properties and tags, and shape the terrain and lighting around them — watching the changes appear in Studio as they happen.
02
Wiring up game logic
Read and edit the script source directly, run Luau in the sandbox to test a behavior, and check the output logs when something misbehaves.
03
Getting a generated asset into a Place
Upload an image or model through Roblox Open Cloud, get the asset URI back, and apply it to the instance that needs it — no copying asset IDs by hand.
04
Building the interface
Create and verify in-game UI, position the camera to see it, and animate transitions with tweens.
24 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
execute_luau
[PRO] Execute arbitrary Luau code in Roblox Studio sandbox. Blocked services: HttpService, DataStoreService, MessagingService. Cannot access CoreGui/CorePackages.
manage_animation
[PRO] Animation: load, play, stop animations. Get animation tracks from humanoid/controller.
manage_assets
[PRO] Asset management: insert models by ID, get asset info, search creator store, insert free models/packages, export selection JSON, generate/review Roblox models, round-trip .rbxm files through Asset Library, and generate local thumbnails.
manage_audio
[PRO] Audio management: play, stop, pause, resume sounds. Set audio listener.
manage_camera
Camera operations: get info, focus on instance/position, suggest view, capture Edit-mode viewport screenshot (Edit mode only; not usable during playtest).
manage_effects
[PRO] Particle effects: emit particles, clear all particles, toggle effect enabled state.
manage_lighting
[PRO] Configure environment: lighting, atmosphere, sky, terrain properties, time of day.
manage_logs
Output logs: get filtered logs, poll incrementally with sinceSeq cursor, clear buffer, get recent errors.
manage_open_cloud_assets
[PRO] Roblox Open Cloud asset upload: preflight diagnostics, credential status, category capabilities, upload local files, update assets, read metadata, and poll operation status. Does not expose delete/archive/restore actions.
manage_physics
[PRO] Physics collision groups: register, set collidable between groups, list groups.
manage_properties
Get/set properties, attributes, and tags on instances. [PRO] set_calculated, set_relative, mass_set, mass_get, modify_children.
manage_scripts
Manage script source code: read, write, create, delete, edit lines, search, and validate Luau syntax. [PRO] replace across scripts.
manage_selection
Get, set, or clear selection. [PRO] context, details, add/remove items, watch changes.
manage_studio
Control Roblox Studio state for playtest lifecycle, automated test runs, and editor view/rendering QA workflows. Use it for state-changing playtest controls and Studio session-level View settings such as UI preview; it does not edit game UI objects or their properties.
manage_sync
[PRO] Project sync management: status, history, direction settings, read/write synced files.
manage_terrain
[PRO] Terrain operations: fill shapes, clear regions, replace materials, manage colors, read/write voxels, generate procedural terrain, smooth terrain.
manage_tween
[PRO] Tween service: create, play, pause, cancel tweens for smooth animations.
manage_ui
Create / update / verify Roblox in-game UI (ScreenGui / Frame / TextLabel / …). Always start a new UI task with the design_brief action — it accepts an omitted or partial brief, inspects Studio context, then returns a current-state summary, recommended mode/change scopes, candidate brief patches, and one user-facing confirmation or clarification question. design_brief may return asset recommendation candidates from existing UI images, user references, or conservative manage_assets.search results; do not use a recommended asset until the user accepts it. Do not dump enum lists at the user; map natural language to internal purpose/platform/tone values through recommendations, and only finalize identity-defining fields after the user accepts a recommendation or provides equivalent intent. Read MCP resource weppy://ui-studio/guide for the full guide; it is split into Floor (non-negotiable accessibility), Vocabulary (style menu — pick ONE family per dimension; do not blend everything), Direction (brief → choices), and Tree encoding (Roblox property JSON shapes). Floor essentials suggested by Design Check (check): (1) mobile touch target ≥ 44 px (2) text contrast ≥ 4.5:1 (3) prefer explicit TextSize over TextScaled (4) respect platform safe zones (5) warn on full-screen opaque roots for non-modal purposes. Style is brief-driven; reject the default AI look (uniform 8 px corners + generic blue + glass card + Gotham everywhere) — each game deserves its own visual identity.
mutate_instances
Create, delete, clone, move, rename, or pivot instances. [PRO] create_tree, mass_create, mass_delete, mass_duplicate, smart_duplicate, scatter.
query_instances
Query Roblox instances: get, children, find child/descendant, wait for child, class info, search by name/class. [PRO] file_tree, project_structure, descendants, ancestors, search by property/tag.
spatial_query
[PRO] Spatial queries: raycast, find ground, check placement, multi-raycast, scan area, find flat areas, find spawn positions, analyze walkable, spatial map, find empty space, get bounds, snap to grid, check collision.
system_info
System info: ping, connection status, usage tier, and read-only Studio preflight diagnostics. [PRO] place info and services list.
workspace_state
[PRO] Workspace state: full sync, snapshot, recent changes, viewport info, clear history, metadata, scripts, selection info, clear cache.
BEFORE YOU INSTALL
What to know first
Tools you get
24 tools when we connected. 14 tools are marked [PRO] and six more have PRO-only actions, so a free plan can use roughly ten. Each tool covers many actions; manage_terrain alone handles fill, clear, replace, voxels and procedural generation.
Requires
- Node.js 18+
- Roblox Studio
- Windows 10+ or macOS 12+
CONTEXT COST
Heavy Standing cost
Rated by the size of the 24 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
Run the one-line installer for your platform. It installs the WEPPY Roblox Studio Plugin and registers the WEPPY MCP Server with Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI and Antigravity.
macOS / Linux: curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
Windows (PowerShell): irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
Then reopen your AI app and restart Roblox Studio.
If the installer does not work, register the WEPPY MCP Server manually with the server command npx -y @weppy/roblox-mcp@latest — the WEPPY Roblox Studio Plugin still comes from the installer or the web install page, https://weppyai.com/en/install.
