set_cursor_position
Set the edit cursor to a specific position in seconds, enabling precise navigation for editing and mixing tasks.
Instructions
Move the edit cursor to a position in seconds.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| position | Yes |
Implementation Reference
- src/reaper_mcp/audio_tools.py:80-88 (handler)The tool handler that moves the edit cursor to a specified position (in seconds) by setting the reapy Project.cursor_position property.
@mcp.tool() def set_cursor_position(position: float) -> dict: """Move the edit cursor to a position in seconds.""" try: project = get_project() project.cursor_position = position return {"success": True, "position": project.cursor_position} except Exception as e: return {"success": False, "error": str(e)} - src/reaper_mcp/audio_tools.py:80-81 (registration)The tool is registered via the @mcp.tool() decorator inside register_tools(). The registration function is called from server.py line 24: _reg_audio(mcp)
@mcp.tool() def set_cursor_position(position: float) -> dict: - src/reaper_mcp/connection.py:27-29 (helper)Helper function that returns a reapy.Project instance, used by set_cursor_position to access cursor_position.
def get_project() -> reapy.Project: ensure_connected() return reapy.Project()