Cursor Integration

Set up RbxGenie as an MCP server in Cursor IDE

Overview

Cursor IDE supports the Model Context Protocol (MCP), allowing AI coding assistants to access RbxGenie’s 46 Roblox Studio tools directly within your development environment.

The RbxGenie daemon must be running before configuring MCP integration.

Quick Install

1. Start the daemon

   Ensure the RbxGenie daemon is running on port 7766:

   cd path/to/RbxGenie
   npm run dev
   

   The daemon should display:

   [RbxGenie] Daemon listening on http://127.0.0.1:7766
   
2. Build the MCP server

   Compile the TypeScript MCP server to JavaScript:

   npm run build
   

   This generates dist/mcp.js which Cursor will invoke.

3. Run the auto-installer

   The installer automatically updates both Claude Desktop and Cursor configurations:

   npm run install-mcp
   

   Output:

   [RbxGenie Installer]
   
   Claude Desktop:
     ✓ Claude Desktop config updated: ...
   
   Cursor:
     ✓ Cursor config updated: ~/.cursor/mcp.json
   
   ✓ Done (2 items configured)
     Restart Claude Desktop / Cursor to apply changes.
   
4. Restart Cursor

   Completely quit and restart Cursor IDE. The RbxGenie MCP server will be available automatically.

5. Verify connection

   In a Cursor AI chat, try:

   Can you get the place info from Roblox Studio?
   

   If configured correctly, Cursor’s AI will use the get_place_info tool.

Manual Configuration

If you prefer manual setup or the auto-installer fails:

1. Locate the config file

   Cursor stores its MCP configuration in:

   Windows:

   %USERPROFILE%\.cursor\mcp.json
   

   macOS:

   ~/.cursor/mcp.json
   

   Linux:

   ~/.cursor/mcp.json
   

   If the file doesn’t exist, create it.

2. Add RbxGenie MCP server

   Edit mcp.json and add the RbxGenie server under mcpServers:

   Windows

   {
     "mcpServers": {
       "RbxGenie": {
         "command": "node",
         "args": ["C:/path/to/RbxGenie/dist/mcp.js"]
       }
     }
   }
   

   Use absolute paths for the mcp.js file. Relative paths will fail.

3. Restart Cursor

   Save the config file and restart Cursor IDE.

How It Works

The architecture is identical to Claude Desktop integration:

1. Cursor AI invokes an MCP tool via stdio
2. mcp.js proxies the request to the daemon at http://127.0.0.1:7766
3. Daemon queues the command and waits for the plugin
4. Roblox Studio plugin polls, executes, and returns the result
5. Result propagates back through daemon → MCP server → Cursor

Configuration Options

Custom Daemon URL

If your daemon runs on a different port or host, set the DAEMON_URL environment variable:

Windows

{
  "mcpServers": {
    "RbxGenie": {
      "command": "node",
      "args": ["C:/path/to/RbxGenie/dist/mcp.js"],
      "env": {
        "DAEMON_URL": "http://127.0.0.1:8080"
      }
    }
  }
}

Default: http://127.0.0.1:7766

Troubleshooting

MCP server not appearing in Cursor

• Verify the mcp.json syntax is valid JSON
• Check that the path to mcp.js is absolute and correct
• Restart Cursor completely (quit, not just close window)
• Check if ~/.cursor/ directory exists and is writable

Tools timeout or fail

• Ensure the daemon is running: http://127.0.0.1:7766/health
• Verify Roblox Studio plugin is installed and enabled
• Check that the plugin shows a green status indicator
• Tool timeout is 120 seconds — complex operations may need optimization

Permission denied on config file

• Check file permissions on ~/.cursor/mcp.json
• Ensure Cursor is not running during config modification
• Try creating the directory manually: mkdir -p ~/.cursor

Node.js not found

• Ensure Node.js is installed and in your PATH
• Try using full path to node: "/usr/local/bin/node" (macOS/Linux) or "C:/Program Files/nodejs/node.exe" (Windows)
• Check Node.js version: node --version (requires v16+)

Usage in Cursor

Once configured, you can interact with Roblox Studio directly from Cursor:

Example: Create a GUI

-- Ask Cursor:
-- "Create a ScreenGui with a TextButton in StarterGui"

-- Cursor will invoke:
-- 1. create_object_with_properties for ScreenGui
-- 2. create_object_with_properties for TextButton
-- 3. set_property calls for button styling

Workflow Tips

Script Editing

Use Cursor to edit Luau scripts in your IDE, then sync them to Studio with set_script_source

Bulk Modifications

Cursor excels at batch operations — mass property changes, bulk creation, etc.

Testing & Debugging

Use execute_luau and run_script_in_play_mode to test code without leaving Cursor

Project Analysis

Ask Cursor to analyze your game structure with get_project_structure and summarize_game

Available Tools

Cursor has access to all 46 RbxGenie tools. See the Tools Reference for the complete list.

Tool Categories

• Info/Read — Get file trees, search objects, inspect properties
• Properties — Set, calculate, and batch-modify properties
• Objects — Create, delete, duplicate instances
• Scripts — Read, write, and edit Luau source code
• Attributes — Manage custom instance attributes
• Tags — CollectionService tag operations
• Selection — Get current Studio selection
• Execute — Run Luau code and capture console output
• Playtest — Control Studio play/server modes
• Marketplace — Insert free models from the catalog

Next Steps

Claude Desktop

Set up RbxGenie in Claude Desktop

HTTP API

Use the HTTP API directly

Custom Agents

Build your own AI agents

Tools Reference

Browse all available tools