Roblox Bridge Agent
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RBA_ROOT | Yes | The root directory for the RBA server (e.g., path to roblox_bridge_agent). | |
| RBA_WS_HOST | No | The host for the websocket bridge. Defaults to 127.0.0.1. | 127.0.0.1 |
| RBA_WS_PORT | No | The port for the websocket bridge. Defaults to 33882. | 33882 |
| RBA_AUTO_START_WS | No | Whether to automatically start the websocket bridge (true/false). Defaults to true. | true |
| RBA_WS_PORT_RANGE | No | The range of ports for websocket discovery (e.g., 33882-33920). | 33882-33920 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| rba_ws_startB | Start the local RBA websocket bridge used by the Lua autoloader. |
| rba_ws_stopA | Stop the local RBA websocket bridge. |
| rba_ws_statusB | Show websocket bridge status, connected clients, and recent client events. |
| rba_connection_infoB | Return the active RBA websocket host, port, URL, candidate URLs, and published connection-state checks. |
| rba_eventsB | Read recent websocket/client events captured by RBA. |
| rba_clear_eventsA | Clear buffered RBA events, optionally only those matching type/client filters. |
| rba_clientsA | List connected RBA websocket clients. |
| rba_health_checkC | Diagnose the shared RBA bridge, Instance Manager endpoint, connected clients, autoexec targets, recent errors, and optional eval/ping health. |
| rba_detect_roblox_crashA | Read-only Roblox process and RBA heartbeat diagnosis. Reports healthy, bridge_disconnected, not_running, or likely_crashed without changing any process. |
| rba_restart_robloxA | Safely restart RobloxPlayerBeta.exe: discover and verify the current/installed executable path, close only RobloxPlayerBeta processes, then launch the verified executable normally. |
| rba_development_snapshotA | One development-oriented snapshot: RBA health, Roblox crash likelihood, autoexec state, and optional static script preflight. Does not execute the inspected script. |
| rba_unified_statusB | Verify the complete local workflow: RBA websocket service, Instance Manager connector endpoint, and every executor autoexec copy. |
| rba_agent_bootstrapA | Prepare RBA for an agent session: start or attach the bridge, sync autoexec, optionally start dashboard, notify clients, and return health. |
| rba_notify_clientsC | Show an in-game RBA notification on connected Roblox clients. |
| rba_set_client_statusC | Update the in-game RBA status panel on connected Roblox clients. |
| rba_client_infoB | Show full details for one connected RBA websocket client. |
| rba_select_clientA | Set the default client used when a tool target is omitted. |
| rba_disconnect_clientC | Close one connected RBA websocket client. |
| rba_send_luaB | Send Lua source text to connected development clients through the websocket bridge. |
| rba_send_lua_fileC | Send a Lua file from the RBA workspace to connected development clients. |
| rba_eval_luaB | Run Lua and wait for structured return values or errors from connected clients. |
| rba_eval_lua_fileC | Run a workspace Lua file and wait for structured return values or errors from connected clients. |
| rba_execute_fileB | Execute a workspace Lua file in Roblox, either fire-and-forget send or eval with structured results. |
| rba_execute_bundleC | Execute multiple workspace Lua files in order with syntax checks, optional delay, and stop-on-error control. |
| rba_lua_syntax_checkA | Run local Lua syntax validation with luac for a workspace file or provided source before sending to Roblox. |
| rba_ping_clientsB | Ping connected clients and return round-trip timing plus basic place/job details. |
| rba_install_debug_runtimeC | Install debug helpers on connected clients and return an initial runtime snapshot. |
| rba_probe_runtimeB | Run a built-in realtime probe such as summary, character, camera, players, environment, or datamodel. |
| rba_install_console_mirrorB | Mirror client print/warn output back to RBA events with a Roblox-safe rate limit. |
| rba_script_preflightA | Statically inspect a workspace Lua file or provided source before execution: syntax, metrics, lifecycle/loop checks, dynamic loading, remote calls, and direct transform writes. Never executes the script. |
| rba_create_script_capsuleA | Create a named RBA script capsule: a permission-gated policy envelope around one workspace Lua file. Capsules preflight and snapshot source before dispatch; they do not claim to OS-sandbox code inside a Roblox executor. |
| rba_list_script_capsulesA | List registered script capsules and their explicit permissions, source file, timestamps, and policy-sandbox limitation. |
| rba_set_script_capsule_permissionsA | Replace a script capsule's explicit capability grants. The next capsule run is blocked when static source requirements are not granted. |
| rba_capsule_snapshotA | Create a source snapshot for one script capsule. Use it as a time-travel restore point before an edit or experiment. |
| rba_list_capsule_snapshotsA | List time-travel source snapshots for one RBA script capsule. |
| rba_rollback_script_capsuleA | Restore a capsule source file from a selected snapshot. RBA captures the current source first as a safety snapshot. |
| rba_run_script_capsuleA | Preflight, permission-check, optionally snapshot, and then dispatch a script capsule. Missing required permissions block the run before any Lua reaches a client. |
| rba_git_statusA | Inspect the RBA workspace Git repository, selected branch/origin, changed and staged files, and the exact autoloader fingerprint without changing Git state. |
| rba_git_sync_filesA | Explicitly commit selected existing RBA workspace files and optionally push the current branch. It refuses to run with a pre-staged index and never uses git add --all, so unrelated scripts are not swept into a sync. |
| rba_uninstall_console_mirrorC | Restore print/warn after rba_install_console_mirror. |
| rba_wait_for_eventB | Wait briefly for the next websocket event, optionally filtered by type and client id. |
| rba_context_snapshotC | Capture status, clients, recent events, runtime summary, and optional Roblox screenshot in one call. |
| rba_watch_fileA | Watch a workspace Lua file and auto-send or eval it in Roblox on change for live editing. |
| rba_start_live_sessionB | Watch multiple workspace Lua files as one live-editing session and optionally run them once immediately. |
| rba_unwatch_fileB | Stop one active RBA file watcher. |
| rba_stop_all_watchersA | Stop every active RBA live-edit file watcher. |
| rba_list_watchersA | List active RBA file watchers. |
| rba_list_script_profilesA | List script profiles from the workspace profile JSON file. |
| rba_run_script_profileC | Run a named script profile from the workspace profile JSON file. |
| rba_set_autorunB | Configure optional profile/file execution that runs automatically when a Roblox client connects. |
| rba_get_autorunA | Show the current RBA autorun-on-connect configuration. |
| rba_dashboard_startB | Start the local RBA dashboard HTTP server. |
| rba_dashboard_stopA | Stop the local RBA dashboard HTTP server. |
| rba_list_presetsA | List built-in Lua websocket presets. |
| rba_run_presetB | Run a built-in Lua preset on connected development clients. |
| rba_get_character_positionC | Return the local character position and CFrame from connected development clients. |
| rba_teleport_to_positionA | Teleport the local character to exact coordinates and remember the previous position. |
| rba_teleport_to_partC | Teleport the local character to a Workspace BasePart or Model path, with an optional local offset. |
| rba_return_to_last_teleportB | Return the local character to its position before the most recent RBA teleport. |
| rba_teleport_to_placeB | Teleport the local player to a Roblox place, optionally joining a specific public server job. |
| rba_write_fileC | Create or replace a file inside the RBA workspace. |
| rba_install_autoexecB | Install the current RBA autoloader into an executor autoexec path, backing up any existing file first. |
| rba_sync_autoexecA | Sync the workspace unified autoloader to one autoexec target, backing up changed content by default. |
| rba_sync_all_autoexecB | Sync the same unified RBA and Roblox Instance Manager autoloader to every configured executor target. |
| rba_autoexec_targetsA | Show every configured executor autoexec target and verify its installed loader hash against the workspace source. |
| rba_list_autoexec_backupsC | List sidecar backups created for an autoexec target. |
| rba_restore_autoexec_backupA | Restore an autoexec sidecar backup and preserve the currently installed file first. |
| rba_append_fileA | Append text to a file inside the RBA workspace, creating it when needed. |
| rba_read_fileA | Read a workspace file, capped to a safe byte limit. |
| rba_backup_fileB | Create a timestamped backup of a workspace file under .rba-backups. |
| rba_list_backupsA | List workspace file backups, optionally filtered to one original path. |
| rba_restore_backupB | Restore a .rba-backups file, first backing up the current destination when it exists. |
| rba_batch_filesC | Run multiple workspace file operations in one call. |
| rba_list_windowsA | List visible desktop windows that can be used as screenshot targets. |
| rba_capture_window_screenshotB | Capture a screenshot of a visible Windows process window and return it as an MCP image. |
| rba_capture_roblox_screenshotA | Capture RobloxPlayerBeta.exe and return the screenshot as an MCP image for visual context. |
| rba_read_imageA | Read a workspace PNG/JPEG file and return it as an MCP image. |
| rba_list_filesC | List files inside the RBA workspace. |
| rba_search_filesC | Search text files inside the RBA workspace. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/evonar543/roblox_bridge_agent'
If you have feedback or need assistance with the MCP directory API, please join our Discord server