> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Rootly

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* List active incidents and the on-call for each.
* Open an incident with severity SEV2 for the API outage and page the on-call.
* Pull the post-mortem for the most recent SEV1.

## Available Tools

#### list\_alerts

Get a list of alerts with optional filtering by status, severity, or services.

#### create\_alert

Create a new alert with a title and severity level.

#### get\_alert

Get details about a specific alert by ID.

#### update\_alert

Update an alert's title, description, status, or severity.

#### list\_environments

Get a list of environments with optional filtering by name.

#### create\_environment

Create a new environment.

#### get\_environment

Get details about a specific environment by ID.

#### update\_environment

Update an environment's name, description, or notification settings.

#### delete\_environment

Permanently delete an environment.

#### list\_functionalities

Get a list of functionalities with optional filtering by name or services.

#### create\_functionality

Create a new functionality.

#### get\_functionality

Get details about a specific functionality by ID.

#### update\_functionality

Update a functionality's name, description, notifications, or services.

#### delete\_functionality

Permanently delete a functionality.

#### list\_incidents

Get a list of incidents with optional filtering by status, severity, services, or environments.

#### create\_incident

Create a new incident with a title and severity level.

#### get\_incident

Get details about a specific incident by ID.

#### update\_incident

Update an incident's properties like title, status, severity, or description.

#### delete\_incident

Permanently delete an incident.

#### resolve\_incident

Mark an incident as resolved with optional resolution summary and root cause.

#### mitigate\_incident

Mark an incident as mitigated with optional mitigation summary.

#### list\_incident\_action\_items

Get all follow-up action items for an incident.

#### create\_incident\_action\_item

Create a follow-up action item for an incident.

#### list\_services

Get a list of services with optional filtering by name.

#### create\_service

Create a new service.

#### get\_service

Get details about a specific service by ID.

#### update\_service

Update a service's name, description, or notification settings.

#### delete\_service

Permanently delete a service.

#### list\_teams

Get a list of teams with optional filtering by name.

#### create\_team

Create a new team.

#### get\_team

Get details about a specific team by ID.

#### update\_team

Update a team's name, description, or notification settings.

#### delete\_team

Permanently delete a team.

#### list\_users

Get a list of users with optional filtering by email or role.

#### get\_user

Get details about a specific user by ID.

#### update\_user

Update a user's name, timezone, or phone number.

#### get\_current\_user

Get information about the currently authenticated user.

#### list\_workflows

Get a list of workflows with optional filtering by name or enabled status.

#### create\_workflow

Create a new workflow.

#### get\_workflow

Get details about a specific workflow by ID.

#### update\_workflow

Update a workflow's name, description, or enabled status.

#### delete\_workflow

Permanently delete a workflow.