Skip to main content

​
Overview

RbxGenie integrates with Claude Desktop via the Model Context Protocol (MCP), giving Claude direct access to all 46 Roblox Studio tools through a standardized interface.
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 Claude Desktop will invoke.
3

Run the auto-installer

The installer automatically updates Claude Desktop’s configuration:
npm run install-mcp
Output:
[RbxGenie Installer]

Claude Desktop:
  ✓ Claude Desktop config updated: C:\Users\...\AppData\Roaming\Claude\claude_desktop_config.json

✓ Done (1 items configured)
  Restart Claude Desktop to apply changes.
4

Restart Claude Desktop

Completely quit and restart Claude Desktop. The RbxGenie MCP server will be available automatically.
5

Verify connection

In a Claude conversation, try:
Can you get the place info from Roblox Studio?
If configured correctly, Claude will use the get_place_info tool.

​
Manual Configuration

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

Locate the config file

Find your Claude Desktop configuration file:Windows:
%APPDATA%\Claude\claude_desktop_config.json
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Linux:
~/.config/Claude/claude_desktop_config.json
2

Add RbxGenie MCP server

Edit the config file 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 Claude Desktop

Save the config file and restart Claude Desktop.

​
How It Works

1

Claude invokes MCP tool

When Claude needs to interact with Roblox Studio, it calls an MCP tool via the stdio protocol.
2

MCP server proxies to daemon

The mcp.js script receives the tool call and makes an HTTP POST request to http://127.0.0.1:7766/tool/<tool_name>.
3

Daemon queues command

The daemon enqueues the command and waits for the Roblox Studio plugin to poll for work.
4

Plugin executes and returns

The plugin polls /poll, receives the command, executes it in Roblox Studio, and POSTs the result back to /result.
5

Claude receives result

The result propagates back through the daemon → MCP server → Claude Desktop.

​
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 config file syntax is valid JSON
  • Check that the path to mcp.js is absolute and correct
  • Restart Claude Desktop completely (quit, not just close window)
  • Check Claude’s MCP logs (if available) for error messages
  • 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
  • On Windows, ensure APPDATA environment variable exists
  • Try manual configuration instead of auto-installer
  • Check that Claude Desktop is installed in the default location
  • Run terminal as administrator (Windows) or use sudo (macOS/Linux)
  • Check file permissions on claude_desktop_config.json
  • Ensure Claude Desktop is not running during config modification

​
Available Tools

Once configured, Claude has access to all 46 RbxGenie tools. See the Tools Reference for the complete list.

​
Example Usage

Claude, create a red part at position (0, 10, 0)
Claude will automatically invoke the appropriate tools to complete these tasks.

​
Next Steps

Cursor Integration

Set up RbxGenie in Cursor IDE

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