MCP Tools Reference

Complete reference for all RbxSync MCP tools.

extract_game

Extract the connected game to files.

Input:

{}

Output:

{
  "success": true,
  "instances": 1247,
  "path": "/Users/you/MyGame/src"
}

sync_to_studio

Push local file changes to Studio.

Input:

{
  "path": "/Users/you/MyGame"  // optional
}

Output:

{
  "success": true,
  "changes": 5
}

run_code

Execute Luau code in Studio.

Input:

{
  "code": "print('Hello from MCP!')"
}

Output:

{
  "success": true,
  "output": "Hello from MCP!"
}

run_test

Run a playtest with console output capture.

Input:

{
  "duration": 10,  // seconds (default: 5)
  "mode": "Play"   // "Play" or "Run" (default: "Play")
}

Parameters:

Parameter	Type	Default	Description
duration	number	5	How long to run the test in seconds
mode	string	"Play"	"Play" for solo playtest (F5), "Run" for server simulation

Output:

{
  "success": true,
  "output": [
    { "type": "info", "message": "Game started" },
    { "type": "warn", "message": "Low memory" },
    { "type": "error", "message": "Script error" }
  ]
}

stop_test

Stop the current playtest.

Input:

{}

Output:

{
  "success": true
}

git_status

Get the git status of the project.

Input:

{
  "path": "/Users/you/MyGame"  // optional
}

Output:

{
  "branch": "main",
  "staged": ["src/ServerScriptService/Main.server.luau"],
  "modified": ["src/ReplicatedStorage/Config.luau"],
  "untracked": []
}

git_commit

Commit staged changes.

Input:

{
  "message": "Add player spawning logic",
  "path": "/Users/you/MyGame"  // optional
}

Output:

{
  "success": true,
  "commit": "abc1234"
}

Example Workflow

Here's how an AI might use these tools:

1. Extract current state

   { "tool": "extract_game" }

2. Modify code (using file tools)

3. Sync changes

   { "tool": "sync_to_studio" }

4. Run test

   { "tool": "run_test", "arguments": { "mode": "play" } }

5. Check output for errors

6. Fix and repeat until tests pass

7. Commit changes

   { "tool": "git_commit", "arguments": { "message": "Fix player spawn bug" } }