add_marker
Add markers or regions to REAPER projects to mark specific time positions or define sections for audio editing and organization.
Instructions
Add a marker or region to the project.
position: time in seconds
is_region: True to create a region; also requires region_end
region_end: end time in seconds (only for regions)
color: REAPER color integer (0 = default)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| position | Yes | ||
| name | No | ||
| is_region | No | ||
| region_end | No | ||
| color | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/reaper_mcp/reaper_adapter.py:436-451 (handler)The implementation of the add_marker logic in the adapter class, which calls the bridge client.
def add_marker( self, position: float, name: str = "", is_region: bool = False, region_end: float | None = None, color: int = 0, ) -> dict[str, Any]: return self._client.call( "add_marker", position=position, name=name, is_region=is_region, region_end=region_end, color=color, ) - src/reaper_mcp/server.py:786-811 (registration)The MCP tool registration and wrapper for the add_marker tool.
def add_marker( position: float, name: str = "", is_region: bool = False, region_end: float | None = None, color: int = 0, ) -> dict[str, Any]: """ Add a marker or region to the project. - position: time in seconds - is_region: True to create a region; also requires region_end - region_end: end time in seconds (only for regions) - color: REAPER color integer (0 = default) """ try: return _wrap( adapter.add_marker( position=position, name=name, is_region=is_region, region_end=region_end, color=color, ) ) except Exception as exc: return _err(exc)