Sign in
Docs
0%

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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
org_idstring
page_sizeintegerPage size: 0 is 50, above 200 is 200.
page_tokenstringThe 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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
org_idstring
page_idstring
with_logobooleanAnswer 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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
base_versionintegerThe draft_version the change was made from.
designobject
org_idstring
page_idstring
{
  "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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
org_idstring
page_idstring
page_sizeintegerPage size: 0 is 50, above 200 is 200.
page_tokenstringThe 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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
org_idstring
page_idstring
{
  "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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
org_idstring
page_idstring
page_sizeintegerPage size: 0 is 50, above 200 is 200.
page_tokenstringThe 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

ArgumentTypeWhat it is
slugstring
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_get_published_status_page",
    "arguments": {
      "slug": "payments-api"
    }
  }
}