Roblox MCP

v2.7.10β€’APIsβ€’stable

πŸ“‡ 🏠 🍎 πŸͺŸ - MCP server and plugin that lets AI agents (Claude Code, Cursor, Codex, Gemini) directly control

aiai-agentsantigravityclaudeclaude-code
Share:
24
Stars
0
Downloads
0
Weekly
0/5

What is Roblox MCP?

Roblox MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to πŸ“‡ 🏠 🍎 πŸͺŸ - mcp server and plugin that lets ai agents (claude code, cursor, codex, gemini) directly control

πŸ“‡ 🏠 🍎 πŸͺŸ - MCP server and plugin that lets AI agents (Claude Code, Cursor, Codex, Gemini) directly control

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Roblox game development
Studio automation
AI-driven game creation
hope1026

Maintainer

LicenseAGPL-3.0
Languagepowershell
Versionv2.7.10
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @weppy/roblox-mcp

Manual Installation

npx -y @weppy/roblox-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Roblox MCP

Roblox MCP is an MCP server and Roblox Studio plugin package published under @weppy/roblox-mcp that gives AI agents (Claude Code, Cursor, Codex, Gemini) direct, bidirectional control over Roblox Studio. Developers can describe game features in natural language and the agent will create scripts, configure instances, generate terrain, manage lighting, insert Creator Store assets, and run playtests β€” all without manually touching Studio. It supports Windows and macOS and works with every major AI coding client.

Prerequisites

  • Node.js 18+ installed
  • Roblox Studio installed (Windows 10+ or macOS 12+)
  • An MCP-compatible AI client: Claude Code, Claude Desktop, Cursor, Codex, or Gemini CLI
  • The Weppy Roblox Studio plugin installed inside Roblox Studio (set up during installation)
1

Install the MCP server via npm

Install the official @weppy/roblox-mcp package using npx, which also handles the Roblox Studio plugin installation.

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

Add to Claude Desktop or Claude Code config

Add the Roblox MCP server to your MCP client configuration. Set ENABLE_TELEMETRY=false to opt out of analytics.

{
  "mcpServers": {
    "roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"],
      "env": {
        "ENABLE_TELEMETRY": "false"
      }
    }
  }
}
3

Install the Roblox Studio plugin

Open Roblox Studio and install the Weppy plugin. The plugin is available via the Creator Store or via the link provided by the MCP server setup. This plugin is required for the AI agent to communicate with Studio.

4

Activate the plugin in Studio

In Roblox Studio, click the Plugins tab and activate the Weppy Roblox plugin. Wait for the Connected status to appear, confirming the bridge to the MCP server is established.

5

Use Claude Code or your AI client to build

With Studio connected, open Claude Code (or Cursor, Codex, etc.) in your project directory and start issuing game-building instructions in natural language.

claude
# Then in the conversation:
# "Add a health regeneration system with a cooldown for the player character"

Roblox MCP Examples

Client configuration

Claude Desktop configuration using the published @weppy/roblox-mcp npm package.

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

Prompts to try

Example prompts for AI-driven Roblox game development using the Roblox MCP server.

- "Create a Luau script that makes the player's character glow when they collect a power-up"
- "Build a procedural dungeon layout with 5 rooms connected by corridors"
- "Insert a medieval castle asset from the Creator Store and place it at the center of the map"
- "Add atmospheric fog and set the lighting to a sunset time of day"
- "Write a test that spawns 10 NPCs and verifies their pathfinding works correctly"

Troubleshooting Roblox MCP

Studio plugin shows 'Not Connected' after activation

Make sure the MCP server is running β€” it must be started by your AI client before connecting. Run npx -y @weppy/roblox-mcp@latest in a terminal to confirm the server starts without errors. Check for firewall rules blocking the local port used for Studio communication.

AI agent can describe changes but they do not appear in Studio

The Weppy plugin must be actively running inside an open Roblox Studio window. Ensure Studio is open, the plugin is activated from the Plugins ribbon, and the status indicator shows Connected.

npx fails to find or download the package

Verify internet access and npm registry connectivity. Run npx -y @weppy/roblox-mcp@latest --version in a terminal. If the package version can't be resolved, try clearing the npx cache: rm -rf ~/.npm/_npx.

Frequently Asked Questions about Roblox MCP

What is Roblox MCP?

Roblox MCP is a Model Context Protocol (MCP) server that πŸ“‡ 🏠 🍎 πŸͺŸ - mcp server and plugin that lets ai agents (claude code, cursor, codex, gemini) directly control It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Roblox MCP?

Install via npm with the command: npx -y @weppy/roblox-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Roblox MCP?

Roblox MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Roblox MCP free to use?

Yes, Roblox MCP is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide β†’

Ready to use Roblox MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides