WEPPY is an MCP server that connects AI coding agents directly to Roblox Studio.
AI coding agents like Claude, Codex, and Gemini are powerful, but they can’t directly see or modify the DataModel, scripts, terrain, or lighting inside Roblox Studio. WEPPY bridges that gap. When the AI creates or modifies instances, scripts, properties, and terrain inside Studio, changes are reflected immediately in both Studio and the dashboard so you can see exactly what changed at a glance.
No copy-pasting required. The AI does the work; you verify the results.
Recommended Starting Path
If this is your first time, follow the steps below in order. Each step finishes with the minimum verification needed before moving to the next.
- Getting Started — Install the MCP server and Studio plugin, make your first connection
- Check Connections — Verify server, plugin, and agent status from the dashboard
- First Workflows — A safe path to validate your first task
- Sync — How bidirectional sync works and how to handle conflicts
- Change History / Playtest — Workflows for validating AI results
Key Features
1. MCP Tools — Control Studio with Natural Language
Scripts, instances, properties, terrain, lighting, assets, audio, animations — the AI handles all of it directly inside Studio.
- “Add a particle effect, sound, and cooldown when the player jumps.”
- “Build a boss arena in the center of the map and place spawn points without collisions.”
- “Change this module’s interface and update all scripts that reference it.”
2. Sync — Keep the Entire Project Context Stable
The AI uses a locally synced project as its reference to understand the full structure and apply consistent changes across multiple files.
- Basic — Studio → Local one-way sync
- Pro — Bidirectional sync, per-type Direction/Apply Mode, change history, multi-place support
3. Playtest — AI Runs and Validates Tests Automatically
The AI controls Studio playtesting directly. It can start/stop F5 (Play) / F8 (Run) modes, inject test scripts, collect logs, and generate reports automatically.
- “Start a playtest in Run mode and verify that the NPC reaches its target.”
- “Write and auto-run a test script to check whether SpawnLocation is above the ground.”
- “Run a playtest to verify the script I just modified works without errors.”
4. WEPPY Dashboard — Real-Time Workflow Monitoring
The web dashboard served by the MCP server lets you check connection status, tool execution history, sync state, and game change history in real time.
- See server / plugin / agent connection status at a glance
- Compare every AI-made change Before & After in the Changelog
- Analyze workflow patterns with tool execution history and statistics
5. WEPPY Roblox Explorer — Browse the Studio Tree in VSCode
View the complete Roblox Studio instance tree directly inside VSCode. Explore services, open synced scripts and property files, and track sync status.
- Intuitive navigation with the same class icons as Studio
- Click to open synced scripts and property files
- Multi-place support with sync status indicators
Use Cases
- Rapid Prototyping — Describe game mechanics in natural language and the AI implements them directly in Studio
- Bulk Refactoring — Change a module interface and update all dependent scripts at once
- Terrain & Environment — Procedural terrain generation, lighting and atmosphere setup, asset placement — all in a single prompt
- Multi-File Consistency — The AI reads the full project via Sync and modifies related scripts together
- Asset Integration — Search the Creator Store, insert models, and set properties without leaving the editor
Compatibility
| Claude Code | Claude Desktop | Cursor | Codex CLI | Codex Desktop | Gemini CLI | Antigravity |
|---|---|---|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Requirements: Node.js 18+, Roblox Studio, Windows 10+ or macOS 12+
FAQ
How do I connect Claude Code to Roblox Studio?
Install the Roblox Studio plugin, then register the MCP server (npx -y @weppy/roblox-mcp) in Claude Code. Claude can then read and write scripts directly inside Studio. See the Claude Code setup guide for the full procedure.
What’s the difference between Basic and Pro?
Basic (free) includes MCP tool execution and one-way sync (Studio → Local). Pro adds bidirectional sync, bulk operations, terrain generation, spatial analysis, audio/animation control, and multi-place support.
Is it safe? Can AI break my game?
The server only runs on localhost (127.0.0.1:3002). Forbidden paths (CoreGui, CorePackages) are blocked, and a 30-second per-tool timeout prevents runaway operations. All changes are tracked in the sync history.
How is Weppy different from other Roblox MCP servers?
Instead of separating tools by feature, WEPPY uses action-based dispatching to significantly reduce AI token consumption. It also provides bidirectional project sync and multi-place support — features most alternatives lack.
Upgrade to Pro
Bidirectional Sync, advanced creation tools, AI token efficiency — get all of it with one upgrade.