⚡ Roblox Dex MCP Server (rbxmcp)

A comprehensive Model Context Protocol (MCP) server bringing the complete power of Dark Dex Explorer & Properties, Dex Console, Script Decompiler, 3D Spatial Inspector, Remotes, and Executor Environment Tools to your MCP clients (Claude Desktop, Cursor, Antigravity, etc.).

---

🚀 Quick Start

1. Start the MCP Server

python3 /root/rbxmcp/start.py

(Or run standalone web dashboard with python3 /root/rbxmcp/start.py --bridge-only)

2. Connect Your Roblox Game

Execute this one-liner in your Roblox executor (Synapse, Wave, Delta, Solara, Krnl, Fluxus, Arceus X, Codex, Studio, etc.):

loadstring(game:HttpGet("http://127.0.0.1:8765/client.lua"))()

---

🛠️ Complete 40 MCP Tools Reference

💻 1. Console, Logs & Performance

• dex_get_console_logs: Retrieve Roblox client console logs (LogService:GetLogHistory()) with type filtering (all, Output, Info, Warning, Error) and keyword search.
• dex_clear_console_logs: Clear the console history log buffer.
• dex_get_performance_stats: Detailed memory breakdown by category (Physics, Textures, Meshes, Gui, Sounds, Instances, LuaHeap, Scripts), FPS, Ping, and Network throughput.

🌳 2. Explorer & Hierarchy Navigation

• dex_get_hierarchy: Tree-view explorer with configurable depth, max child limits, and class names (Dark Dex Explorer).
• dex_find_parts: Search instances by name pattern (glob/fuzzy) and class name.
• dex_get_part_location: Exact 3D bounding box, Position, Orientation, CFrame, Size, Mass, AssemblyLinearVelocity, and collision flags.
• dex_get_instance_path: Find the full hierarchical path string of any named instance.
• dex_clone_instance: Deep clone any Instance and reparent it.
• dex_rename_instance: Rename an instance dynamically.
• dex_reparent_instance: Move instances across the hierarchy.
• dex_clear_children: Delete children of an instance with optional class filter.
• dex_get_nil_instances: Scan and return instances parented to nil (getnilinstances()).

⚙️ 3. Properties, Attributes & Tags

• dex_get_properties: Full property reflection matching Dex Properties Window with type serialization (Vector3, CFrame, Color3, BrickColor, Enum, UDim2, etc.).
• dex_set_properties: Modify multiple properties on an instance with automated type conversion.
• dex_get_attributes: Read all user-defined attributes on an instance.
• dex_set_attribute: Create or update attributes.
• dex_add_tag / dex_remove_tag: Add or remove CollectionService tags.
• dex_get_tagged_instances: Retrieve all instances with a specific tag.

📜 4. Script Viewer, Decompiler & Bytecode

• dex_list_scripts: List all LocalScript and ModuleScript instances with parent containers and enabled states.
• dex_decompile_script: Decompile and view the Luau source code of any script or module.
• dex_require_module: Require a ModuleScript in runtime and inspect returned tables and functions.
• dex_get_running_scripts: Query active threads in the Lua VM via getrunningscripts().
• dex_get_loaded_modules: List all cached modules using getloadedmodules().

🌐 5. Remotes & Networking

• dex_list_remotes: Discover all RemoteEvent and RemoteFunction objects across ReplicatedStorage and Workspace.
• dex_fire_remote: Fire or invoke remote events/functions with custom arguments.

🎯 6. World Interactions, Teleportation & Visuals

• dex_fire_click_detector: Trigger ClickDetector clicks at any distance.
• dex_fire_proximity_prompt: Instantly trigger ProximityPrompt without holding.
• dex_fire_touch_interest: Simulate physical touch between two parts.
• dex_teleport_player: Safely teleport the local player to any Part, Model, Player, or coordinates.
• dex_get_players: List players with health, team, position, and inventory data.
• dex_highlight_instance: Draw 3D bounding highlight boxes around instances.
• dex_get_game_info: Retrieve Place ID, Job ID, Universe ID, Game Name, and Creator info.
• dex_save_instance: Save game/model hierarchy to a .rbxl / .rbxm file using saveinstance().

---

📄 License

MIT License. Inspired by Dark Dex V3 / Dex++ by Moon & Dex Developers.