robloxgaminggame-developmentdeveloper-tools
Controls a live Roblox Studio session through MCP for scripts, instances, terrain, assets, UI, syncing, and playtesting.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent โ or use 1-click editor setup below.
Not yet automatically verified
This server is confirmed live โ we successfully called its tools/list endpoint directly (see the verified badge above). We haven't yet sandbox-tested the stdio install command below specifically, which is a separate, ongoing check.
Manual Client & Custom JSON ConfigExpand JSON โพ
Client Config & Setup
Choose your client or environment
Target File:
๐ก Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Build Roblox instances and scripts from natural-language requests
Synchronize code and Studio changes across a multi-place experience
Generate terrain and find collision-safe spawn locations
Create and verify in-game UI for Roblox projects
Run automated Studio playtests and inspect output logs
Key features
Live Roblox Studio instance and script control
Multi-place routing across up to five Studio windows
Bidirectional project synchronization
Terrain, UI, lighting, asset, and audio management
Automated playtest and Studio state controls
Batch command and constrained Luau execution
Capabilities & Tool Schemas (24)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Weppy Roblox MCP.
query_instancesQuery 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.
mutate_instancesCreate, delete, clone, move, rename, or pivot instances. [PRO] create_tree, mass_create, mass_delete, mass_duplicate, smart_duplicate, scatter.
manage_propertiesGet/set properties, attributes, and tags on instances. [PRO] set_calculated, set_relative, mass_set, mass_get, modify_children.
manage_scriptsManage script source code: read, write, create, delete, edit lines, search, and validate Luau syntax. [PRO] replace across scripts.
manage_uiCreate / 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.
manage_lighting[PRO] Configure environment: lighting, atmosphere, sky, terrain properties, time of day.
How Weppy Roblox MCP works
What hope1026/weppy-roblox-mcp MCP server does
The hope1026/weppy-roblox-mcp MCP server gives compatible AI clients a bridge into Roblox Studio. Its tools can inspect the DataModel, create or modify instances, manage Luau source, change properties and tags, and work with Roblox UI objects. Additional capabilities cover terrain editing, lighting, audio, animation, particles, physics collision groups, camera control, selection, logs, and workspace state.
The package also supports workflows beyond direct object editing. Agents can synchronize project files, inspect recent changes, run Studio playtests, perform rendering or editor-view checks, and use batch commands. Asset-related actions include searching the Creator Store, inserting models, handling local asset-library files, generating thumbnails, and using Roblox Open Cloud asset uploads where configured. Some listed actions are marked PRO, so availability may depend on the product tier.
How it works
The MCP server communicates with a WEPPY Roblox Studio Plugin running in the target Studio session. The AI client sends tool calls, and the plugin applies them to the open place so changes can be reviewed in Studio. A connected setup can include up to five Studio windows, with requests directed to a selected Studio ID. This supports experiences split across places such as a lobby, shop, tutorial, and main game.
For project work, synchronization can maintain a local mirror and support different directions, including Studio-first, local-code, Studio-world, bidirectional review, and custom scopes. The initial synchronization behavior and saved settings determine which side is treated as the source. The manage_studio tool handles session-level state changes such as playtest controls; it is separate from editing UI objects.
Setup and configuration
The hope1026/weppy-roblox-mcp MCP server requires Node.js 18 or newer, Roblox Studio, and Windows 10+ or macOS 12+. The README documents a manual MCP registration command:
The project also provides platform-specific installers and a browser-based installation page. Supported clients listed in the material include Claude Code, Claude Desktop, Cursor, Codex CLI and App, Gemini CLI, and Antigravity variants. The WEPPY Roblox Studio Plugin must be available in Roblox Studio for live control. Claude Code, Codex, and Antigravity can additionally use an optional WEPPY AI Agent Plugin for client-native workflow guidance.
Tools and capabilities
Core tool groups include:
- Querying, creating, deleting, cloning, moving, renaming, and pivoting instances.
- Reading and writing script source, editing lines, searching scripts, and validating Luau syntax.
- Managing properties, attributes, tags, UI objects, lighting, terrain, audio, animation, effects, and physics.
- Inspecting selection, camera state, logs, connection status, workspace metadata, and sync history.
- Searching and inserting assets, exporting selection data, handling RBXM files, and uploading Open Cloud assets.
- Running sequential batches and executing Luau in a Studio sandbox.
The Luau sandbox blocks HttpService, DataStoreService, and MessagingService, and cannot access CoreGui or CorePackages.
Limitations and notes
The hope1026/weppy-roblox-mcp MCP server depends on a reachable Roblox Studio session and its plugin, so it is not a standalone Roblox game-testing environment. Camera viewport capture is available only in Edit mode and cannot be used during playtest. Open Cloud asset management does not expose delete, archive, or restore actions.
UI work has a documented design workflow. New UI tasks should begin with design_brief, which inspects context and proposes recommendations before identity-defining choices are finalized. The UI guidance emphasizes touch targets of at least 44 pixels, text contrast of at least 4.5:1, safe zones, explicit TextSize where appropriate, and caution around opaque full-screen roots. Arbitrary Luau execution should be treated as constrained by the blocked services and inaccessible Core services described above.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks โ not a rating.
GitHub stars
61
Stargazers on the source repository.
Tools exposed
24
Callable tools this server registers over MCP.
Directory activity
3 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet โ be the first to share how this listing worked for you.
Frequently Asked Questions about Weppy Roblox MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/hope1026-weppy-roblox-mcp)HTML Embed
<a href="https://allmcps.com/mcp/hope1026-weppy-roblox-mcp"><img src="https://allmcps.com/api/badge/hope1026-weppy-roblox-mcp?style=directory" alt="Weppy Roblox MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryGaming
PricingFree
59Quality signal: Good ยท 59/100How this signal is calculated โพ
Server availabilityNot measured
Not scored for repo-hosted servers โ we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools30/30
Adoption & activity4/15
Community engagement0/10
A guidance signal from public completeness & health data โ not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 20d ago via OSV.dev ยท @weppy/roblox-mcp@latest (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge โ proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it โ no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.