start #

{
  "name": "start",
  "resource": "account",
  "tier": "observe",
  "summary": "A connection's first read: the acting account (`id` and `standing`), the products the account holds under the profile rule (`products`), and its tzCloud applications as `list_applications` returns them (`applications`, absent where the account does not hold tzCloud), with `product_lines`, a line for each other product whose tools the connection lists and whose state `start` reads, empty where it lists none.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

{
  "name": "start",
  "title": "Start here",
  "tier": "observe",
  "scenario": "CHI-L0-04",
  "summary": "Call this first on a connection: in one read it returns the account your connection represents, the products the account holds, and its tzCloud applications with each environment's state. Read the overview (`read_context`, id `overview`) when you need a platform rule. For the account's sign-in identities and your session's own details, call `read_account`; for one application's live health, call `read_status`.",
  "owners": [
    "MCP-08"
  ]
}

{
  "request": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "account",
      "products",
      "product_lines",
      "detail"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call’s record row. Quote it when you report the call."
      },
      "account": {
        "type": "object",
        "required": [
          "id",
          "standing"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "standing": {
            "type": "string",
            "description": "The account's standing, `active` or `suspended`, as `read_account` returns it."
          }
        },
        "additionalProperties": false,
        "description": "The account your connection represents. `read_account` returns the rest of its record."
      },
      "products": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "The products the account holds, each by the product name `read_account` lists under `profiles`."
      },
      "applications": {
        "description": "The account's tzCloud applications as `list_applications` returns them, each with its environments and their states; absent where the account does not hold tzCloud.",
        "$ref": "#/shapes/list_applications"
      },
      "product_lines": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "product",
            "state",
            "door",
            "detail"
          ],
          "properties": {
            "product": {
              "type": "string",
              "description": "The product, by the name `read_account` lists under `profiles`."
            },
            "state": {
              "enum": [
                "read",
                "refused",
                "unavailable"
              ],
              "description": "`read` where the product's own server returned the line's read; `refused` where it refused it, its reason in `detail`; `unavailable` where it could not be read, so the line holds no state."
            },
            "door": {
              "type": "string",
              "description": "The address of the product's own MCP server the line was read from, which you may also connect to directly."
            },
            "space": {
              "type": [
                "string",
                "null"
              ],
              "description": "Where the product keeps issues: the id of the account's default issue space, as its server gave it; null where the server refused the read."
            },
            "waiting_for_person": {
              "type": [
                "integer",
                "null"
              ],
              "minimum": 0,
              "description": "Where the product keeps issues: how many issues in the default space wait for your person, counted on a first page of at most 100; null where the server refused the read."
            },
            "more_waiting": {
              "type": "boolean",
              "description": "True where more issues wait for your person beyond the counted page."
            },
            "detail": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "description": "For a person's sign-in connection, a line for each other product whose tools the connection lists and whose state start reads, read from that product's own server; empty for every other connection."
      },
      "detail": {
        "type": "string"
      }
    }
  }
}