# Rootly — how to use (mcp.ai)

Connect your Rootly account and use 6 tools for IT operations straight from your AI agent. Connect with your own API key. Rootly is an AI-native incident management platform that automates workflows and collaboration, integrating with Slack, PagerDuty, and other tools to streamline incident response.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_rootly?ms=1787293680000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `rootly_delete_action_item`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/rootly`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/rootly/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/rootly/delete/action/item` — This tool allows for the deletion of a specific action item in Rootly. It complements the existing ROOTLY_LIST_ACTION_ITEMS functionality by providing the ability to remove individual action items fro
  - body: { action_item_id: string }
- `POST https://api.mcp.ai/api/rootly/delete/incident` — Tool to delete an incident in Rootly by ID. Use when performing administrative cleanup. This is a destructive operation and depends on appropriate Rootly permissions.
  - body: { id: string }
- `POST https://api.mcp.ai/api/rootly/get/action/item` — Retrieves detailed information about a specific action item by its ID from Rootly. Action items are tasks or follow-up items created during incident management to track work that needs to be completed
  - body: { action_item_id: string }
- `POST https://api.mcp.ai/api/rootly/get/incident` — Tool to retrieve full details for a single Rootly incident by ID. Use when you need complete incident information for drill-down after listing or searching incidents. Supports optional include paramet
  - body: { id: string, include?: string }
- `POST https://api.mcp.ai/api/rootly/list/action/items` — This tool retrieves a list of all action items for an organization in Rootly. Action items are tasks or follow-up items that need to be completed during or after an incident, helping to track and mana
  - body: { kind?: string, status?: string, priority?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/rootly/update/incident` — Tool to update fields on an existing Rootly incident by ID. Use when you need to modify incident status, severity, metadata, or other attributes. Supports updating title, status, summary, severity_id,
  - body: { id: string, data: object }

## Example prompts
- "What can I do in Rootly?"
- "Show me a summary of my Rootly account"

## More
- Page: https://mcp.ai/rootly
- Agent spec (llms.txt): https://mcp.ai/rootly/llms.txt
- Postman collection: https://mcp.ai/rootly/postman.json