Connections, part 2 of 2 MCP tools

Connections and connectors, monitors and their runs, status pages and GitHub facts. These are 11 tools of the 22 tools of the connections backend (part 2 of 2; the others are part 1); all MCP tools lists the other backends.

connections_list_connectorsCopy Anchor Link

List connectors. The connector catalogue: every app a connection can be made from, how it authenticates, its settings and its actions. The same for every caller.

Scopes: mcp:read, connections:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_connectors",
    "arguments": {}
  }
}

connections_list_grantsCopy Anchor Link

List grants. The connection's grants, live, expired and revoked.

Scopes: mcp:read, connections:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_grants",
    "arguments": {}
  }
}

connections_list_kindsCopy Anchor Link

List kinds. The kinds registry: what a connection can be, how it authenticates, its configuration and every action with its class and typed parameters.

Scopes: mcp:read, connections:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_kinds",
    "arguments": {}
  }
}

connections_list_monitor_runsCopy Anchor Link

List a monitor's checks. A monitor's check runs, newest first: when each ran, from where (cloud or an agent), pass or fail, latency and the kind of error. Never a response body. This is the evidence for whether something was really down.

Scopes: mcp:read, connections:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_monitor_runs",
    "arguments": {}
  }
}

connections_list_monitorsCopy Anchor Link

List monitors. An account's monitors, newest first, each with its state (up, down, unknown, paused), target kind, interval and where it checks from. Narrow by connection_id, agent_id, category or tags (key:value). org_id is the account (accounts_get_me names yours).

Scopes: mcp:read, connections:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_monitors",
    "arguments": {}
  }
}

connections_list_status_noticesCopy Anchor Link

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_status_notices",
    "arguments": {}
  }
}

connections_list_status_page_versionsCopy Anchor Link

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_status_page_versions",
    "arguments": {}
  }
}

connections_list_status_pagesCopy Anchor Link

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_status_pages",
    "arguments": {}
  }
}

connections_list_toolsCopy Anchor Link

List tools. The caller's granted actions as typed tools: a name, a description and the JSON Schema of the parameters. What MCP lists for the same caller.

Scopes: mcp:read, connections:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_list_tools",
    "arguments": {}
  }
}

connections_preview_status_pageCopy Anchor Link

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_preview_status_page",
    "arguments": {}
  }
}

connections_save_status_page_draftCopy Anchor Link

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connections_save_status_page_draft",
    "arguments": {}
  }
}