Roblox Mcp

by hope1026

12.3k downloads Not rated yet

GitHub Website

About

Connect AI coding agents to a live Roblox Studio session. Create and edit

Explore

- Direct real-time control of Roblox Studio
- Create, edit, move, rename, and delete instances
- Inspect and update DataModel properties
- Generate terrain and adjust lighting and atmosphere
- Search, insert, and configure assets from prompts
- Sync Studio to local files for multi-file edits

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Roblox Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

From the repository

Install via npx -y @weppy/roblox-mcp and configure it with any MCP-compatible client. Once connected, the AI agent can directly control Studio to create scripts, manage instances, adjust terrain, and more.

`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.

`mutate_instances`

Create, delete, clone, move, rename, or pivot instances. [PRO] create_tree, mass_create, mass_delete, mass_duplicate, smart_duplicate, scatter.

`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_ui`

Create / update / verify Roblox in-game UI (ScreenGui / Frame / TextLabel / …). Always start with `design_brief`. For ambiguous input, it inspects Studio context and returns candidate brief patches; Do not dump enum lists at the user. Pass relevant repository evidence in `projectContext`; explicit screen job, visual thesis, forbidden defaults, tokens, and approved assets determine the direction without a built-in subject preset. `design_brief` returns a primary-view-first Design Contract and an advisory Layout Plan with neutral regions, AnchorPoint strategy, and responsive behavior; it is not a hard tree preset or style quota. A calling agent may declare provider-neutral image generation capability through `agentCapabilities`; missing or unavailable capability must use the explicit existing, user-provided, Creator Store, or assetless fallback. Keep the returned `brief_id`, `design_contract`, and `layout_plan` through creation, update, preview, and check. The asset recommendation gate considers user references, project assets, existing UI, and user-approved `manage_assets.search` intent; do not use a recommendation until the user accepts it. After each meaningful create or update, preview the representative primary view and submit a calling-agent critic verdict (`recompose`, `refine`, or `approved`) with `visualReview`. Read `primary_visual_verdict`, `functional_safe`, `responsive_requirement`, `responsive_ready`, `required_dimensions`, and `readiness` separately from mutation success. Responsive evidence blocks readiness only when the Design Contract marks it required. Read `weppy://ui-studio/guide` for the authoring workflow, `weppy://ui-studio/tokens` for optional visual examples, and `weppy://ui-studio/functional-rules` for machine-readable advisory evidence rules. Design Check permits `priority_high` only for observed functional visual failures such as meaningful overlap, unreadable content, invalid geometry, or primary-view occlusion; style-only findings remain medium or low.

`manage_lighting`

[PRO] Configure environment: lighting, atmosphere, sky, terrain properties, time of day.

`manage_selection`

Get, set, or clear selection. [PRO] context, details, add/remove items, watch changes.

`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_tween`

[PRO] Tween service: create, play, pause, cancel tweens for smooth animations.

`manage_audio`

[PRO] Audio management: play, stop, pause, resume sounds. Set audio listener.

`manage_animation`

[PRO] Animation: load, play, stop animations. Get animation tracks from humanoid/controller.

`manage_physics`

[PRO] Physics collision groups: register, set collidable between groups, list groups.

`manage_effects`

[PRO] Particle effects: emit particles, clear all particles, toggle effect enabled state.

`manage_terrain`

[PRO] Terrain operations: fill shapes, clear regions, replace materials, manage colors, read/write voxels, generate procedural terrain, smooth terrain.

`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.

`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_open_cloud_assets`

[PRO] Roblox Open Cloud asset upload: preflight diagnostics, credential status, category capabilities, Asset Library-backed upload, existing asset linking, updates, metadata reads, and operation polling. Does not expose delete/archive/restore actions.

`manage_sync`

[PRO] Project sync management: status, history, direction settings, read/write synced files.

`workspace_state`

[PRO] Workspace state: full sync, snapshot, recent changes, viewport info, clear history, metadata, scripts, selection info, clear cache.

`manage_logs`

Output logs: get filtered logs, poll incrementally with sinceSeq cursor, clear buffer, get recent errors.

`system_info`

System info: ping, connection status, usage tier, and read-only Studio preflight diagnostics. [PRO] place info and services list.

`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.

`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.

`execute_luau`

[PRO] Execute arbitrary Luau code in Roblox Studio sandbox. Blocked services: HttpService, DataStoreService, MessagingService. Cannot access CoreGui/CorePackages.

WEPPY Roblox AI Toolkitis a Roblox Studio AI development product. It includes theWEPPY MCP Serverfor AI app connections and theWEPPY Roblox Studio Pluginfor live Studio control. Claude Code, Codex, and Antigravity can also install the optionalWEPPY AI Agent Pluginfor client-native setup and workflow guidance.

Multi-Place Studio work · Generated assets to Roblox · Bidirectional sync · Automated playtest · UI Studio

AI coding agents like Claude, Codex, and Gemini are powerful, but they cannot see or modify anything inside Roblox Studio. The DataModel, scripts, terrain, and lighting are invisible to external tools. Without a bridge, AI can only generate code snippets that you must paste manually.

TheWEPPY MCP Serverconnects AI agents to theWEPPY Roblox Studio Plugin. AI directly creates and modifies instances, scripts, properties, terrain, and more inside Studio, and the changes are reflected immediately in Studio and the dashboard so you can see exactly what changed.

WEPPY is also built for Roblox experiences that are split across several Places. Open up to five Studio windows for Lobby, Game, Shop, Tutorial, or other Places, then tell the agent which Studio ID to use. One request can update several Places without re-explaining context or copying changes by hand.

For assets, an agent can create or prepare an image, save it to the Asset Library, upload it through Roblox Open Cloud, and apply the returned asset URI to a Place. The result is a shorter path from "make this icon/decal" to "it is visible in Studio."

No copy-pasting code or asset IDs. AI does the work, you review the results.

Start from the web install page. It shows the recommended one-line script for your platform first.

On the install page, copy the one-line script and run it in Terminal or PowerShell.

curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash

irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex

Then reopen your AI app and restart Roblox Studio.

AutomaticWEPPY MCP Serverregistration supports Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, and Antigravity / Antigravity IDE / Antigravity CLI. For Claude Code, the installer also installs theWEPPY AI Agent Plugin. For Codex, it adds the plugin marketplace and then asks you to installWEPPY AI Agent Pluginfrom Plugin Directory. For Antigravity, the AI agent plugin is installed only when Antigravity CLI andagy pluginare available; otherwise the installer preserves the direct MCP connection.

If terminal or PowerShell is uncomfortable, use the terminal-free web installer on the same install page.

If the one-line install or terminal-free web installer does not work, register theWEPPY MCP Servermanually with your AI app.

Supported AI apps are Claude Code, Claude Desktop, Cursor, Codex CLI, Codex App, Gemini CLI, and Antigravity / Antigravity IDE / Antigravity CLI.

Any MCP-compatible AI client works. The server command isnpx -y @weppy/roblox-mcp@latest.

TheWEPPY Roblox AI Toolkitconnects to every supported AI app through theWEPPY MCP Server. Claude Code, Codex, and Antigravity can additionally install theWEPPY AI Agent Pluginfor client-native setup and workflow guidance for Studio control, sync, and assets.

claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user

codex plugin marketplace add hope1026/weppy-roblox-mcp

After adding the Codex marketplace, restart Codex, open Plugin Directory, and installWEPPY AI Agent Plugin.

Antigravity CLI is required to install theWEPPY AI Agent Plugin. The one-line installer usesagy plugin installwith the latest public GitHub release, verifies it withagy plugin list, and publishes the verified skill-only payload to supported IDE surfaces. Existing installs are replaced on every run so they can converge on the latest release.

The installer reports results as installed, updated, reinstalled, repaired, fallback, failed, or skipped. A missing CLI keeps the shared MCP connection at~/.gemini/config/mcp_config.jsonworking and reports fallback; an existing plugin is never treated as a skip. In a CLI-only profile, verified native plugin MCP replaces the shared direct WEPPY entry. When Antigravity IDE and CLI coexist, both plugin views stay skill-only and one shared directweppy-roblox-mcpdefinition serves both. Outside the verified OS and version matrix, native discovery uses the MCP fallback.

On Windows Antigravity, CLI installation has been verified to expose skills and MCP. Windows Antigravity IDE plugin discovery is unverified because the verified environment has no plugin or skills inspection UI, so the shared MCP fallback is preserved. GitHub URLs are not passed directly toagy plugin install; the installer downloads the latest public release and installs from a prepared local path.

Requirements:Node.js 18+, Roblox Studio, Windows 10+ or macOS 12+

AI can directly handle scripts, instances, properties, terrain, lighting, assets, audio, and animation inside Studio.

- "Add particles + sound + cooldown when the player jumps."
- "Build a boss arena at map center and place collision-safe spawn points."
- "Change this module interface and update every dependent script."
- "Generate terrain with mountains and rivers, then place spawn points on flat areas."
- "Search the Creator Store for a sword model and insert it into StarterPack."

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "roblox mcp": {
            "roblox-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@weppy/roblox-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "roblox-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@weppy/roblox-mcp"
        ]
    }
}

How is Weppy different from other Roblox MCP servers?

Weppy uses action-based dispatching instead of separate tools for each function. This reduces AI token consumption significantly. It also combines Studio ID based multi-place work, generated asset upload/apply, bidirectional project sync, and Playtest control.

The server runs on localhost only (127.0.0.1:3002). Forbidden paths (CoreGui, CorePackages) are blocked. Rate limiting (450 req/min) and 30-second timeouts prevent runaway operations. All changes are trackable via sync history.

Multi-Place work, generated assets to Roblox, bidirectional Sync, UI Studio, Playtest control, and AI token efficiency - all in one upgrade.

This repository is licensed underAGPL-3.0.

Commercial licensing is available separately. See](https://github.com/hope1026/weppy-roblox-mcp/blob/HEAD/PRIVACY.md)COMMERCIAL-LICENSE.md.

Use of the Weppy name and logos is governed by TRADEMARKS.md.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An MCP server for Unity, enabling AI assistants to interact with projects in real-time, access scene data, and execute code.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

query_instances

mutate_instances

manage_properties

manage_scripts

manage_ui

manage_lighting

manage_selection

manage_camera

manage_tween

manage_audio

manage_animation

manage_physics

manage_effects

manage_terrain

spatial_query

manage_assets

manage_open_cloud_assets

manage_sync

workspace_state

manage_logs

system_info

manage_studio

batch_execute

execute_luau

Claude Desktop / Cursor

McpServers

How is Weppy different from other Roblox MCP servers?

More like this

Sequential Thinking

Sentry

Github

Filesystem

`query_instances`

`mutate_instances`

`manage_properties`

`manage_scripts`

`manage_ui`

`manage_lighting`

`manage_selection`

`manage_camera`

`manage_tween`

`manage_audio`

`manage_animation`

`manage_physics`

`manage_effects`

`manage_terrain`

`spatial_query`

`manage_assets`

`manage_open_cloud_assets`

`manage_sync`

`workspace_state`

`manage_logs`

`system_info`

`manage_studio`

`batch_execute`

`execute_luau`