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

TableJSON Schema
NameRequiredDescriptionDefault
graphIdYes
variantYes
launchIdYes

Output Schema

TableJSON 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.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint, and destructiveHint=false, so the safety profile is covered. The description adds useful detail about what the call surfaces (composition errors, schema diff summary, changed subgraphs), which goes beyond the annotations, though it does not cover auth needs or rate limits.

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?

Two sentences, front-loaded with the primary action and return fields, followed by the usage trigger and required inputs. No wasted text.

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

Completeness5/5

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

An output schema exists and annotations cover the safety profile, so the description needn't explain return structure. Combined with full usage routing and all three params named, an agent has everything needed to invoke it correctly.

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

Parameters4/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 param burden, and it names all three (graph ID, variant name, launch ID) plus the provenance of the launch ID from GetLaunchHistory. It does not give format/syntax details, so it is strong but not exhaustive.

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?

States a specific verb and resource ('Inspect a single launch by ID for full detail') and enumerates the fields returned (status, timestamps, changed subgraphs, composition errors, schema diff summary). This clearly separates it from GetLatestLaunch and GetLaunchHistory.

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?

Explicitly tells the agent when to use it ('drill into a specific launch — e.g. a failed or superseded one found via GetLaunchHistory') and names the sibling that produces the required id. Includes the workflow of passing that id here.

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