> 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.

# FireHydrant

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

## Sample use cases

* List active incidents and show me the on-call for each.
* Open an incident with severity SEV2 for the checkout outage and page the on-call.
* Pull the post-mortem for the most recent SEV1 and post it in #engineering.

## Available Tools

#### list_environments

List environments with optional search query. Supports pagination.

#### create_environment

Create a new environment with a name and optional description.

#### get_environment

Get environment details by ID.

#### update_environment

Update an environment's name or description.

#### delete_environment

Delete an environment by ID.

#### list_incidents

List incidents with optional filters by status or search query. Supports pagination.

#### create_incident

Create a new incident with name, optional summary, severity, and team assignments.

#### get_incident

Get incident details by ID.

#### update_incident

Update an incident's name, summary, severity, or status.

#### resolve_incident

Resolve an incident by ID.

#### delete_incident

Delete (archive) an incident by ID.

#### list_runbooks

List runbooks with optional search query. Supports pagination.

#### get_runbook

Get runbook details by ID.

#### list_services

List services with optional search query. Supports pagination.

#### create_service

Create a new service with a name and optional description.

#### get_service

Get service details by ID.

#### update_service

Update a service's name or description.

#### delete_service

Delete a service by ID.

#### list_severities

List all available severities. Supports pagination.

#### list_incident_tasks

List tasks for an incident with pagination.

#### create_incident_task

Create a new task for an incident.

#### get_incident_task

Get details for a specific task in an incident.

#### update_incident_task

Update a task in an incident.

#### delete_incident_task

Delete a task from an incident.

#### list_teams

List teams with optional search query. Supports pagination.

#### create_team

Create a new team with a name and optional description.

#### get_team

Get team details by ID.

#### update_team

Update a team's name or description.

#### delete_team

Delete a team by ID.

#### list_users

List users with optional search query. Supports pagination.

#### get_user

Get user details by ID.