Skip to main content

​
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:
{
  "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: 
{
  "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

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

Build docs developers (and LLMs) love

Get started for freeTalk to us