Cursor Setup

How to use Roblox MCP with Cursor.

Prerequisites

• Cursor installed
• Node.js (v18.0.0 or higher)
• Roblox Studio plugin installation complete

Registering the MCP Server

Method 1: Project Settings

Add the following to your project’s .cursor/mcp.json file:

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

Method 2: Global Settings

Add the same content to the global Cursor MCP config file.

Config file location:

If the file already exists, merge only the weppy-roblox-mcp entry into the existing mcpServers object.

Applying Changes

After modifying the config, reload the Cursor window or restart the app.

Connection Test

1. Launch Roblox Studio → Plugins tab → WEPPY → Connect
2. Enter the following in Cursor:

   Tell me what is currently selected in Roblox Studio

Troubleshooting

MCP Server Not Visible

• Check that the config file path is correct
• Confirm the JSON syntax is valid
• Confirm you reloaded Cursor after changing the config

Server Won’t Start

Run the MCP server directly to see the error:

npx -y @weppy/roblox-mcp

Connection Fails

• Confirm the Roblox Studio plugin shows Connected status
• Check that port 3002 is not blocked by a firewall