rename_track
Rename any track in REAPER by providing its index and a new name, keeping your project organized.
Instructions
Rename a track.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes | ||
| name | Yes |
Implementation Reference
- src/reaper_mcp/track_tools.py:51-60 (handler)Handler function that renames a track by index. Fetches the project, accesses the track by index, sets its name, and returns success/failure.
@mcp.tool() def rename_track(track_index: int, name: str) -> dict: """Rename a track.""" try: project = get_project() track = project.tracks[track_index] track.name = name return {"success": True, "track_index": track_index, "name": track.name} except Exception as e: return {"success": False, "error": str(e)} - src/reaper_mcp/track_tools.py:52-52 (schema)Input schema is defined via function signature: expects track_index (int) and name (str). Returns dict.
def rename_track(track_index: int, name: str) -> dict: - src/reaper_mcp/track_tools.py:51-60 (registration)Registered as an MCP tool via the @mcp.tool() decorator inside register_tools(mcp). The module-level registration is triggered from server.py line 21: _reg_track(mcp).
@mcp.tool() def rename_track(track_index: int, name: str) -> dict: """Rename a track.""" try: project = get_project() track = project.tracks[track_index] track.name = name return {"success": True, "track_index": track_index, "name": track.name} except Exception as e: return {"success": False, "error": str(e)} - src/reaper_mcp/server.py:21-21 (registration)Module-level registration call that passes the mcp instance to register_tools, which decorates rename_track with @mcp.tool().
_reg_track(mcp)