Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Chrrxs/robloxstudio-mcp/llms.txt

Use this file to discover all available pages before exploring further.

Early versions of Roblox Studio MCP exposed separate, single-purpose tools for each playtest lifecycle event: start_playtest, stop_playtest, and a family of multiplayer_test_* tools for each multiplayer action. As the feature set grew, these split tools became hard to discover and their semantics were not always obvious. They were consolidated into two unified tools — solo_playtest and multiplayer_playtest — each of which accepts an action parameter to select the lifecycle operation. The deprecated tools are still callable by exact name for existing integrations that depend on them. However, they are no longer advertised through tools/list. An agent that discovers available tools by calling tools/list will not see these names and must use the unified replacements for all new integrations.

Migration table

Deprecated toolUnified replacement
start_playtestsolo_playtest action="start"
stop_playtestsolo_playtest action="stop"
multiplayer_test_startmultiplayer_playtest action="start"
multiplayer_test_statemultiplayer_playtest action="status"
multiplayer_test_add_playersmultiplayer_playtest action="add_players"
multiplayer_test_leave_clientmultiplayer_playtest action="leave_client"
multiplayer_test_endmultiplayer_playtest action="end" (disabled — see below)

Deprecated tool descriptions

start_playtest

Started a solo Studio playtest. Replaced by solo_playtest action="start" mode="play" (or mode="run" for a server-only run). The unified tool adds an explicit mode field, a configurable timeout, and an action="status" query path — none of which were available on the split tool.

stop_playtest

Stopped the active solo playtest. Replaced by solo_playtest action="stop". The unified tool adds a configurable stop timeout.

multiplayer_test_start

Started a StudioTestService multiplayer playtest with a given number of client players. Replaced by multiplayer_playtest action="start" numPlayers=N force=true. The unified tool adds the force acknowledgement flag (see note below), a testArgs field for passing data to StudioTestService:GetTestArgs(), and a configurable timeout.

multiplayer_test_state

Returned the current multiplayer playtest state. Replaced by multiplayer_playtest action="status". The unified tool name better matches the convention used for solo_playtest.

multiplayer_test_add_players

Added additional client players to a running multiplayer session. Replaced by multiplayer_playtest action="add_players" numPlayers=N.

multiplayer_test_leave_client

Removed a specific client from a running multiplayer session. Replaced by multiplayer_playtest action="leave_client" target="client-N". The unified tool defaults to target="client-1" when target is omitted.

multiplayer_test_end

Attempted to call StudioTestService:EndTest() to stop the multiplayer session programmatically. This always returned a disabled errorStudioTestService:EndTest() is broken in the MCP flow and cannot be used to cleanly end a multiplayer test session. The replacement, multiplayer_playtest action="end", preserves this behavior: it still returns the disabled error and the same broken-API reason. Multiplayer test windows must be closed manually regardless of which tool name is used.
multiplayer_test_end never worked and neither does multiplayer_playtest action="end". Do not use either to end a multiplayer test. Close the Studio multiplayer test windows manually when you are done.

Recommendation

Update any custom integrations, system prompts, or agent scaffolding that references the deprecated tool names. The unified tools provide a superset of the deprecated functionality and will continue to be maintained and extended. The deprecated tools receive no new features and may be removed in a future major version.
# Before (deprecated)
start_playtest
stop_playtest

# After (current)
solo_playtest action="start" mode="play"
solo_playtest action="stop"
# Before (deprecated)
multiplayer_test_start numPlayers=2
multiplayer_test_state
multiplayer_test_add_players numPlayers=1
multiplayer_test_leave_client target="client-1"

# After (current)
multiplayer_playtest action="start" numPlayers=2 force=true
multiplayer_playtest action="status"
multiplayer_playtest action="add_players" numPlayers=1
multiplayer_playtest action="leave_client" target="client-1"

Build docs developers (and LLMs) love