Skip to main content
Glama

GetLaunch

Read-onlyIdempotent

Inspect a single launch by ID for full detail: status, timestamps, which subgraphs changed, composition errors, and the schema diff summary. Use to drill into a specific launch — e.g. a failed or superseded one found via GetLaunchHistory (pass its id here). Provide the graph ID, variant name, and launch ID.

Input Schema

NameRequiredDescriptionDefault
graphIdYes
variantYes
launchIdYes

Output Schema

NameRequiredDescriptionDefault
dataNo
errorsNo
extensionsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / data / properties / graph / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "variant": {
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "launch": {
      -                "anyOf": [
      -                  {
      -                    "properties": {
      -                      "completedAt": {
      -                        "anyOf": [
      -                          {
      -                            "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "The timestamp when the launch completed. This value is null until the launch completes."
      -                      },
      -                      "createdAt": {
      -                        "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      -                      },
      -                      "id": {
      -                        "description": "The unique identifier for this launch.",
      -                        "oneOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "integer"
      -                          }
      -                        ]
      -                      },
      -                      "publication": {
      -                        "anyOf": [
      -                          {
      -                            "properties": {
      -                              "compositionResult": {
      -                                "anyOf": [
      -                                  {
      -                                    "properties": {
      -                                      "errors": {
      -                                        "description": "A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated.",
      -                                        "items": {
      -                                          "properties": {
      -                                            "code": {
      -                                              "anyOf": [
      -                                                {
      -                                                  "type": "string"
      -                                                },
      -                                                {
      -                                                  "type": "null"
      -                                                }
      -                                              ],
      -                                              "description": "A machine-readable error code."
      -                                            },
      -                                            "locations": {
      -                                              "description": "Source locations related to the error.",
      -                                              "items": {
      -                                                "anyOf": [
      -                                                  {
      -                                                    "properties": {
      -                                                      "column": {
      -                                                        "description": "Column number.",
      -                                                        "type": "integer"
      -                                                      },
      -                                                      "line": {
      -                                                        "description": "Line number.",
      -                                                        "type": "integer"
      -                                                      }
      -                                                    },
      -                                                    "required": [
      -                                                      "line",
      -                                                      "column"
      -                                                    ],
      -                                                    "type": "object"
      -                                                  },
      -                                                  {
      -                                                    "type": "null"
      -                                                  }
      -                                                ]
      -                                              },
      -                                              "type": "array"
      -                                            },
      -                                            "message": {
      -                                              "description": "A human-readable message describing the error.",
      -                                              "type": "string"
      -                                            }
      -                                          },
      -                                          "required": [
      -                                            "message",
      -                                            "locations"
      -                                          ],
      -                                          "type": "object"
      -                                        },
      -                                        "type": "array"
      -                                      }
      -                                    },
      -                                    "required": [
      -                                      "errors"
      -                                    ],
      -                                    "type": "object"
      -                                  },
      -                                  {
      -                                    "type": "null"
      -                                  }
      -                                ],
      -                                "description": "The result of federated composition executed for this publication. This result includes either a supergraph schema or error details, depending on whether composition succeeded. This value is null when the publication is for a non-federated graph."
      -                              },
      -                              "diffToPrevious": {
      -                                "anyOf": [
      -                                  {
      -                                    "properties": {
      -                                      "changeSummary": {
      -                                        "description": "Numeric summaries for each type of change in the diff.",
      -                                        "properties": {
      -                                          "total": {
      -                                            "description": "Counts for all changes.",
      -                                            "properties": {
      -                                              "additions": {
      -                                                "description": "Number of changes that are additions. This includes adding types, adding fields to object, input\nobject, and interface types, adding values to enums, adding members to interfaces and unions, and\nadding arguments.",
      -                                                "type": "integer"
      -                                              },
      -                                              "deprecations": {
      -                                                "description": "Number of changes that are new usages of the @deprecated directive.",
      -                                                "type": "integer"
      -                                              },
      -                                              "edits": {
      -                                                "description": "Number of changes that are edits. This includes types changing kind, fields and arguments\nchanging type, arguments changing default value, and any description changes. This also includes\nedits to @deprecated reason strings.",
      -                                                "type": "integer"
      -                                              },
      -                                              "removals": {
      -                                                "description": "Number of changes that are removals. This includes removing types, removing fields from object,\ninput object, and interface types, removing values from enums, removing members from interfaces\nand unions, and removing arguments. This also includes removing @deprecated usages.",
      -                                                "type": "integer"
      -                                              }
      -                                            },
      -                                            "required": [
      -                                              "additions",
      -                                              "removals",
      -                                              "edits",
      -                                              "deprecations"
      -                                            ],
      -                                            "type": "object"
      -                                          }
      -                                        },
      -                                        "required": [
      -                                          "total"
      -                                        ],
      -                                        "type": "object"
      -                                      }
      -                                    },
      -                                    "required": [
      -                                      "changeSummary"
      -                                    ],
      -                                    "type": "object"
      -                                  },
      -                                  {
      -                                    "type": "null"
      -                                  }
      -                                ],
      -                                "description": "A schema diff comparing against the schema from the most recent previous successful publication."
      -                              }
      -                            },
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "A specific publication of a graph variant pertaining to this launch."
      -                      },
      -                      "status": {
      -                        "$ref": "#/definitions/LaunchStatus",
      -                        "description": "The launch's status. If a launch is superseded, its status remains `LAUNCH_INITIATED`. To check for a superseded launch, use `supersededAt`."
      -                      },
      -                      "subgraphChanges": {
      -                        "anyOf": [
      -                          {
      -                            "items": {
      -                              "properties": {
      -                                "name": {
      -                                  "description": "The subgraph's name.",
      -                                  "oneOf": [
      -                                    {
      -                                      "type": "string"
      -                                    },
      -                                    {
      -                                      "type": "integer"
      -                                    }
      -                                  ]
      -                                }
      -                              },
      -                              "required": [
      -                                "name"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            "type": "array"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "A list of subgraph changes that are included in this launch."
      -                      }
      -                    },
      -                    "required": [
      -                      "id",
      -                      "status",
      -                      "createdAt"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Retrieve a launch for this variant by ID."
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Provides details of the graph variant with the provided `name`, if a variant\nwith that name exists for this graph. Otherwise, returns null.\n\n For a list of _all_ variants associated with a graph, use `Graph.variants` instead."
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "variant": {
      +        "anyOf": [
      +          {
      +            "properties": {
      +              "launch": {
      +                "anyOf": [
      +                  {
      +                    "properties": {
      +                      "build": {
      +                        "anyOf": [
      +                          {
      +                            "properties": {
      +                              "result": {
      +                                "anyOf": [
      +                                  {
      +                                    "properties": {
      +                                      "errorMessages": {
      +                                        "description": "A list of all errors that occurred during the failed build.",
      +                                        "items": {
      +                                          "properties": {
      +                                            "code": {
      +                                              "anyOf": [
      +                                                {
      +                                                  "type": "string"
      +                                                },
      +                                                {
      +                                                  "type": "null"
      +                                                }
      +                                              ]
      +                                            },
      +                                            "failedStep": {
      +                                              "anyOf": [
      +                                                {
      +                                                  "type": "string"
      +                                                },
      +                                                {
      +                                                  "type": "null"
      +                                                }
      +                                              ]
      +                                            },
      +                                            "locations": {
      +                                              "items": {
      +                                                "properties": {
      +                                                  "column": {
      +                                                    "description": "Column number.",
      +                                                    "type": "integer"
      +                                                  },
      +                                                  "line": {
      +                                                    "description": "Line number.",
      +                                                    "type": "integer"
      +                                                  }
      +                                                },
      +                                                "required": [
      +                                                  "line",
      +                                                  "column"
      +                                                ],
      +                                                "type": "object"
      +                                              },
      +                                              "type": "array"
      +                                            },
      +                                            "message": {
      +                                              "type": "string"
      +                                            }
      +                                          },
      +                                          "required": [
      +                                            "message",
      +                                            "locations"
      +                                          ],
      +                                          "type": "object"
      +                                        },
      +                                        "type": "array"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "errorMessages"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  {
      +                                    "type": "null"
      +                                  }
      +                                ],
      +                                "description": "The result of the build. This value is null until the build completes."
      +                              }
      +                            },
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "The associated build for this launch (a build includes schema composition and contract filtering). This value is null until the build is initiated."
      +                      },
      +                      "completedAt": {
      +                        "anyOf": [
      +                          {
      +                            "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "The timestamp when the launch completed. This value is null until the launch completes."
      +                      },
      +                      "createdAt": {
      +                        "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      +                      },
      +                      "id": {
      +                        "description": "The unique identifier for this launch.",
      +                        "oneOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "integer"
      +                          }
      +                        ]
      +                      },
      +                      "publication": {
      +                        "anyOf": [
      +                          {
      +                            "properties": {
      +                              "diffToPrevious": {
      +                                "anyOf": [
      +                                  {
      +                                    "properties": {
      +                                      "changeSummary": {
      +                                        "description": "Numeric summaries for each type of change in the diff.",
      +                                        "properties": {
      +                                          "total": {
      +                                            "description": "Counts for all changes.",
      +                                            "properties": {
      +                                              "additions": {
      +                                                "description": "Number of changes that are additions. This includes adding types, adding fields to object, input\nobject, and interface types, adding values to enums, adding members to interfaces and unions, and\nadding arguments.",
      +                                                "type": "integer"
      +                                              },
      +                                              "deprecations": {
      +                                                "description": "Number of changes that are new usages of the @deprecated directive.",
      +                                                "type": "integer"
      +                                              },
      +                                              "edits": {
      +                                                "description": "Number of changes that are edits. This includes types changing kind, fields and arguments\nchanging type, arguments changing default value, and any description changes. This also includes\nedits to @deprecated reason strings.",
      +                                                "type": "integer"
      +                                              },
      +                                              "removals": {
      +                                                "description": "Number of changes that are removals. This includes removing types, removing fields from object,\ninput object, and interface types, removing values from enums, removing members from interfaces\nand unions, and removing arguments. This also includes removing @deprecated usages.",
      +                                                "type": "integer"
      +                                              }
      +                                            },
      +                                            "required": [
      +                                              "additions",
      +                                              "removals",
      +                                              "edits",
      +                                              "deprecations"
      +                                            ],
      +                                            "type": "object"
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "total"
      +                                        ],
      +                                        "type": "object"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "changeSummary"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  {
      +                                    "type": "null"
      +                                  }
      +                                ],
      +                                "description": "A schema diff comparing against the schema from the most recent previous successful publication."
      +                              }
      +                            },
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "A specific publication of a graph variant pertaining to this launch."
      +                      },
      +                      "status": {
      +                        "$ref": "#/definitions/LaunchStatus",
      +                        "description": "The launch's status. If a launch is superseded, its status remains `LAUNCH_INITIATED`. To check for a superseded launch, use `supersededAt`."
      +                      },
      +                      "subgraphChanges": {
      +                        "anyOf": [
      +                          {
      +                            "items": {
      +                              "properties": {
      +                                "name": {
      +                                  "description": "The subgraph's name.",
      +                                  "oneOf": [
      +                                    {
      +                                      "type": "string"
      +                                    },
      +                                    {
      +                                      "type": "integer"
      +                                    }
      +                                  ]
      +                                }
      +                              },
      +                              "required": [
      +                                "name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            "type": "array"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "A list of subgraph changes that are included in this launch."
      +                      }
      +                    },
      +                    "required": [
      +                      "id",
      +                      "status",
      +                      "createdAt"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Retrieve a launch for this variant by ID."
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Provides details of the graph variant with the provided `name`, if a variant\nwith that name exists for this graph. Otherwise, returns null.\n\n For a list of _all_ variants associated with a graph, use `Graph.variants` instead."
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed2 schema fields changed
    • addedOutput schema / properties / data / properties / graph / anyOf
      Added value: +[
      +  {
      +    "properties": {
      +      "variant": {
      +        "anyOf": [
      +          {
      +            "properties": {
      +              "launch": {
      +                "anyOf": [
      +                  {
      +                    "properties": {
      +                      "completedAt": {
      +                        "anyOf": [
      +                          {
      +                            "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "The timestamp when the launch completed. This value is null until the launch completes."
      +                      },
      +                      "createdAt": {
      +                        "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      +                      },
      +                      "id": {
      +                        "description": "The unique identifier for this launch.",
      +                        "oneOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "integer"
      +                          }
      +                        ]
      +                      },
      +                      "publication": {
      +                        "anyOf": [
      +                          {
      +                            "properties": {
      +                              "compositionResult": {
      +                                "anyOf": [
      +                                  {
      +                                    "properties": {
      +                                      "errors": {
      +                                        "description": "A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated.",
      +                                        "items": {
      +                                          "properties": {
      +                                            "code": {
      +                                              "anyOf": [
      +                                                {
      +                                                  "type": "string"
      +                                                },
      +                                                {
      +                                                  "type": "null"
      +                                                }
      +                                              ],
      +                                              "description": "A machine-readable error code."
      +                                            },
      +                                            "locations": {
      +                                              "description": "Source locations related to the error.",
      +                                              "items": {
      +                                                "anyOf": [
      +                                                  {
      +                                                    "properties": {
      +                                                      "column": {
      +                                                        "description": "Column number.",
      +                                                        "type": "integer"
      +                                                      },
      +                                                      "line": {
      +                                                        "description": "Line number.",
      +                                                        "type": "integer"
      +                                                      }
      +                                                    },
      +                                                    "required": [
      +                                                      "line",
      +                                                      "column"
      +                                                    ],
      +                                                    "type": "object"
      +                                                  },
      +                                                  {
      +                                                    "type": "null"
      +                                                  }
      +                                                ]
      +                                              },
      +                                              "type": "array"
      +                                            },
      +                                            "message": {
      +                                              "description": "A human-readable message describing the error.",
      +                                              "type": "string"
      +                                            }
      +                                          },
      +                                          "required": [
      +                                            "message",
      +                                            "locations"
      +                                          ],
      +                                          "type": "object"
      +                                        },
      +                                        "type": "array"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "errors"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  {
      +                                    "type": "null"
      +                                  }
      +                                ],
      +                                "description": "The result of federated composition executed for this publication. This result includes either a supergraph schema or error details, depending on whether composition succeeded. This value is null when the publication is for a non-federated graph."
      +                              },
      +                              "diffToPrevious": {
      +                                "anyOf": [
      +                                  {
      +                                    "properties": {
      +                                      "changeSummary": {
      +                                        "description": "Numeric summaries for each type of change in the diff.",
      +                                        "properties": {
      +                                          "total": {
      +                                            "description": "Counts for all changes.",
      +                                            "properties": {
      +                                              "additions": {
      +                                                "description": "Number of changes that are additions. This includes adding types, adding fields to object, input\nobject, and interface types, adding values to enums, adding members to interfaces and unions, and\nadding arguments.",
      +                                                "type": "integer"
      +                                              },
      +                                              "deprecations": {
      +                                                "description": "Number of changes that are new usages of the @deprecated directive.",
      +                                                "type": "integer"
      +                                              },
      +                                              "edits": {
      +                                                "description": "Number of changes that are edits. This includes types changing kind, fields and arguments\nchanging type, arguments changing default value, and any description changes. This also includes\nedits to @deprecated reason strings.",
      +                                                "type": "integer"
      +                                              },
      +                                              "removals": {
      +                                                "description": "Number of changes that are removals. This includes removing types, removing fields from object,\ninput object, and interface types, removing values from enums, removing members from interfaces\nand unions, and removing arguments. This also includes removing @deprecated usages.",
      +                                                "type": "integer"
      +                                              }
      +                                            },
      +                                            "required": [
      +                                              "additions",
      +                                              "removals",
      +                                              "edits",
      +                                              "deprecations"
      +                                            ],
      +                                            "type": "object"
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "total"
      +                                        ],
      +                                        "type": "object"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "changeSummary"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  {
      +                                    "type": "null"
      +                                  }
      +                                ],
      +                                "description": "A schema diff comparing against the schema from the most recent previous successful publication."
      +                              }
      +                            },
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "A specific publication of a graph variant pertaining to this launch."
      +                      },
      +                      "status": {
      +                        "$ref": "#/definitions/LaunchStatus",
      +                        "description": "The launch's status. If a launch is superseded, its status remains `LAUNCH_INITIATED`. To check for a superseded launch, use `supersededAt`."
      +                      },
      +                      "subgraphChanges": {
      +                        "anyOf": [
      +                          {
      +                            "items": {
      +                              "properties": {
      +                                "name": {
      +                                  "description": "The subgraph's name.",
      +                                  "oneOf": [
      +                                    {
      +                                      "type": "string"
      +                                    },
      +                                    {
      +                                      "type": "integer"
      +                                    }
      +                                  ]
      +                                }
      +                              },
      +                              "required": [
      +                                "name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            "type": "array"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "A list of subgraph changes that are included in this launch."
      +                      }
      +                    },
      +                    "required": [
      +                      "id",
      +                      "status",
      +                      "createdAt"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Retrieve a launch for this variant by ID."
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Provides details of the graph variant with the provided `name`, if a variant\nwith that name exists for this graph. Otherwise, returns null.\n\n For a list of _all_ variants associated with a graph, use `Graph.variants` instead."
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / data / properties / graph / oneOf
      Removed value: -[
      -  {
      -    "properties": {
      -      "variant": {
      -        "description": "Provides details of the graph variant with the provided `name`, if a variant\nwith that name exists for this graph. Otherwise, returns null.\n\n For a list of _all_ variants associated with a graph, use `Graph.variants` instead.",
      -        "oneOf": [
      -          {
      -            "properties": {
      -              "launch": {
      -                "description": "Retrieve a launch for this variant by ID.",
      -                "oneOf": [
      -                  {
      -                    "properties": {
      -                      "completedAt": {
      -                        "description": "The timestamp when the launch completed. This value is null until the launch completes.",
      -                        "oneOf": [
      -                          {
      -                            "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "createdAt": {
      -                        "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
      -                      },
      -                      "id": {
      -                        "description": "The unique identifier for this launch.",
      -                        "oneOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "integer"
      -                          }
      -                        ]
      -                      },
      -                      "publication": {
      -                        "description": "A specific publication of a graph variant pertaining to this launch.",
      -                        "oneOf": [
      -                          {
      -                            "properties": {
      -                              "compositionResult": {
      -                                "description": "The result of federated composition executed for this publication. This result includes either a supergraph schema or error details, depending on whether composition succeeded. This value is null when the publication is for a non-federated graph.",
      -                                "oneOf": [
      -                                  {
      -                                    "properties": {
      -                                      "errors": {
      -                                        "description": "A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated.",
      -                                        "items": {
      -                                          "properties": {
      -                                            "code": {
      -                                              "description": "A machine-readable error code.",
      -                                              "oneOf": [
      -                                                {
      -                                                  "type": "string"
      -                                                },
      -                                                {
      -                                                  "type": "null"
      -                                                }
      -                                              ]
      -                                            },
      -                                            "locations": {
      -                                              "description": "Source locations related to the error.",
      -                                              "items": {
      -                                                "oneOf": [
      -                                                  {
      -                                                    "properties": {
      -                                                      "column": {
      -                                                        "description": "Column number.",
      -                                                        "type": "integer"
      -                                                      },
      -                                                      "line": {
      -                                                        "description": "Line number.",
      -                                                        "type": "integer"
      -                                                      }
      -                                                    },
      -                                                    "required": [
      -                                                      "line",
      -                                                      "column"
      -                                                    ],
      -                                                    "type": "object"
      -                                                  },
      -                                                  {
      -                                                    "type": "null"
      -                                                  }
      -                                                ]
      -                                              },
      -                                              "type": "array"
      -                                            },
      -                                            "message": {
      -                                              "description": "A human-readable message describing the error.",
      -                                              "type": "string"
      -                                            }
      -                                          },
      -                                          "required": [
      -                                            "message",
      -                                            "locations"
      -                                          ],
      -                                          "type": "object"
      -                                        },
      -                                        "type": "array"
      -                                      }
      -                                    },
      -                                    "required": [
      -                                      "errors"
      -                                    ],
      -                                    "type": "object"
      -                                  },
      -                                  {
      -                                    "type": "null"
      -                                  }
      -                                ]
      -                              },
      -                              "diffToPrevious": {
      -                                "description": "A schema diff comparing against the schema from the most recent previous successful publication.",
      -                                "oneOf": [
      -                                  {
      -                                    "properties": {
      -                                      "changeSummary": {
      -                                        "description": "Numeric summaries for each type of change in the diff.",
      -                                        "properties": {
      -                                          "total": {
      -                                            "description": "Counts for all changes.",
      -                                            "properties": {
      -                                              "additions": {
      -                                                "description": "Number of changes that are additions. This includes adding types, adding fields to object, input\nobject, and interface types, adding values to enums, adding members to interfaces and unions, and\nadding arguments.",
      -                                                "type": "integer"
      -                                              },
      -                                              "deprecations": {
      -                                                "description": "Number of changes that are new usages of the @deprecated directive.",
      -                                                "type": "integer"
      -                                              },
      -                                              "edits": {
      -                                                "description": "Number of changes that are edits. This includes types changing kind, fields and arguments\nchanging type, arguments changing default value, and any description changes. This also includes\nedits to @deprecated reason strings.",
      -                                                "type": "integer"
      -                                              },
      -                                              "removals": {
      -                                                "description": "Number of changes that are removals. This includes removing types, removing fields from object,\ninput object, and interface types, removing values from enums, removing members from interfaces\nand unions, and removing arguments. This also includes removing @deprecated usages.",
      -                                                "type": "integer"
      -                                              }
      -                                            },
      -                                            "required": [
      -                                              "additions",
      -                                              "removals",
      -                                              "edits",
      -                                              "deprecations"
      -                                            ],
      -                                            "type": "object"
      -                                          }
      -                                        },
      -                                        "required": [
      -                                          "total"
      -                                        ],
      -                                        "type": "object"
      -                                      }
      -                                    },
      -                                    "required": [
      -                                      "changeSummary"
      -                                    ],
      -                                    "type": "object"
      -                                  },
      -                                  {
      -                                    "type": "null"
      -                                  }
      -                                ]
      -                              }
      -                            },
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "status": {
      -                        "$ref": "#/definitions/LaunchStatus",
      -                        "description": "The launch's status. If a launch is superseded, its status remains `LAUNCH_INITIATED`. To check for a superseded launch, use `supersededAt`."
      -                      },
      -                      "subgraphChanges": {
      -                        "description": "A list of subgraph changes that are included in this launch.",
      -                        "oneOf": [
      -                          {
      -                            "items": {
      -                              "properties": {
      -                                "name": {
      -                                  "description": "The subgraph's name.",
      -                                  "oneOf": [
      -                                    {
      -                                      "type": "string"
      -                                    },
      -                                    {
      -                                      "type": "integer"
      -                                    }
      -                                  ]
      -                                }
      -                              },
      -                              "required": [
      -                                "name"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            "type": "array"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "id",
      -                      "status",
      -                      "createdAt"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
  3. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already declare readOnlyHint=true, idempotentHint=true, openWorldHint=true, and destructiveHint=false, so safety characteristics are covered. The description adds useful behavioral context by listing what the inspection returns, including status, timestamps, changed subgraphs, composition errors, and schema diff summary.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three sentences and front-loads the core purpose and returned information. The usage sentence and parameter reminder are compact and directly useful because the schema itself has no parameter descriptions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the description need not explain return formatting, and the annotations cover safety and idempotency. The description still provides the key returned categories and tells the agent where to obtain the launchId, though the 0% parameter description coverage leaves a minor gap around identifier semantics.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must carry the parameter semantics. It only restates the required parameter names ('graph ID, variant name, and launch ID') without explaining formats, how variant names are structured, or what each identifier refers to in the GraphQL launch context.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Inspect') and resource ('a single launch by ID') and enumerates the returned details: status, timestamps, changed subgraphs, composition errors, and schema diff summary. It distinguishes this from retrieval of multiple launches or the latest launch by emphasizing a single launch passed by ID, and it explicitly references GetLaunchHistory as the discovery path.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a clear when-to-use case: drilling into a specific launch, such as a failed or superseded one found via GetLaunchHistory. It also tells the agent to pass that launch's id here, making the alternative and the routing condition explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources