instatus_create_incident

CREATES a new incident — this MODIFIES live status-page data and can notify subscribers. Provide `name` (required); optionally set the initial `message`, affected `components`, per-component impact via `statuses`, `status`, `started`, `notify`, and `shouldPublish`. Instatus: POST /v1/{page_id}/incidents. Returns the created incident.

destructive

Argument	Type	Description
name*	string	Incident title (required).
notify	boolean	Whether to notify subscribers about this update.
status	string	Incident status.
message	string	Incident update message (Markdown supported).
page_id*	string	The status page's id.
started	string	ISO 8601 timestamp for when the incident started.
statuses	array	Per-component impact — set each listed component's status for this event.
components	array	Component ids affected by this incident.
shouldPublish	boolean	Whether the incident should be published to the status page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Incident title (required)."
    },
    "notify": {
      "type": "boolean",
      "description": "Whether to notify subscribers about this update."
    },
    "status": {
      "enum": [
        "INVESTIGATING",
        "IDENTIFIED",
        "MONITORING",
        "RESOLVED"
      ],
      "type": "string",
      "description": "Incident status."
    },
    "message": {
      "type": "string",
      "description": "Incident update message (Markdown supported)."
    },
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "started": {
      "type": "string",
      "description": "ISO 8601 timestamp for when the incident started."
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The affected component's id."
          },
          "status": {
            "enum": [
              "OPERATIONAL",
              "UNDERMAINTENANCE",
              "DEGRADEDPERFORMANCE",
              "PARTIALOUTAGE",
              "MAJOROUTAGE"
            ],
            "type": "string",
            "description": "The impact status to set on that component."
          }
        }
      },
      "description": "Per-component impact — set each listed component's status for this event."
    },
    "components": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Component ids affected by this incident."
    },
    "shouldPublish": {
      "type": "boolean",
      "description": "Whether the incident should be published to the status page."
    }
  }
}

instatus_create_maintenance

CREATES a new scheduled maintenance — this MODIFIES live status-page data and can notify subscribers. Provide `name` (required); optionally set `message`, affected `components`, per-component impact via `statuses`, `status`, `start`/`end`, `duration`, and `notify`. Instatus: POST /v1/{page_id}/maintenances. Returns the created maintenance.

destructive

Argument	Type	Description
end	string	ISO 8601 timestamp for when the maintenance ends.
name*	string	Maintenance title (required).
start	string	ISO 8601 timestamp for when the maintenance starts.
notify	boolean	Whether to notify subscribers about this update.
status	string	Maintenance status.
message	string	Maintenance update message (Markdown supported).
page_id*	string	The status page's id.
duration	integer	Maintenance duration in minutes.

instatus_delete_incident

PERMANENTLY DELETES an incident by id — this MODIFIES live status-page data and cannot be undone. Instatus: DELETE /v1/{page_id}/incidents/{incident_id}.

destructive

Argument	Type	Description
page_id*	string	The status page's id.
incident_id*	string	The incident's id to delete.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id",
    "incident_id"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "incident_id": {
      "type": "string",
      "description": "The incident's id to delete."
    }
  }
}

instatus_delete_maintenance

PERMANENTLY DELETES a scheduled maintenance by id — this MODIFIES live status-page data and cannot be undone. Instatus: DELETE /v1/{page_id}/maintenances/{maintenance_id}.

destructive

Argument	Type	Description
page_id*	string	The status page's id.
maintenance_id*	string	The maintenance's id to delete.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id",
    "maintenance_id"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "maintenance_id": {
      "type": "string",
      "description": "The maintenance's id to delete."
    }
  }
}

instatus_get_component

Get a single component by id — its full state (name, description, status, order, showUptime, grouped, archived). Instatus: GET /v2/{page_id}/components/{component_id}.

read-only

Argument	Type	Description
page_id*	string	The status page's id.
component_id*	string	The component's id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id",
    "component_id"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "component_id": {
      "type": "string",
      "description": "The component's id."
    }
  }
}

instatus_get_incident

Get a single incident by id — its full state including its update timeline and affected components. Instatus: GET /v1/{page_id}/incidents/{incident_id}.

read-only

Argument	Type	Description
page_id*	string	The status page's id.
incident_id*	string	The incident's id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id",
    "incident_id"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "incident_id": {
      "type": "string",
      "description": "The incident's id."
    }
  }
}

instatus_get_maintenance

Get a single scheduled maintenance by id — its full state including its update timeline and affected components. Instatus: GET /v1/{page_id}/maintenances/{maintenance_id}.

read-only

Argument	Type	Description
page_id*	string	The status page's id.
maintenance_id*	string	The maintenance's id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id",
    "maintenance_id"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "maintenance_id": {
      "type": "string",
      "description": "The maintenance's id."
    }
  }
}

instatus_list_components

List a status page's components — id, name, description, status, order, showUptime, grouped, archived. The component ids are what you set impact on. Instatus: GET /v2/{page_id}/components.

read-only

Argument	Type	Description
page	integer	Page number to fetch (default 1).
page_id*	string	The status page's id (from list_pages).
per_page	integer	Items per page (default 50, max 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number to fetch (default 1)."
    },
    "page_id": {
      "type": "string",
      "description": "The status page's id (from list_pages)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 50, max 100)."
    }
  }
}

instatus_list_incidents

List a status page's incidents, most recent first — optionally filtered by status. Each incident: id, name, status, impact, affected components, updates, timestamps. Instatus: GET /v1/{page_id}/incidents.

read-only

Argument	Type	Description
page	integer	Page number to fetch (default 1).
status	string	Filter to incidents with this status (INVESTIGATING, IDENTIFIED, MONITORING, RESOLVED).
page_id*	string	The status page's id.
per_page	integer	Items per page (default 50, max 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number to fetch (default 1)."
    },
    "status": {
      "enum": [
        "INVESTIGATING",
        "IDENTIFIED",
        "MONITORING",
        "RESOLVED"
      ],
      "type": "string",
      "description": "Filter to incidents with this status (INVESTIGATING, IDENTIFIED, MONITORING, RESOLVED)."
    },
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 50, max 100)."
    }
  }
}

instatus_list_maintenances

List a status page's scheduled maintenances, most recent first — id, name, status, affected components, start/end, updates. Instatus: GET /v2/{page_id}/maintenances.

read-only

Argument	Type	Description
page	integer	Page number to fetch (default 1).
page_id*	string	The status page's id.
per_page	integer	Items per page (default 50, max 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "page_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number to fetch (default 1)."
    },
    "page_id": {
      "type": "string",
      "description": "The status page's id."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 50, max 100)."
    }
  }
}

instatus_list_pages

List all status pages on the account — each page's id, subdomain, name, status, url, custom domain, and timestamps. The page id is what every other tool takes as `page_id`. Instatus: GET /v2/pages.

read-only

Argument	Type	Description
page	integer	Page number to fetch (default 1).
per_page	integer	Items per page (default 50, max 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number to fetch (default 1)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 50, max 100)."
    }
  }
}

instatus_update_component

UPDATES a component by id — this MODIFIES live status-page data. The key way to set a component's operational status (OPERATIONAL, UNDERMAINTENANCE, DEGRADEDPERFORMANCE, PARTIALOUTAGE, MAJOROUTAGE). Send only the fields you want to change. Instatus: PUT /v2/{page_id}/components/{component_id}. Returns the updated component.

destructive

Argument	Type	Description
name	string	Component name.
order	integer	Display order of the component on the page.
status	string	Operational status of the component.
grouped	boolean	Whether the component is displayed within a group.
page_id*	string	The status page's id.
archived	boolean	Whether the component is archived (hidden).
showUptime	boolean	Whether to show the uptime graph for this component.
description	string	Free-form component description.
component_id

instatus_update_incident

UPDATES an existing incident by id — this MODIFIES live status-page data and can notify subscribers (e.g. move it to MONITORING or RESOLVED). Send only the fields you want to change. Instatus: PUT /v1/{page_id}/incidents/{incident_id}. Returns the updated incident.

destructive

Argument	Type	Description
name	string	Incident title.
notify	boolean	Whether to notify subscribers about this update.
status	string	Incident status.
message	string	Incident update message (Markdown supported).
page_id*	string	The status page's id.
started	string	ISO 8601 timestamp for when the incident started.
statuses	array	Per-component impact — set each listed component's status for this event.
components	array	Component ids affected by this incident.
incident_id*

instatus_update_maintenance

UPDATES an existing scheduled maintenance by id — this MODIFIES live status-page data and can notify subscribers. Send only the fields you want to change. Instatus: PUT /v1/{page_id}/maintenances/{maintenance_id}. Returns the updated maintenance.

destructive

Argument	Type	Description
end	string	ISO 8601 timestamp for when the maintenance ends.
name	string	Maintenance title.
start	string	ISO 8601 timestamp for when the maintenance starts.
notify	boolean	Whether to notify subscribers about this update.
status	string	Maintenance status.
message	string	Maintenance update message (Markdown supported).
page_id*	string	The status page's id.
duration	integer	Maintenance duration in minutes.
statuses	array	Per-component impact — set each listed component's status for this event.

Instatus MCP by usefulapi

Try it

instatus_create_incident Destructive

Instatus MCP by usefulapi

Try it

instatus_create_incident Destructive

Tools (14)