# Instatus — how to use (mcp.ai)

Connect your Instatus account and use 15 tools for server monitoring straight from your AI agent. Connect with your own API key. Instatus is a status page and incident communication platform for managing service health, incidents, maintenance, monitors, and subscribers.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_instatus?ms=1787291220000`
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. `instatus_add_incident_update`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/instatus`
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/instatus/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/instatus/add/incident/update` — Post a public lifecycle update to an Instatus incident and change affected component states. This can send external notifications to page and affected-component subscribers when notify is true.
  - body: { notify?: boolean, status: string, message?: string, page_id: string, started_at?: string, incident_id: string, component_ids: string[], component_statuses: object[] }
- `POST https://api.mcp.ai/api/instatus/add/maintenance/update` — Post a public progress update to an Instatus maintenance, optionally changing its lifecycle, timing, and affected component states. This can send external notifications to page and affected-component 
  - body: { end_at?: string, notify?: boolean, status?: string, message?: string, page_id: string, started_at: string, component_ids?: string[], maintenance_id: string, component_statuses?: object[] }
- `POST https://api.mcp.ai/api/instatus/create/component` — Create a component on an Instatus status page. This changes the page's component configuration and can make the new component and its initial health status publicly visible.
  - body: { name: string, order?: integer, status?: string, grouped?: boolean, page_id: string, group_id?: string, description?: string, show_uptime?: boolean }
- `POST https://api.mcp.ai/api/instatus/create/incident` — Create an incident on an Instatus status page with optional affected component states. The incident is published publicly by default; notify=true can send notifications to page and affected-component 
  - body: { name: string, notify?: boolean, status: string, message?: string, page_id: string, started_at?: string, component_ids?: string[], should_publish?: boolean, component_statuses?: object[] }
- `POST https://api.mcp.ai/api/instatus/create/maintenance` — Schedule or start a maintenance on an Instatus status page. The required notification controls are side-effecting: notify can contact subscribers immediately, while notify_start, notify_end, and notif
  - body: { name: string, end_at: string, notify: boolean, status: string, message?: string, page_id: string, auto_end: boolean, start_at: string, expand_at?: string, auto_start: boolean, notify_end: boolean, is_collapsed?: boolean, notify_early: boolean, notify_start: boolean, component_ids: string[], notify_minutes?: integer, duration_minutes?: integer, component_statuses?: object[] }
- `POST https://api.mcp.ai/api/instatus/get/component` — Get the current health and configuration of one component on an Instatus status page.
  - body: { page_id: string, component_id: string }
- `POST https://api.mcp.ai/api/instatus/get/incident` — Get one Instatus incident with its affected components and update history.
  - body: { page_id: string, incident_id: string }
- `POST https://api.mcp.ai/api/instatus/get/maintenance` — Get one Instatus maintenance with its schedule, affected components, automation settings, and update history.
  - body: { page_id: string, maintenance_id: string }
- `POST https://api.mcp.ai/api/instatus/list/components` — List components and their current health for one Instatus status page, including child components where present. Pass the response's next_cursor back unchanged to fetch another page.
  - body: { page_id: string, per_page?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/instatus/list/incidents` — List incidents for an Instatus status page, optionally including or excluding lifecycle statuses.
  - body: { page_id: string, per_page?: integer, next_cursor?: string, exclude_statuses?: string, include_statuses?: string }
- `POST https://api.mcp.ai/api/instatus/list/maintenances` — List scheduled and historical maintenances for an Instatus status page.
  - body: { page_id: string, per_page?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/instatus/list/status/pages` — List status pages available to the connected Instatus account so an agent can discover page IDs for component, incident, and maintenance operations.
  - body: { per_page?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/instatus/update/component` — Change a component's health or presentation on an Instatus status page.
  - body: { name?: string, order?: integer, status?: string, grouped?: boolean, page_id: string, description?: string, show_uptime?: boolean, component_id: string }
- `POST https://api.mcp.ai/api/instatus/update/incident` — Edit an existing Instatus incident's name, timing, lifecycle status, affected components, or component states. Setting notify to true sends notifications to page and affected-component subscribers.
  - body: { name?: string, notify?: boolean, status?: string, page_id: string, started_at: string, incident_id: string, component_ids?: string[], component_statuses?: object[] }
- `POST https://api.mcp.ai/api/instatus/update/maintenance` — Fully replace an Instatus maintenance's public message, schedule, lifecycle state, affected components and states, and automation settings. Call INSTATUS_GET_MAINTENANCE first and preserve unchanged v
  - body: { name?: string, end_at: string, notify: boolean, status: string, message: string, page_id: string, auto_end: boolean, start_at: string, auto_start: boolean, component_ids: string[], maintenance_id: string, duration_minutes: integer, component_statuses: object[] }

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

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