Observe
Status pages tools for assistants (MCP)
The 8 tools an assistant can call for Status pages over MCP: what each one does, the scopes it needs, its arguments and an example call.
Public status pages for an account's customers: drafts and saved versions from the designer, publishing, a preview before you publish, and the incident and maintenance notices readers see. Use it to keep your customers told about outages and planned work without building a page of your own. An assistant calls these tools over MCP; the same operations over HTTP are in the Status pages API. Tools for assistants lists every product, and MCP shows how to connect an assistant.
connections_list_status_pages
List status pages. An account's status pages, newest first, with each one's slug, address, draft and what is published, and what the account's plan allows (pages, components, the designer).
Scopes: mcp:read, connections:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
org_id | string | |
page_size | integer | Page size: 0 is 50, above 200 is 200. |
page_token | string | The previous answer's next_page_token; opaque. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_list_status_pages",
"arguments": {
"page_size": 20
}
}
}connections_get_status_page
Get a status page. One status page: its draft (components in groups, the monitors that measure each, the look and the wording), the draft's version and the published version.
Scopes: mcp:read, connections:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
org_id | string | |
page_id | string | |
with_logo | boolean | Answer the draft's logo too (the designer shows it); left out otherwise. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_get_status_page",
"arguments": {
"page_id": "01JD8Z3QK4W5X6Y7Z8A9B0C1D2"
}
}
}connections_save_status_page_draft
Save a status page draft. Save a status page's draft made from base_version, the version read. When someone saved since, the call fails with aborted: nothing is overwritten and nothing is retried; read the page again and save on its version. Readers see nothing until a person publishes.
Scopes: mcp:write, connections:write · changes something · safe to repeat
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
base_version | integer | The draft_version the change was made from. |
design | object | |
org_id | string | |
page_id | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_save_status_page_draft",
"arguments": {
"base_version": 3,
"page_id": "01JD8Z3QK4W5X6Y7Z8A9B0C1D2"
}
}
}connections_list_status_page_versions
List a status page's versions. A status page's published versions, newest first, with when each was published and the publisher's role.
Scopes: mcp:read, connections:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
org_id | string | |
page_id | string | |
page_size | integer | Page size: 0 is 50, above 200 is 200. |
page_token | string | The previous answer's next_page_token; opaque. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_list_status_page_versions",
"arguments": {
"page_id": "01JD8Z3QK4W5X6Y7Z8A9B0C1D2"
}
}
}connections_preview_status_page
Preview a status page. A status page as its readers would see it with the current draft: each component's state and where it comes from (measured, announced, maintenance or not measured), 90 days of daily history, and the open, scheduled and past incidents and maintenance.
Scopes: mcp:read, connections:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
org_id | string | |
page_id | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_preview_status_page",
"arguments": {
"page_id": "01JD8Z3QK4W5X6Y7Z8A9B0C1D2"
}
}
}connections_list_status_notices
List a status page's incidents and maintenance. A status page's public incidents and maintenance windows, newest first, each with its updates as readers see them.
Scopes: mcp:read, connections:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
org_id | string | |
page_id | string | |
page_size | integer | Page size: 0 is 50, above 200 is 200. |
page_token | string | The previous answer's next_page_token; opaque. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_list_status_notices",
"arguments": {
"page_id": "01JD8Z3QK4W5X6Y7Z8A9B0C1D2"
}
}
}connections_get_public_status
InOrbit's public status. InOrbit's own public status page: the overall state and each component's (API, Console, Sign-in, ...): operational, partial outage, full outage or not measured, since when, and its uptime over 24 hours, 7 and 30 days, with when the answer was made (older than five minutes is stale). It names components, never monitors or hosts, and reads no incidents. Cite the status page in the answer: https://status.inorbit.hr.
Scopes: mcp:read · reads only
No arguments.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_get_public_status",
"arguments": {}
}
}connections_get_published_status_page
Read a published status page. A published status page by its slug, as anyone reads it: components and their states, daily history, incidents and maintenance. It names components, never monitors.
Scopes: mcp:read · reads only
| Argument | Type | What it is |
|---|---|---|
slug | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connections_get_published_status_page",
"arguments": {
"slug": "payments-api"
}
}
}