> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clarion.cantina.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# incident.io

> Connect incident.io to Clarion so agents can create alerts in incident.io and use its incident-management tools during triage.

This guide walks you through connecting incident.io to Clarion. Once connected, agents can create alerts in incident.io — handing them off to your on-call and escalation policies — and, optionally, use incident.io's incident-management tools (incidents, alerts, on-call schedules, escalations) to investigate during triage.

<Note>
  **Estimated time:** 5 minutes. You'll need permission to create an **HTTP alert source** in incident.io, and (optionally) an **API key** for the incident-management tools.
</Note>

## Prerequisites

* An **incident.io** account with permission to manage alert sources
* A **Clarion workspace** with the incident.io integration page open

***

## Step 1 — Create an HTTP alert source in incident.io

For each destination Clarion should be able to raise alerts on:

1. In incident.io, go to **Alerts → Alert sources**.
2. Create a new **HTTP** alert source and give it a recognisable name, for example *Clarion — Production*.
3. Copy the **alert source config ID** shown in the source's URL and the **bearer token** incident.io generates for it.

Each alert source maps to one incident.io routing configuration. Create one per scenario if you want different alerts to follow different paths.

***

## Step 2 — Add the alert source in Clarion

1. In Clarion, open **Integrations** and find **incident.io**.
2. Under **Alert sources**, click **Add alert source**.
3. Enter a **name**, the **alert source config ID**, and the **bearer token** from Step 1.
4. Click **Connect incident.io** (or **Add alert source** if already connected).

Use the **Test** button next to a source to send a test alert and immediately resolve it, confirming the config ID and token are valid.

***

## Step 3 (optional) — Enable the incident-management tools

To let agents look up and manage incidents, alerts, on-call schedules, and escalations during triage:

1. In incident.io, create an **API key** under **Settings → API keys**.
2. In Clarion's incident.io integration page, paste the key under **MCP access** and click **Save**.

Write actions (creating or updating incidents, responding to escalations, starting analyses) always pause for human approval before they run.

***

## Using incident.io in a skill

Add the **incident.io** tools to a skill or workspace prompt so the agent can create an alert — or take other incident-management actions — when it decides, based on what it found during triage, that a situation warrants it. The incident.io alert links back to the originating Clarion issue.