Open-source status page, incident response and uptime monitoring
TypeScript alertingincident-managementmcpmcp-servermonitoringmonitoring-as-codeobservabilityon-callopen-sourcesrestatus-pagestatuspagesynthetic-monitoringterraformtinybirdtursouptimeuptime-checkeruptime-monitor
chore: changelog and page-components tool (#2168)
Maximilian Kaske5f81fd9b7b5f
diff --git a/apps/dashboard/src/components/chat/tool-renderers/index.tsx b/apps/dashboard/src/components/chat/tool-renderers/index.tsxindex a4c00303b..f03370b68 100644--- a/apps/dashboard/src/components/chat/tool-renderers/index.tsx+++ b/apps/dashboard/src/components/chat/tool-renderers/index.tsx@@ -23,6 +23,7 @@ import { listAuditLogsTable } from "./list-audit-logs";import { listMaintenancesTable } from "./list-maintenances";import { listMonitorsTable } from "./list-monitors";import { listNotificationsTable } from "./list-notifications";+import { listPageComponentsTable } from "./list-page-components";import { listResponseLogsTable } from "./list-response-logs";import { listStatusPagesTable } from "./list-status-pages";import { listStatusReportsTable } from "./list-status-reports";@@ -61,6 +62,12 @@ export const toolRenderers: ToolRendererRegistry = {),summary: (o) => itemsCountSummary(o.items),},+ list_page_components: {+ renderResult: ({ output }) => (+ <ResultTable {...listPageComponentsTable(output)} />+ ),+ summary: (o) => itemsCountSummary(o.items),+ },list_status_reports: {renderResult: ({ output }) => (<ResultTable {...listStatusReportsTable(output)} />diff --git a/apps/dashboard/src/components/chat/tool-renderers/list-page-components.tsx b/apps/dashboard/src/components/chat/tool-renderers/list-page-components.tsxnew file mode 100644index 000000000..cfcd8fcb2--- /dev/null+++ b/apps/dashboard/src/components/chat/tool-renderers/list-page-components.tsx@@ -0,0 +1,50 @@+import type { AgentToolOutput } from "@openstatus/services/agent-tools";++import { TableCellLink } from "@/components/data-table/table-cell-link";+import { TableCellNumber } from "@/components/data-table/table-cell-number";+import { TableCellText } from "@/components/data-table/table-cell-text";++import type { ResultTableData } from "./result-table";++type Output = AgentToolOutput<"list_page_components">;++export function listPageComponentsTable(+ output: Output,+): ResultTableData<"name" | "type" | "page" | "monitor" | "id"> {+ const items = output?.items ?? [];+ return {+ empty: "No page components.",+ columns: [+ { key: "name", header: "Name" },+ { key: "type", header: "Type" },+ { key: "page", header: "Page" },+ { key: "monitor", header: "Monitor" },+ { key: "id", header: "ID" },+ ],+ rows: items.map((c) => ({+ id: c.id,+ cells: {+ name: (+ <TableCellLink+ href={`/status-pages/${c.pageId}/components`}+ value={c.name}+ />+ ),+ type: (+ <TableCellText+ value={c.type}+ className="font-mono text-muted-foreground"+ />+ ),+ page: <TableCellNumber value={c.pageId} />,+ monitor:+ c.monitorId !== null ? (+ <TableCellNumber value={c.monitorId} />+ ) : (+ <TableCellText value={null} />+ ),+ id: <TableCellNumber value={c.id} />,+ },+ })),+ };+}diff --git a/apps/docs/src/content/docs/reference/mcp-server.mdx b/apps/docs/src/content/docs/reference/mcp-server.mdxindex 001799e14..bbf90d1aa 100644--- a/apps/docs/src/content/docs/reference/mcp-server.mdx+++ b/apps/docs/src/content/docs/reference/mcp-server.mdx@@ -36,11 +36,12 @@ For AI agents that should only observe state — health summaries, paging on-cal## Tools-The server exposes 8 tools, scoped to the workspace tied to your API key. Mutations write to the audit log with `metadata.transport = "mcp"`.+The server exposes 9 tools, scoped to the workspace tied to your API key. Mutations write to the audit log with `metadata.transport = "mcp"`.| Tool | Type | Purpose ||----------------------------|----------|---------|| `list_status_pages` | read | List public status pages with their slug and id. Used to discover the `pageId` required by mutation tools. |+| `list_page_components` | read | List components on a status page with their id, name, type (`monitor` / `static`), and linked monitor. Used to discover the `pageComponentIds` accepted by `create_status_report`, `update_status_report`, and `create_maintenance`. || `list_status_reports` | read | List status reports newest-first. `filter: "active" \| "all"` (defaults to active = excludes resolved). Paginated via `page` (1-indexed) and `perPage`; response carries a `pagination` object with `page`, `perPage`, `totalSize`, and `totalPages`. || `list_maintenances` | read | List maintenance windows newest-first. Paginated via `page` (1-indexed) and `perPage`; response carries a `pagination` object with `page`, `perPage`, `totalSize`, and `totalPages`. || `create_status_report` | mutation | Create a new status report on a status page with an initial public update. |@@ -80,7 +81,7 @@ The tool's response includes a `notified: boolean` field so the assistant can co### Lookup-before-mutate-`create_status_report` and `create_maintenance` require a `pageId`. The tool descriptions instruct the model to call `list_status_pages` first; **never** type a numeric id you don't know — make the assistant resolve it.+`create_status_report` and `create_maintenance` require a `pageId`, and they (plus `update_status_report`) accept an optional `pageComponentIds`. The tool descriptions instruct the model to call `list_status_pages` for the `pageId` and `list_page_components` for component ids first; **never** type a numeric id you don't know — make the assistant resolve it. Ids that don't belong to the workspace (or, for components, to the supplied page) come back as `NOT_FOUND`.## Configure Claude Desktopdiff --git a/apps/docs/src/content/docs/tutorial/how-to-connect-openstatus-to-claude-code.mdx b/apps/docs/src/content/docs/tutorial/how-to-connect-openstatus-to-claude-code.mdxindex 44fa7c812..73ba70a79 100644--- a/apps/docs/src/content/docs/tutorial/how-to-connect-openstatus-to-claude-code.mdx+++ b/apps/docs/src/content/docs/tutorial/how-to-connect-openstatus-to-claude-code.mdx@@ -87,7 +87,7 @@ Open Claude Code and run:/mcp```-You should see `openstatus` listed as **connected**, with the registered tools (`list_status_pages`, `list_status_reports`, `list_maintenances`, and — if your key has write scope — `create_status_report`, `add_status_report_update`, `update_status_report`, `resolve_status_report`, `create_maintenance`).+You should see `openstatus` listed as **connected**, with the registered tools (`list_status_pages`, `list_page_components`, `list_status_reports`, `list_maintenances`, and — if your key has write scope — `create_status_report`, `add_status_report_update`, `update_status_report`, `resolve_status_report`, `create_maintenance`).If the server shows as disconnected, see [Troubleshooting](#troubleshooting) below.diff --git a/apps/server/src/routes/mcp/handler.test.ts b/apps/server/src/routes/mcp/handler.test.tsindex c18505cd8..e779e1756 100644--- a/apps/server/src/routes/mcp/handler.test.ts+++ b/apps/server/src/routes/mcp/handler.test.ts@@ -76,7 +76,7 @@ describe("MCP transport", () => {expect(res.status).toBe(401);});- test("tools/list returns the 17 registered tools", async () => {+ test("tools/list returns the 18 registered tools", async () => {const app = makeApp();const res = await app.fetch(jsonRpc({ method: "tools/list" }));expect(res.status).toBe(200);@@ -96,6 +96,7 @@ describe("MCP transport", () => {"list_maintenances","list_monitors","list_notifications",+ "list_page_components","list_response_logs","list_status_pages","list_status_reports",@@ -185,7 +186,7 @@ describe("MCP transport", () => {}[];}).tools;- expect(tools).toHaveLength(17);+ expect(tools).toHaveLength(18);for (const tool of tools) {expect(tool.description?.length ?? 0).toBeGreaterThan(40);expect(tool.inputSchema).toBeDefined();diff --git a/apps/server/src/routes/mcp/tools/page.ts b/apps/server/src/routes/mcp/tools/page.tsindex 15884c19a..aaaf04646 100644--- a/apps/server/src/routes/mcp/tools/page.ts+++ b/apps/server/src/routes/mcp/tools/page.ts@@ -3,7 +3,10 @@ import type {RegisteredTool,} from "@modelcontextprotocol/sdk/server/mcp.js";import type { ServiceContext } from "@openstatus/services";-import { listStatusPagesTool } from "@openstatus/services/agent-tools";+import {+ listPageComponentsTool,+ listStatusPagesTool,+} from "@openstatus/services/agent-tools";import { registerRegistryTools } from "./registry-adapter";@@ -18,5 +21,8 @@ export function registerPageTools(server: McpServer,ctx: ServiceContext,): Map<string, RegisteredTool> {- return registerRegistryTools(server, ctx, [listStatusPagesTool]);+ return registerRegistryTools(server, ctx, [+ listStatusPagesTool,+ listPageComponentsTool,+ ]);}diff --git a/apps/web/public/.well-known/agent-skills/openstatus-mcp/SKILL.md b/apps/web/public/.well-known/agent-skills/openstatus-mcp/SKILL.mdindex 4ff849d08..2ff995cde 100644--- a/apps/web/public/.well-known/agent-skills/openstatus-mcp/SKILL.md+++ b/apps/web/public/.well-known/agent-skills/openstatus-mcp/SKILL.md@@ -5,7 +5,7 @@ description: Use the openstatus MCP server to read and update status pages, stat# openstatus MCP server-The openstatus MCP server is a remote, streamable-HTTP endpoint at `https://api.openstatus.dev/mcp`. It exposes 8 tools scoped to a single workspace.+The openstatus MCP server is a remote, streamable-HTTP endpoint at `https://api.openstatus.dev/mcp`. It exposes 9 tools scoped to a single workspace.## Connect@@ -30,13 +30,14 @@ The `x-openstatus-key` header is the same API key used by the CLI, REST API, and## Tools- `list_status_pages` — discover pages the workspace owns.+- `list_page_components` — discover the components on a page (id, name, type, linked monitor). Resolves the `pageComponentIds` accepted by the create/update tools below.- `list_status_reports` — read incidents on a page.+- `list_maintenances` — read scheduled maintenance windows.- `create_status_report` — open a new incident.-- `append_status_report_update` — post an update on an open incident.+- `add_status_report_update` — post an update on an open incident.- `resolve_status_report` — close an incident.- `update_status_report` — edit incident metadata.- `create_maintenance` — schedule a maintenance window.-- `update_maintenance` — adjust a scheduled window.Every mutation tool requires an explicit `notify: true | false` argument. The model must decide whether subscribers are paged. There is no implicit default.diff --git a/apps/web/public/assets/changelog/chat-assistant.png b/apps/web/public/assets/changelog/chat-assistant.pngnew file mode 100644index 000000000..7e1b6d914Binary files /dev/null and b/apps/web/public/assets/changelog/chat-assistant.png differdiff --git a/apps/web/src/content/pages/blog/from-clickops-to-chatops.mdx b/apps/web/src/content/pages/blog/from-clickops-to-chatops.mdxindex 4cbb2b4ec..9bb1f4333 100644--- a/apps/web/src/content/pages/blog/from-clickops-to-chatops.mdx+++ b/apps/web/src/content/pages/blog/from-clickops-to-chatops.mdx@@ -47,11 +47,11 @@ The model has context for your workspace — your monitors, your status pages, y## The toolbox-There are seventeen tools today, split into two camps.+There are eighteen tools today, split into two camps.**Read tools** fire immediately. No approval needed — they only ever query.-- `list_status_pages` · `list_status_reports` · `list_maintenances`+- `list_status_pages` · `list_page_components` · `list_status_reports` · `list_maintenances`- `list_monitors` · `list_notifications` · `list_response_logs` · `list_audit_logs`- `get_monitor` · `get_monitor_status` · `get_monitor_summary` · `get_response_log` · `get_audit_log`@@ -60,7 +60,7 @@ There are seventeen tools today, split into two camps.- `create_status_report` · `add_status_report_update` · `update_status_report` · `resolve_status_report`- `create_maintenance`-All seventeen are declared once in `@openstatus/services/agent-tools`. The same registry powers the chat UI **and** the MCP server — shape-equivalence tests keep them honest. We'll add more (notification CRUD, monitor mutations, status-page editing) as we go.+All eighteen are declared once in `@openstatus/services/agent-tools`. The same registry powers the chat UI **and** the MCP server — shape-equivalence tests keep them honest. We'll add more (notification CRUD, monitor mutations, status-page editing) as we go.## The pretty part — how a tool call rendersdiff --git a/apps/web/src/content/pages/changelog/chat-assistant.mdx b/apps/web/src/content/pages/changelog/chat-assistant.mdxnew file mode 100644index 000000000..3c5c9c491--- /dev/null+++ b/apps/web/src/content/pages/changelog/chat-assistant.mdx@@ -0,0 +1,15 @@+---+title: "Chat Assistant"+description: "Ask about your workspace, draft status reports, and dig into monitors — without leaving the dashboard."+image: "/assets/changelog/chat-assistant.png"+publishedAt: "2026-05-16"+author: "openstatus"+category: "company"+---++Openstatus now ships a built-in chat assistant. Open `Assistant` from the dashboard sidebar and talk to your workspace in natural language — no MCP client, no Slack, no context-switching.++Every tool call renders inline as a table or change diff so you can see exactly what the assistant is about to do — and every mutation lands in the audit log under your actor.++Read the full write-up on [our blog](/blog/from-clickops-to-chatops).+diff --git a/apps/web/src/content/pages/product/tooling/mcp-server.mdx b/apps/web/src/content/pages/product/tooling/mcp-server.mdxindex 1c7ae3672..b7dd0c6ba 100644--- a/apps/web/src/content/pages/product/tooling/mcp-server.mdx+++ b/apps/web/src/content/pages/product/tooling/mcp-server.mdx@@ -37,9 +37,9 @@ Drop the snippet into your client's MCP config (`claude_desktop_config.json`, Cu## What you can do-The server exposes **17 tools** scoped to your workspace, grouped by entity:+The server exposes **18 tools** scoped to your workspace, grouped by entity:-- **Status pages** — `list_status_pages`+- **Status pages** — `list_status_pages` · `list_page_components`- **Status reports** — `list_status_reports` · `create_status_report` · `add_status_report_update` · `update_status_report` · `resolve_status_report`- **Maintenance** — `list_maintenances` · `create_maintenance`- **Monitors** — `list_monitors` · `get_monitor` · `get_monitor_status` · `get_monitor_summary`diff --git a/packages/services/src/agent-tools/__tests__/shape-equivalence.test.ts b/packages/services/src/agent-tools/__tests__/shape-equivalence.test.tsindex 3236f3e3c..6936b6805 100644--- a/packages/services/src/agent-tools/__tests__/shape-equivalence.test.ts+++ b/packages/services/src/agent-tools/__tests__/shape-equivalence.test.ts@@ -20,6 +20,13 @@ describe("agent-tool shape equivalence", () => {expect(parsed.success, parsed.error?.message).toBe(true);});+ test("list_page_components output matches schema", async () => {+ const tool = agentTools.list_page_components;+ const result = await tool.run({ ctx: teamCtx, input: {} });+ const parsed = tool.outputSchema.safeParse(result);+ expect(parsed.success, parsed.error?.message).toBe(true);+ });+test("list_status_reports output matches schema", async () => {const tool = agentTools.list_status_reports;const result = await tool.run({diff --git a/packages/services/src/agent-tools/index.ts b/packages/services/src/agent-tools/index.tsindex e6c6e20ab..013ed89e6 100644--- a/packages/services/src/agent-tools/index.ts+++ b/packages/services/src/agent-tools/index.ts@@ -12,6 +12,7 @@ import {} from "./monitor";import { listNotificationsTool } from "./notification";import { listStatusPagesTool } from "./page";+import { listPageComponentsTool } from "./page-component";import {addStatusReportUpdateTool,createStatusReportTool,@@ -36,6 +37,7 @@ export {} from "./monitor";export { listNotificationsTool } from "./notification";export { listStatusPagesTool } from "./page";+export { listPageComponentsTool } from "./page-component";export {addStatusReportUpdateTool,createStatusReportTool,@@ -67,6 +69,7 @@ export {*/export const agentTools = {list_status_pages: listStatusPagesTool,+ list_page_components: listPageComponentsTool,list_status_reports: listStatusReportsTool,create_status_report: createStatusReportTool,add_status_report_update: addStatusReportUpdateTool,diff --git a/packages/services/src/agent-tools/maintenance.ts b/packages/services/src/agent-tools/maintenance.tsindex 1ebfa802d..b6c630e50 100644--- a/packages/services/src/agent-tools/maintenance.ts+++ b/packages/services/src/agent-tools/maintenance.ts@@ -117,7 +117,7 @@ const CreateMaintenanceInputShape = z.object({.array(z.number().int()).default([]).describe(- "Optional component ids affected by the maintenance. Must belong to pageId.",+ "Optional component ids affected by the maintenance. Resolve via list_page_components({ pageId }) — never guess. Must belong to pageId.",),notify: z.boolean()@@ -141,7 +141,7 @@ export const createMaintenanceTool: AgentTool<> = {name: "create_maintenance",description:- "Schedule a maintenance window on a status page. PUBLIC, AUDIT-LOGGED, AND POTENTIALLY NOTIFIES SUBSCRIBERS — irreversible side effects. Subscriber notifications dispatch as part of this call only — no retroactive notify. The maintenance row persists even if the notify dispatch fails; `notified` reports the actual outcome. pageId MUST come from list_status_pages — never guess.",+ "Schedule a maintenance window on a status page. PUBLIC, AUDIT-LOGGED, AND POTENTIALLY NOTIFIES SUBSCRIBERS — irreversible side effects. Subscriber notifications dispatch as part of this call only — no retroactive notify. The maintenance row persists even if the notify dispatch fails; `notified` reports the actual outcome. pageId MUST come from list_status_pages — never guess. pageComponentIds (if supplied) MUST come from list_page_components({ pageId }) and belong to the same page.",scope: "write",destructive: true,inputSchema: CreateMaintenanceInputShape,diff --git a/packages/services/src/agent-tools/page-component.ts b/packages/services/src/agent-tools/page-component.tsnew file mode 100644index 000000000..58bd1e4c6--- /dev/null+++ b/packages/services/src/agent-tools/page-component.ts@@ -0,0 +1,55 @@+import { pageComponentTypes } from "@openstatus/db/src/schema";+import { z } from "zod";++import { listPageComponents } from "../page-component";+import type { AgentTool } from "./types";++const ListPageComponentsInputShape = z.object({+ pageId: z+ .number()+ .int()+ .optional()+ .describe(+ "If set, only components belonging to this page. Resolve via list_status_pages.",+ ),+});++const ListPageComponentsOutput = z.object({+ items: z.array(+ z.object({+ id: z.number().int(),+ name: z.string(),+ type: z.enum(pageComponentTypes),+ pageId: z.number().int(),+ monitorId: z.number().int().nullable(),+ }),+ ),+});++export const listPageComponentsTool: AgentTool<+ z.infer<typeof ListPageComponentsInputShape>,+ z.infer<typeof ListPageComponentsOutput>+> = {+ name: "list_page_components",+ description:+ "List page components in this workspace with their id, name, type ('monitor' or 'static'), pageId and linked monitorId. Use to discover the pageComponentIds required by create_status_report, create_maintenance, and update_status_report — those tools reject ids that don't belong to the workspace/page.",+ scope: "read",+ destructive: false,+ inputSchema: ListPageComponentsInputShape,+ outputSchema: ListPageComponentsOutput,+ async run({ ctx, input }) {+ const components = await listPageComponents({+ ctx,+ input: { pageId: input.pageId, order: "asc" },+ });+ return {+ items: components.map((c) => ({+ id: c.id,+ name: c.name,+ type: c.type,+ pageId: c.pageId,+ monitorId: c.monitorId ?? null,+ })),+ };+ },+};diff --git a/packages/services/src/agent-tools/prompt.ts b/packages/services/src/agent-tools/prompt.tsindex e400e0e11..157c4f983 100644--- a/packages/services/src/agent-tools/prompt.ts+++ b/packages/services/src/agent-tools/prompt.ts@@ -31,7 +31,7 @@ export function buildAgentSystemPrompt(opts: AgentSystemPromptOptions): string {opts.surface === "dashboard"? `\n\nAfter a tool returns, the dashboard already renders a structured view of the result:- Write tools (create_*, update_*, resolve_*, add_*) render a diff card with every input/output field (id, status, message, dates, notify outcome).-- List tools (list_status_pages, list_status_reports, list_maintenances, list_monitors, list_notifications, list_response_logs, list_audit_logs) render a table with one row per result.+- List tools (list_status_pages, list_page_components, list_status_reports, list_maintenances, list_monitors, list_notifications, list_response_logs, list_audit_logs) render a table with one row per result.- Detail tools (get_monitor, get_monitor_status, get_monitor_summary, get_response_log, get_audit_log) render a structured detail card.DO NOT restate that data in your reply — no markdown tables, no bullet recaps of the rows, no field-by-field summaries. A one-line acknowledgement ("You have 4 status reports — 3 active." / "Monitor 12 is healthy in 5/7 regions; failing in gru, fra." / "Incident resolved.") plus an optional next step is enough.`: "";@@ -57,9 +57,11 @@ Anti-guess rules — these are absolute:- Before referencing a status page: call list_status_pages.- Before referencing a status report: call list_status_reports.- Before referencing a maintenance window: call list_maintenances.+- Before referencing a page component (including by name like "the laser pointer"): call list_page_components({ pageId }).- Before referencing a monitor (including by name like "the API monitor"): call list_monitors.- Before referencing a notification channel: call list_notifications.- pageId on create_status_report and create_maintenance MUST come from list_status_pages. Guessing will cause a NOT_FOUND error.+- pageComponentIds on create_status_report, create_maintenance, and update_status_report MUST come from list_page_components for that page. Guessing will cause a NOT_FOUND error.Monitor diagnostics:- get_monitor_status returns one row per configured region (active/degraded/error). Report at the worst region's level: "Healthy in 5/7 regions; failing in gru, fra." Do NOT invent a composite "overall: degraded" label — the per-region facts ARE the answer.diff --git a/packages/services/src/agent-tools/status-report.ts b/packages/services/src/agent-tools/status-report.tsindex fcd6408c0..56645d7a4 100644--- a/packages/services/src/agent-tools/status-report.ts+++ b/packages/services/src/agent-tools/status-report.ts@@ -147,7 +147,7 @@ const CreateStatusReportInputShape = z.object({.array(z.number().int()).default([]).describe(- "Optional component ids affected by the incident. Must belong to pageId.",+ "Optional component ids affected by the incident. Resolve via list_page_components({ pageId }) — never guess. Must belong to pageId.",),date: z.iso.datetime()@@ -178,7 +178,7 @@ export const createStatusReportTool: AgentTool<> = {name: "create_status_report",description:- "Create a new status report on a public status page. PUBLIC, AUDIT-LOGGED, AND POTENTIALLY NOTIFIES SUBSCRIBERS — irreversible side effects. Subscriber notifications dispatch as part of this call only — no retroactive notify. The report persists even if the notify dispatch fails; `notified` reports the actual outcome. pageId MUST come from list_status_pages — never guess. pageComponentIds (if supplied) MUST belong to the same page.",+ "Create a new status report on a public status page. PUBLIC, AUDIT-LOGGED, AND POTENTIALLY NOTIFIES SUBSCRIBERS — irreversible side effects. Subscriber notifications dispatch as part of this call only — no retroactive notify. The report persists even if the notify dispatch fails; `notified` reports the actual outcome. pageId MUST come from list_status_pages — never guess. pageComponentIds (if supplied) MUST come from list_page_components({ pageId }) and belong to the same page.",scope: "write",destructive: true,inputSchema: CreateStatusReportInputShape,@@ -314,7 +314,7 @@ const UpdateStatusReportInputShape = z.object({.array(z.number().int()).optional().describe(- "Replace the full set of associated component ids. Empty array clears the association.",+ "Replace the full set of associated component ids. Resolve via list_page_components — never guess. Empty array clears the association.",),});