> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/sre-ai-agent/remote-mcp-server.md).

# Remote MCP Server

Connect AI assistants like **Claude (Desktop & Code CLI)**, **Cursor**, **ChatGPT**, and automated AI coding agents directly to Pagerly using the Model Context Protocol (MCP).

***

## ⚡ Overview

The Pagerly Remote MCP Server exposes your on-call schedules, incident management, SRE AI investigations, MTTR metrics, alert noise analytics, and Status Pages directly to your local or cloud AI tools.

* **Server Endpoint:** `https://api.pagerly.io/mcp`
* **Protocol:** JSON-RPC 2.0 over HTTP / SSE
* **Authentication:** OAuth 2.0 (Browser Login) or API Key (`Authorization: Bearer <token>`)

***

## 🛠️ Available MCP Tools

The server exposes **71 tools**. Your MCP client discovers them on connect, and the live list is always at [`https://api.pagerly.io/mcp/tools`](https://api.pagerly.io/mcp/tools). Arguments for every tool are in the [MCP developer reference](https://www.pagerly.io/docs/mcp).

Every call runs as you, in your workspace. Tools marked 🔒 need an organisation admin who ticked **Allow admin actions** (the `mcp:admin` scope) when connecting.

**Who is on call**

* `pagerly_get_oncall`, `pagerly_get_schedule`, `pagerly_get_rotation`, `pagerly_get_overrides`

**Teams and rotations**

* `pagerly_get_account_info`, `pagerly_get_teams`, `pagerly_get_team`
* `pagerly_create_team` 🔒, `pagerly_update_team`, `pagerly_delete_team` 🔒
* `pagerly_update_schedule`, `pagerly_update_rotation_users`, `pagerly_add_rotation_user`, `pagerly_remove_rotation_user`, `pagerly_set_permanent_user`, `pagerly_set_user_group`
* `pagerly_create_override`, `pagerly_delete_override`, `pagerly_swap_shifts`, `pagerly_set_reminder`, `pagerly_remove_reminder`

**Group on-calls** — one name that mentions several teams' on-calls

* `pagerly_list_group_oncalls`, `pagerly_upsert_group_oncall` 🔒, `pagerly_delete_group_oncall` 🔒

**Incidents**

* `pagerly_declare_incident` — declare like the dashboard does: channel per team settings, on-call (or an escalation policy) paged
* `pagerly_list_incidents`, `pagerly_get_incident`, `pagerly_create_incident` (records only), `pagerly_update_incident`
* `pagerly_add_incident_update` — post a written update to the timeline and Slack, optionally changing status or severity
* `pagerly_acknowledge_incident`, `pagerly_resolve_incident` — same as the Slack buttons
* `pagerly_incident_stats`, `pagerly_alert_noise_analysis`
* `pagerly_list_action_items`, `pagerly_create_action_item`, `pagerly_update_action_item`

**AI SRE**

* `pagerly_investigate_report` — run the AI SRE on a bug, like `@Pagerly assist`; it replies in Slack and returns a `reportId`
* `pagerly_get_investigation_report` — read the findings back into your AI assistant (`starting` → `running` → `done`)
* `pagerly_get_ai_investigation` — the AI summary attached to an incident, or start a fresh one

**Escalation policies and alerting**

* `pagerly_list_escalations`, `pagerly_get_escalation`
* `pagerly_create_escalation` 🔒, `pagerly_update_escalation` 🔒, `pagerly_delete_escalation` 🔒
* `pagerly_list_alert_integrations`, `pagerly_set_alert_target` 🔒, `pagerly_set_alert_rules` 🔒

**Status page**

* `pagerly_get_statuspage`, `pagerly_list_statuspage_components`, `pagerly_update_statuspage_component` (change status)
* `pagerly_create_statuspage_component`, `pagerly_edit_statuspage_component`, `pagerly_delete_statuspage_component`
* `pagerly_list_statuspage_groups`, `pagerly_create_statuspage_group`, `pagerly_delete_statuspage_group`
* `pagerly_list_statuspage_incidents`, `pagerly_get_statuspage_incident`, `pagerly_create_statuspage_incident`

**People and paging**

* `pagerly_list_users`, `pagerly_get_user`, `pagerly_upsert_user` 🔒, `pagerly_delete_user` 🔒
* `pagerly_test_page_user` — ring someone's phone to check Pagerly can reach them

**Sending work elsewhere**

* `pagerly_list_destinations`, `pagerly_post_to_team_channel`
* `pagerly_create_jira_issue`, `pagerly_list_jira_issue_types`, `pagerly_create_linear_issue`, `pagerly_create_asana_task`

***

## 🔑 Quick Setup

### 1. Claude Code CLI

Add the server via CLI:

```bash
claude mcp add pagerly --transport http https://api.pagerly.io/mcp
```

### 2. Claude Desktop & Cursor

Add to your `claude_desktop_config.json` or Cursor MCP settings:

### 3. Claude.ai Custom Connectors (Enterprise)

If Claude prompts for manual OAuth settings in custom connector options:

* **Server URL:** `https://api.pagerly.io/mcp`
* **Authorization URL:** `https://workspace.pagerly.io/oauth/authorize`
* **Token URL:** `https://workspace.pagerly.io/oauth/token`
* **OAuth Client ID:** `pagerly_mcp_client` *(or auto-registered via `.well-known` discovery)* Upon first query, Claude will prompt you to authenticate via OAuth browser login.