Log inSubmit server
Weppy Roblox MCP logo

Weppy Roblox MCP

by hope1026

Controls live Roblox Studio projects through MCP for scripts, instances, terrain, assets, UI, synchronization, and playtesting.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Weppy Roblox MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hope1026-weppy-roblox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@weppy/roblox-mcp@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

hope1026/weppy-roblox-mcp connects MCP-compatible AI clients to a live Roblox Studio session through the WEPPY Roblox Studio Plugin. Its tools can inspect and modify instances, Luau scripts, properties, terrain, UI, lighting, assets, and other Studio state, with support for bidirectional sync and automated playtest workflows. Use it when an agent needs to make and verify changes directly in Studio rather than only generating code or instructions. The server also supports routing work across up to five connected Studio windows by Studio ID.

Use cases

  • Build Roblox scenes and instance hierarchies from natural-language instructions
  • Update Luau scripts and validate related changes in Studio
  • Generate terrain and locate suitable spawn or placement positions
  • Create and review in-game UI across responsive layouts
  • Run playtests and inspect logs, runtime state, and Studio output

Key features

  • Live Roblox Studio instance and script control
  • Luau editing with syntax validation
  • UI authoring with design and visual review workflows
  • Terrain, lighting, physics, audio, and animation operations
  • Asset Library and Roblox Open Cloud asset workflows
  • Multi-Studio routing, synchronization, and automated playtest support

Tools25

What Weppy Roblox MCP lets your agent do. Expand a tool for its parameters.

Verified live~29.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 23d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @weppy/roblox-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars68Stargazers on the source repository.
npm downloads7.9kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed25Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Weppy Roblox MCP works

What hope1026/weppy-roblox-mcp does

hope1026/weppy-roblox-mcp links an MCP client with the WEPPY Roblox Studio Plugin so an AI agent can inspect and change a live Roblox project. The exposed operations cover the Roblox DataModel, Luau source, properties, attributes, tags, UI, terrain, lighting, selection, camera state, logs, assets, and Studio playtest control.

The server is suited to workflows such as building a game scene, updating related scripts, placing collision-safe spawn points, reviewing runtime output, or preparing assets for use in a Place. It can also work across multi-Place projects: up to five Studio windows can be connected, and requests can target a particular Studio ID.

How it works

The MCP server runs locally and communicates with the WEPPY Roblox Studio Plugin. The plugin provides the live Studio connection through which tool requests are applied and state is read back. Changes can be reflected in Studio and the dashboard, while synchronization tools expose project status, history, policies, and synced files.

UI authoring follows a structured workflow. The agent begins with a design brief, retains the returned brief and layout data through creation and review, previews the primary view after meaningful changes, and submits a visual review verdict. Runtime UI checks can use a saved PlayerGui snapshot. Studio control also includes playtest lifecycle operations, runtime values, automated tests, and editor rendering or view checks on the Pro tier.

Setup and configuration

Requirements include Node.js 22 or newer, Roblox Studio, and Windows 10 or newer or macOS 12 or newer. Install the package directly with:

Terminal
npx -y @weppy/roblox-mcp@latest

The project also provides one-line installers for macOS/Linux and Windows PowerShell, plus a browser-based installer. These installers can register the server with supported clients and can install the optional WEPPY AI Agent Plugin for selected clients.

The server uses a local STDIO connection. Roblox Studio must be running with the WEPPY plugin connected. For multi-Place work, connect the relevant Studio windows and use their Studio IDs when directing operations.

Tools and capabilities

Core tool groups include:

  • Querying, creating, deleting, cloning, moving, renaming, and pivoting Roblox instances.
  • Reading and changing properties, attributes, and tags, including batch operations on the Pro tier.
  • Reading, writing, creating, deleting, editing, searching, and syntax-validating Luau scripts.
  • Creating, updating, previewing, and checking Roblox UI through the UI Studio workflow.
  • Managing lighting, terrain, particles, audio, animations, physics collision groups, tweens, cameras, and selection.
  • Searching and inserting Creator Store assets, handling local Asset Library files, uploading through Roblox Open Cloud, and applying returned asset URIs.
  • Inspecting workspace state, synchronized files, logs, connection status, settings, and Studio diagnostics.
  • Running sequential batches of commands and executing Luau in the Studio sandbox on the Pro tier.

Limitations and notes

Several tool groups and advanced actions are marked Pro, including terrain editing, asset management, spatial queries, synchronization, batch execution, and arbitrary Luau execution. The Luau sandbox blocks HttpService, DataStoreService, and MessagingService, and cannot access CoreGui or CorePackages. Camera screenshots are available only in Edit mode and cannot be captured during playtest. Open Cloud asset management supports upload, linking, updates, metadata, and operation polling, but not delete, archive, or restore actions.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Weppy Roblox MCP

hope1026/weppy-roblox-mcp is an MCP server that connects AI clients to a live Roblox Studio session through the WEPPY Studio Plugin. Its main tools query and mutate instances, manage Luau scripts and properties, create UI, handle terrain and assets, inspect workspace state, and control playtests.

Install it with `npx -y @weppy/roblox-mcp@latest`, or use the project's macOS/Linux, Windows PowerShell, or browser installer. Then reopen the AI client and restart Roblox Studio so the registered MCP connection and plugin can connect.

The server works with any MCP-compatible AI client. The documented setup supports Claude Code, Claude Desktop, Cursor, Codex CLI or App, Gemini CLI, and Antigravity variants; Dola Desktop can connect through a local STDIO Custom Connector with Pro mode and Local computer enabled.

You need Node.js 22 or newer, Roblox Studio, and Windows 10 or newer or macOS 12 or newer. The WEPPY Roblox Studio Plugin must provide the live Studio connection for the MCP tools to operate.

Yes. Up to five Roblox Studio windows can connect to one MCP server, and requests can be routed by Studio ID. This allows an agent to direct changes to separate Places such as a lobby, game, shop, or tutorial.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

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 PreviewWeppy Roblox MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hope1026-weppy-roblox-mcp?style=directory)](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>