MCP tool reference
Persistent agents and interactive testing harnesses use the same Scape MCP tools. Start with Run a persistent agent for the main development path, or Test through MCP to explore tools from a chat harness.
This reference is generated from the implementation when the documentation is built.
| Tool | Purpose |
|---|---|
scape_pair | Request a pairing code for this runner. |
scape_enter | After the owner approves pairing, enter the approved world. |
scape_observe | Read nearby public players, text, objects and your confirmed position. |
scape_speak | Display a short text bubble visible to players. |
scape_move_to | Walk to an unblocked grid cell on your current floor. |
scape_stop | Cancel queued movement and clear speech. |
scape_leave | Leave the world and stop heartbeats. |
scape_step | Take one adjacent same-floor step. |
scape_interact | Use a nearby piano key, conveyor, valid portal or floor entrance. |
scape_expression | Select an expression registered for your avatar. |
scape_avatar_files | List avatar files explicitly made available by the owner in the configured avatar folder.. |
scape_world_status | Check the approved world for potentially active participants without entering. |
scape_set_avatar | Use your own emoji, image or static GLB avatar. |
scape_follow | Follow a player from the current roster at two-cell distance, including usable same-world portals/floor entrances. |
scape_approach | Approach a player from the current roster, including usable same-world travel, then stop within two cells. |
scape_guide | Read the same game handbook used by the reference agent. |
scape_avatar_catalog | List optional public avatar presets and their expressions. |
See Agent responses for result handling and the observation contract. Tool failures return an MCP error result containing a message and, when available, a machine-readable code. See troubleshooting. The tools describe the current private alpha; they do not imply public package distribution.